# Agent Handoff

## Ler primeiro
Antes de produzir qualquer código ou proposta, ler obrigatoriamente:
1. `00_PROJECT_BRIEF.md`
2. `03_PROBLEM_STATEMENT.md`
3. `04_PRODUCT_GOALS.md`
4. `05_USER_WORKFLOWS.md`
5. `08_DOMAIN_MODEL.md`
6. `09_STATES_AND_LIFECYCLES.md`
7. `10_MVP_DEFINITION.md`
8. `16_DECISIONS_LOG.md`
9. `17_PROGRESS.md`
10. `19_TECH_STACK.md`
11. `20_PROJECT_STRUCTURE.md`
12. `21_ENGINEERING_GUIDELINES.md`
13. `DOC_INDEX.md` (índice completo da documentação)

## Fonte de verdade
As decisões do projeto estão documentadas em:
- `16_DECISIONS_LOG.md`
- `10_MVP_DEFINITION.md`
- `09_STATES_AND_LIFECYCLES.md`
- `19_TECH_STACK.md`
- `20_PROJECT_STRUCTURE.md`
- `prisma/schema.prisma` (schema inicial criado)

## Regras para o agente
- Não inventar funcionalidades fora do MVP sem sinalização explícita
- Não alterar estados do sistema sem registo em `16_DECISIONS_LOG.md`
- Não introduzir complexidade desnecessária
- Priorizar rapidez operacional e simplicidade de uso
- Respeitar a stack escolhida
- Não propor backend separado, microserviços ou GraphQL para a V1
- Manter separação entre UI, validação, serviços e acesso a dados

## Objetivo da última iteração
Validar tecnicamente o schema.prisma contra a documentação e preparar a base real do projeto para desenvolvimento.

## O que foi feito
- Validado schema Prisma contra documentação completa (domínio, estados, MVP, regras de dados)
- Corrigidos problemas de integridade relacional no schema (relação User.createdReceipts, índices StatusHistory)
- Criada estrutura completa do projeto Next.js com stack aprovada
- Configurado package.json com todas as dependências necessárias
- Criados ficheiros de configuração (next.config.js, tsconfig.json, tailwind.config.ts)
- Configurado ambiente (.env.example)
- Criada estrutura de pastas conforme `20_PROJECT_STRUCTURE.md`
- Implementados ficheiros base da aplicação (layout, page, globals.css)
- Configurado cliente Prisma inicial

## Ficheiros alterados nesta iteração
- `/prisma/schema.prisma` (validado e corrigido)
- `/package.json` (criado)
- `/next.config.js` (criado)
- `/tsconfig.json` (criado)
- `/tailwind.config.ts` (criado)
- `/.env.example` (criado)
- `/src/app/layout.tsx` (criado)
- `/src/app/page.tsx` (criado)
- `/src/app/globals.css` (criado)
- `/src/server/db/client.ts` (criado)
- Estrutura completa de pastas em `/src/` (criada)
- `/docs/16_DECISIONS_LOG.md` (atualizado)
- `/docs/17_PROGRESS.md` (atualizado)

## Decisões tomadas
- Schema Prisma validado e corrigido para garantir integridade relacional
- Estrutura técnica criada seguindo exatamente a stack e convenções definidas
- Mantida abordagem de rastreabilidade por unidade conforme documentação
- Configurado projeto para desenvolvimento com Next.js 16, TypeScript, Tailwind CSS

## Limitações e dúvidas
- Dependências precisam de ser instaladas para resolver erros TypeScript
- Ambiente Supabase precisa de configuração
- Fluxo de imagens e storage ainda não definido
- Modelação futura de integração com plataformas pendente

## Próxima missão sugerida
Finalizar setup técnico e iniciar desenvolvimento:
1. Instalar dependências do projeto (npm install)
2. Configurar ambiente Supabase
3. Implementar primeira migration Prisma
4. Testar configuração base da aplicação
5. Iniciar desenvolvimento da primeira feature (suppliers)

## Riscos e cuidados especiais
- Instalar dependências antes de prosseguir com desenvolvimento
- Configurar Supabase corretamente para evitar problemas de conexão
- Manter foco no MVP definido, evitar funcionalidades fora do âmbito
- Seguir rigorosamente a estrutura de pastas e convenções estabelecidas
- Testar migrations Prisma antes de implementar funcionalidades