millions/docs/18_AGENT_HANDOFF.md

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