Registro de decisão de arquitetura
Um registro de decisão de arquitetura (ADR) é um dos resultados mais importantes de um arquiteto de soluções. Esse registro documenta as decisões arquitetônicas que você toma ao longo do processo de projeto. Fornece igualmente justificações e implicações específicas do contexto para cada decisão.
O ADR documenta todas as decisões-chave, incluindo alternativas que você excluiu, para requisitos arquitetonicamente significativos. O log incorpora requisitos e restrições nos efeitos documentados de uma decisão.
Implementar um ADR
Inicie o ADR no início de uma carga de trabalho e mantenha-a durante toda a sua vida útil. Deve ser iniciada uma RAL para cargas de trabalho industriais abandonados e, se os dados estiverem disponíveis, devem ser gerados retroativamente com base em decisões passadas conhecidas. O ADR serve como um log somente de apêndice. Esse registro se estende além do projeto inicial para incluir aspetos do projeto em relação a futuros requisitos funcionais e não funcionais.
Características sugeridas de um registo individual
Seja coerente com a anatomia de cada registo. Crie um modelo de registro e siga-o consistentemente.
Um registo deve incluir elementos coerentes, tais como:
- Declaração do problema com contexto
- Opções consideradas
- Resultado da decisão
- Inclua compensações importantes feitas com esta decisão
- Registe o nível de confiança da decisão. Às vezes, uma decisão arquitetonicamente significativa é tomada com confiança relativamente baixa. Documentar esse baixo status de confiança pode ser útil para futuras decisões de reconsideração.
Divida uma decisão em várias se uma decisão arquitetônica resultar em várias fases, como abordagens de curto, médio prazo e longo prazo. Registre cada fase como seu próprio registro de decisão.
Evite esconder as consequências de decisões tomadas intencionalmente ou acidentalmente.
Mantenha registros picantes, assertivos, sobre o tema e factuais.
Evite fazer guias de design de registros de decisão. Se estiver disponível mais justificação ou ideação de design, forneça uma ligação para um documento como material suplementar, mas a decisão deve ser clara e autónoma sem esse material.
Repositório de documentação da carga de trabalho
Esse log deve estar prontamente disponível e armazenado abertamente com a documentação da carga de trabalho.
Um arquiteto pode ajudar uma equipe de carga de trabalho a alcançar recomendações de Excelência Operacional, ajudando a estabelecer e manter um repositório de documentos e ativos. Os arquitetos ajudam as equipes a colocar todos os seus ativos no repositório, como este log de decisões. Eles também incentivam a adoção unificada de uma única fonte de verdade pelas equipes para ser usada como referência, auditorias e resposta a incidentes.
Próximos passos
Mais recursos
Para obter exemplos de modelos, visite a organização Architectural Decision Records GitHub.