first commit

docs/18_AGENT_HANDOFF.md

@@ -0,0 +1,91 @@
+# 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