Registro de decisión de arquitectura
Un registro de decisión de arquitectura (ADR) es uno de los resultados más importantes de un arquitecto de soluciones. Este registro documenta las decisiones arquitectónicas que se toman durante todo el proceso de diseño. También proporciona justificaciones e implicaciones específicas del contexto para cada decisión.
La ADR documenta todas las decisiones clave, incluidas las alternativas que descartó, para los requisitos arquitectónicomente significativos. El registro incorpora requisitos y restricciones en los efectos documentados de una decisión.
Implementación de una ADR
Inicie la ADR al inicio de una carga de trabajo y mantengala durante toda la vida útil de la carga de trabajo. Se debe iniciar una ADR para cargas de trabajo de brownfield y, si los datos están disponibles, deben generarse retroactivamente en función de las decisiones pasadas conocidas. La ADR actúa como registro de solo anexión. Este registro se extiende más allá del diseño inicial para incluir aspectos de diseño frente a requisitos funcionales y no funcionales futuros.
Características sugeridas de un registro individual
Sea coherente con la anatomía de cada registro. Diseñe una plantilla de registro y siga de forma coherente.
Un registro debe incluir elementos coherentes como:
- Instrucción de problema con contexto
- Opciones consideradas
- Resultado de la decisión
- Incluir importantes desventajas tomadas con esta decisión
- Registre el nivel de confianza de la decisión. A veces se toma una decisión arquitectónicamente significativa con una confianza relativamente baja. Documentar ese estado de confianza baja podría resultar útil para futuras decisiones de reconsideración.
Divida una decisión en varias si una decisión arquitectónica va a dar lugar a varias fases, como enfoques a corto plazo, a medio plazo y a largo plazo. Registre cada fase como su propio registro de decisión.
Evite ocultar las consecuencias de las decisiones intencionadamente o accidentalmente.
Mantenga registros pithy, assertive, on-topic y fáctico.
Evite tomar guías de diseño de registros de decisión. Si hay más justificación o ideación de diseño disponible, proporcione un vínculo a un documento como material complementario, pero la decisión debe ser clara y independiente sin ese material.
Repositorio de documentación de carga de trabajo
Este registro debe estar disponible y almacenarse abiertamente con la documentación de la carga de trabajo.
Un arquitecto puede ayudar a un equipo de cargas de trabajo a lograr recomendaciones de excelencia operativa al ayudar a establecer y mantener un repositorio de documentos y recursos. Los arquitectos ayudan a los equipos a colocar todos sus recursos en el repositorio, como este registro de decisiones. También animan a la adopción unificada de los equipos de una única fuente de verdad que se usará para la referencia, las auditorías y la respuesta a incidentes.
Pasos siguientes
Más recursos
Para ver ejemplos de plantillas, visite la organización de GitHub De registros de decisión de arquitectura.