Decisões
ORG-0013 — Stack tecnológica escolhida uma vez, por critérios
- Status: aceita
- Data: 2026-10-18
- Decide: a stack escolhe linguagem, runtime, framework e UI uma vez, antes do código, pelos critérios comuns
Contexto
Uma tecnologia escolhida na conversa, durante a construção, é registrada depois, quando é registrada, e muda no meio do caminho. Ao mesmo tempo, a arquitetura não deve impor uma linguagem: cada produto tem necessidades diferentes.
Decisão
- A stack escolhe linguagem, runtime, framework, abordagem de UI e ferramenta de build uma vez, na Fase 1, antes de qualquer código.
- A escolha passa pelos critérios comuns: cliente OIDC maduro; contrato de observabilidade sem agent externo; testes de integração com dependências reais em container; imagem enxuta e não-root; capacidade de servir o design system; conhecimento de quem mantém; suporte (LTS) pelo horizonte do produto.
- A escolha, as versões e as alternativas consideradas ficam numa ADR da stack (a ADR-0001
pré-escrita) e na ficha
docs/stack.md. - Trocar a tecnologia depois é uma change com ADR que substitui a anterior.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Uma tecnologia padrão para toda stack | Por que não: nem todo produto cabe nela; a arquitetura viraria um framework |
| Escolha livre a qualquer momento | Por que não: a stack muda de rumo no meio, com custo alto |
Consequências
- O portão da Fase 1 só abre com a ficha preenchida e aceita.
- Os critérios garantem que qualquer escolha cumpre os contratos da plataforma.
Mais
O detalhe está na documentação da arquitetura.