Record decisionale dell'architettura
Un record decisionale dell'architettura (ADR) è uno dei risultati finali più importanti di un progettista di soluzioni. Questo record documenta le decisioni architetturali prese durante il processo di progettazione. Fornisce anche giustificazioni e implicazioni specifiche del contesto per ogni decisione.
L'ADR documenta tutte le decisioni chiave, incluse le alternative che è stato escluso, per i requisiti significativi dell'architettura. Il log incorpora requisiti e vincoli negli effetti documentati di una decisione.
Implementare un ADR
Avviare l'ADR all'inizio di un carico di lavoro e gestirlo per tutta la durata del carico di lavoro. È consigliabile avviare un ADR per i carichi di lavoro brownfield e, se i dati sono disponibili, devono essere generati retroattivamente in base alle decisioni precedenti note. L'ADR funge da log di sola accodamento. Questo record si estende oltre la progettazione iniziale per includere aspetti di progettazione rispetto ai requisiti funzionali e non funzionali futuri.
Caratteristiche suggerite di un singolo record
Essere coerenti con l'anatomia di ogni record. Progettare un modello di record e seguirlo in modo coerente.
Un record deve includere elementi coerenti, ad esempio:
- Istruzione del problema con contesto
- Opzioni considerate
- Risultato della decisione
- Includere importanti compromessi presi con questa decisione
- Registrare il livello di attendibilità della decisione. A volte una decisione architetturale significativa viene presa con una confidenza relativamente bassa. Documentare lo stato di bassa attendibilità potrebbe rivelarsi utile per le decisioni future di riconsiderazione.
Suddividere una decisione in più se una decisione architetturale comporterà più fasi, ad esempio approcci a breve termine, a medio termine e a lungo termine. Registrare ogni fase come record decisionale.
Evitare di nascondere le conseguenze delle decisioni intenzionalmente o accidentalmente.
Mantenere i record insodificati, assertivi, on-topic e fatti.
Evitare di prendere guide alla progettazione dei record decisionali. Se sono disponibili più motivazioni o idee di progettazione, fornire un collegamento a un documento come materiale supplementare, ma la decisione deve essere chiara e autonoma senza tale materiale.
Repository della documentazione del carico di lavoro
Questo log deve essere facilmente disponibile e archiviato apertamente con la documentazione del carico di lavoro.
Un architetto può aiutare un team del carico di lavoro a ottenere raccomandazioni di Eccellenza operativa aiutando a stabilire e gestire un documento e un repository di asset. Gli architetti aiutano i team a inserire tutti gli asset nel repository, ad esempio questo log decisionale. Incoraggiano inoltre l'adozione unificata dei team di una singola fonte di verità da usare per riferimento, controlli e risposta agli eventi imprevisti.
Passaggi successivi
Altre risorse
Per esempi di modelli, visitare l'organizzazione GitHub relativa ai record delle decisioni architetturali.