Desenvolvendo com as specs¶
Depois que o Reversa gerou todas as specs em _reversa_sdd/, você pode copiar esses arquivos para qualquer máquina e começar a construir o sistema do zero. Veja a ordem recomendada.
Antes de escrever uma linha de código¶
Comece lendo esses três arquivos:
| Arquivo | Por que ler primeiro |
|---|---|
_reversa_sdd/confidence-report.md |
Mostra o que tem alta confiança (verde) vs. lacunas (vermelho). Evita implementar algo baseado em inferência errada. |
_reversa_sdd/gaps.md |
Lista o que o Reversa não conseguiu determinar. Preencha manualmente antes de começar. |
_reversa_sdd/architecture.md + diagramas C4 |
Mostra a visão macro: camadas, módulos, fronteiras do sistema. |
Ordem de implementação (bottom-up)¶
1. database/ + erd-complete.md (estrutura de dados, migrations)
2. domain.md + sdd/[entidades-core] (regras de negócio centrais)
3. sdd/[serviços] ordenados por dependência (use dependencies.md como guia)
4. openapi/ + contratos de API (se houver)
5. ui/ (camada de apresentação por último)
Qual sdd/ vem primeiro¶
Abra _reversa_sdd/traceability/code-spec-matrix.md. Ele lista cada spec e suas dependências.
Implemente primeiro as specs que não dependem de nenhuma outra (folhas da árvore de dependências), e suba em direção às specs que integram múltiplos componentes.
Mantendo a rastreabilidade durante o desenvolvimento¶
Use a _reversa_sdd/traceability/code-spec-matrix.md como referência durante o desenvolvimento para saber qual trecho de código implementado corresponde a qual spec. Isso mantém a rastreabilidade precisa conforme o código cresce.
Veja também¶
- Saídas geradas: lista completa dos arquivos produzidos pelo Reversa
- Escala de confiança: como interpretar os marcadores 🟢🟡🔴 nas specs