Decisões
ORG-0011 — Plataforma Linux e pré-requisitos
- Status: aceita
- Data: 2026-10-18
- Decide: desenvolvimento em Linux, scripts em bash e pré-requisitos com versão no README
Contexto
Scripts que precisam rodar em sistemas diferentes acumulam desvios. E quem chega a uma stack precisa saber o que instalar, em que versão, antes do primeiro comando.
Decisão
- A plataforma de desenvolvimento é Linux; os scripts são
bash. - Todo script confere os próprios pré-requisitos e falha cedo, com uma linha
ERRO:clara. - Credenciais só por variável de ambiente ou prompt, nunca em argumento nem em arquivo versionado.
- A lista de pré-requisitos, com versões, mora no README da stack (no modelo, em lacuna).
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Suporte a vários sistemas operacionais | Por que não: cada script vira três; o ganho não paga o custo |
| Pré-requisitos implícitos | Por que não: "funciona na minha máquina" |
Consequências
- Um ambiente novo se monta pela lista do README.
- Erros de ambiente aparecem no começo, com mensagem, e não no meio de um build.
Mais
O detalhe está na documentação da arquitetura.