Recursos · 84
Decisões de arquitetura: conservar razões e saber rever
Documentar escolhas importantes sem transformar cada reunião num dossier excessivo.
Atualizado · 3 min
O que este guia ajuda a alcançar
- Delimitar a decisão
- Comparar opções plausíveis
- Registar escolha e consequências
- Preservar o histórico
- Definir motivos de revisão
Verificação rápida
- Cada tarefa precisa de ADR?
- Uma decisão aceite pode mudar?
- O registo garante uma boa escolha?
Método passo a passo
- 1
Delimitar a decisão
Escolher uma questão com efeitos duradouros: alojamento, integração, armazenamento ou limites de componentes. Um ADR conserva as razões de uma escolha arquitetural relevante. Descrever problema e restrições reais, sem fabricar uma justificação posterior.
Resultado: questão e âmbito.
- 2
Comparar opções plausíveis
Incluir soluções realmente consideradas, também manter o sistema atual se viável. Usar critérios comuns para utilização, segurança, operação, custos e saída. Separar medições, afirmações documentais e hipóteses ainda não verificadas.
Resultado: tabela de critérios e evidências.
- 3
Registar escolha e consequências
Anotar opção, responsável, data e estado. Descrever dívida, migração e limitações aceites. Aprovar não elimina uma restrição conhecida. Ligar a decisão aos requisitos cumpridos e aos controlos pendentes.
Resultado: decisão aceite e consequências explícitas.
- 4
Preservar o histórico
Uma decisão substituída deve continuar compreensível. Ligar à sucessora sem reescrever o passado. Distinguir proposta, aceite, rejeitada e substituída; manter ligações a tarefas e provas acessíveis à equipa.
Resultado: registo e relações entre versões.
- 5
Definir motivos de revisão
Especificar mudanças de volume, disponibilidade, localização ou custos fora das hipóteses. Um sinal inicia nova comparação, não abandono automático. Confirmar se o novo responsável consegue explicar a escolha.
Resultado: motivos e teste de passagem de responsabilidade.
Planilha reutilizável
Preencha com suas observações autorizadas. Estes campos são um modelo de trabalho, não resultados observados.
| Campo | Informações a serem registradas |
|---|---|
| Questão | Problema, âmbito e restrições |
| Opções | Soluções e critérios comuns |
| Escolha | Estado, responsável e consequências |
| Revisão | Motivo e decisão substituta |
Exemplo prático fictício
Situação ilustrativa
Exemplo fictício: uma equipa escolhe pesquisa gerida por não ter a disponibilidade operacional necessária.
Decisão e evidências esperadas
O ADR conserva a restrição, os exports esperados e motivos de revisão para novas exigências linguísticas ou custos.
Distinguir os mecanismos
| Mecanismo | Finalidade | Verificação ou limitação |
|---|---|---|
| Ata | Conserva a discussão | A decisão pode ficar dispersa |
| ADR | Conserva escolha e razões | Não substitui especificações ou testes |
| Tarefa | Segue a implementação | Pode terminar sem guardar os motivos |
Indicadores de gestão
| Indicador | O que mede | Primeira ação |
|---|---|---|
| Escolhas rastreáveis | Decisões com contexto acessível | Priorizar dependências difíceis de assumir |
| Hipóteses verificadas | Suposições decisivas testadas | Rever onde faltam evidências |
| Passagem | Escolhas explicáveis pelo novo responsável | Melhorar o registo |
Erros comuns
- A decisão pode ficar dispersa
- Não substitui especificações ou testes
- Pode terminar sem guardar os motivos
Perguntas frequentes
Cada tarefa precisa de ADR?
Não. Usar em escolhas cujas consequências ou reversibilidade justificam conservar as razões.
Uma decisão aceite pode mudar?
Sim. Registar nova decisão, contexto e relação com a substituída, preservando os motivos anteriores.
O registo garante uma boa escolha?
Não. Torna critérios e hipóteses verificáveis; a qualidade das evidências continua decisiva.
Leituras e ferramentas complementares
Recursos editoriais para aprofundar o método.
- Française du Numérique — guias de projetos web Ligação externa
Ligar decisões, requisitos e verificações de um projeto web.
Referências oficiais
As referências apoiam o método. Adapte as verificações ao seu contexto; elas não são uma certificação. Os títulos das referências originais e os documentos de origem podem estar em outro idioma.
Referências consultadas em .
