Decisões de Arquitetura (ADRs)

Architecture Decision Records — documenta por que escolhemos cada coisa.

Formato

Cada ADR segue:

1. Contexto — qual problema motivou a decisão
2. Decisão — o que foi escolhido
3. Alternativas consideradas — o que foi descartado e por quê
4. Consequências — trade-offs aceitos
5. Status — Proposed | Accepted | Superseded

ADRs

#	Título	Status
001	CPCV em vez de Walk-Forward simples	✅ Accepted
002	Conformal Prediction como gate final	✅ Accepted
003	Ensemble LGBM 0.5 / XGB 0.3 / CAT 0.2	✅ Accepted
004	Multi-tenant via UUID em DB	✅ Accepted
005	Eduzz em vez de Stripe (Brasil)	✅ Accepted

Quando criar um novo ADR

Sempre que tomar decisão que:

• É difícil de reverter depois (schema, protocol, biblioteca core)
• Tem alternativas razoáveis (não é "óbvio")
• Tem trade-offs explícitos (perdemos X para ganhar Y)
• Afeta múltiplas camadas (ex: trocar broker afeta EA + API + DB)

Não precisa para:

• Bug fixes
• Refactor interno
• Adição de feature sem impacto arquitetural