Tecnologia base do MVP
Problema / Contexto
O Kit de Requisitos define a stack técnica da primeira construção e orienta não propor tecnologias alternativas sem decisão humana explícita.
História de usuário
Como administrador, quero usar a stack técnica definida no projeto, para desenvolver o MVP sobre uma base única e previsível.
Comportamento esperado
- Construir a aplicação web em Next.js com TypeScript.
- Persistir dados relacionais em Neon/PostgreSQL.
- Usar Neon Auth para autenticação.
- Armazenar arquivos no Cloudflare R2.
- Usar a API da Anthropic nas funcionalidades de IA.
Papel da IA
Não se aplica.
Regras de negócio
- RN1: Mudança de stack exige decisão humana formal.
- RN2: Agentes de desenvolvimento não podem substituir tecnologia por conveniência.
Dados envolvidos
- stack_frontend — Next.js + TypeScript — sim — decisão humana
- banco — Neon/PostgreSQL — sim — decisão humana
- autenticacao — Neon Auth — sim — decisão humana
- arquivos — Cloudflare R2 — sim — decisão humana
- provedor_ia — API da Anthropic — sim — decisão humana
Critérios de aceite
- Dado o ambiente do MVP, quando uma capacidade técnica for implementada, então deve usar a tecnologia definida para aquela camada.
- Dado um agente de desenvolvimento, quando encontrar alternativa tecnológica, então não deve adotá-la sem decisão humana.
Exceções e erros
- Indisponibilidade de serviço externo deve gerar falha controlada e preservar dados já inseridos.
Fora de escopo
- Troca de stack sem deliberação.
- Microsserviços não necessários ao MVP.
Dúvidas em aberto
- Confirmar formalmente no Decision Log que a stack do Kit substitui baselines técnicas anteriores conflitantes. → Respondido em DEC-005 Formalização da Stack.
Histórico
| Data | O que mudou | Quem | Referência |
|---|---|---|---|
| 2026-09-15 | Criado no pacote de requisitos do MVP | LC Verum | Índice do MVP - Requisitos |
| 2026-09-16 | Numerado e importado para a documentação | Luiz | Registro de Mudanças |
| 2026-09-16 | Fundação implementada (commit 41e38c4) | Agente de código | — |
| 2026-09-16 | Dúvida da stack respondida | Luiz | DEC-005 Formalização da Stack |