92 lines
3.7 KiB
Markdown
92 lines
3.7 KiB
Markdown
# 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
|