# ERP Doméstico — Contexto para Claude

## O que é este projeto

ERP Doméstico — sistema de gestão financeira e logística para uso pessoal/familiar.
Gestão de finanças, compras, inventário, viaturas e empréstimos, com bot Telegram.

## Stack

- **Backend:** Laravel 12 (PHP 8.2)
- **Frontend:** Livewire 3 + Alpine.js
- **Auth:** Laravel Breeze (Livewire stack)
- **Base de dados:** MariaDB (database: `erp_casa`)
- **Cache/Queues:** Redis
- **Storage:** Cloudflare R2 (anexos) + local
- **Web server:** Nginx
- **Queue worker:** Supervisor
- **Scheduler:** Cron
- **Hosting:** CT Proxmox (Debian 12)

## Regras

- Todo o texto da UI deve ser em **Português (Portugal)**
- Moeda: **EUR**
- Nunca renomear tabelas, models ou arquitetura já definida
- Não truncar ficheiros — output completo sempre
- Implementar uma parte de cada vez (ver PLANO.md)
- Transferências financeiras devem ser atómicas (DB transactions)
- Categorias são hierárquicas (parent_id self-reference)

## Estado do Projeto

O projeto está a ser implementado por fases. Consultar `PLANO.md` para:
- Configuração completa do CT Proxmox (13 passos)
- Tarefas pendentes e concluídas
- Detalhe de cada parte da implementação

## Estrutura da Base de Dados (planeada)

```
accounts ← movements → categories (hierárquicas)
                ↓
          attachments    cost_centers
          audit_logs     tags (pivot: movement_tag)
          transfers (liga 2 movements)

shopping_trips → shopping_items → products
vehicles → fuel_logs / maintenances
loans → loan_payments
```

## Ficheiros Importantes

- `projeto.md` — Especificação original completa do projeto
- `PLANO.md` — Plano de implementação com setup do CT e passos detalhados
- `CLAUDE.md` — Este ficheiro (contexto para o Claude)

## Como Trabalhar Neste Projeto

1. Ler `PLANO.md` para saber em que fase estamos
2. Ler `projeto.md` para detalhes da especificação de cada parte
3. Implementar uma parte de cada vez
4. Testar cada parte antes de avançar
5. Marcar tarefas como concluídas no PLANO.md