Governance Architetturale con ADR (Decision Records)

Un diagramma mostra cosa è stato progettato, ma raramente spiega il perché. Quando un architetto lascia l’azienda o un sistema legacy deve essere modernizzato, le motivazioni che hanno portato a determinate scelte tecniche o di prodotto vengono irrimediabilmente perse.

Gli Architecture Decision Records (ADR) di EasyEA risolvono questo problema collegando le decisioni formali direttamente agli elementi e agli schemi del modello.

1. Struttura Canonica di un ADR in EasyEA

Ogni record architetturale è strutturato secondo le migliori pratiche internazionali:

graph TD
    subgraph ADR["Struttura di un Architecture Decision Record"]
        T["Titolo & Identificativo Univoco (es. ADR-042)"]
        S["Stato: Proposed | Accepted | Superseded | Deprecated"]
        C["Contesto: Problema aziendale, vincoli normativi o tecnologici"]
        D["Decisione: La scelta architetturale adottata"]
        CO["Conseguenze: Benefici attesi e trade-off / rischi accettati"]
        A["Alternative Valutate: Soluzioni scartate con motivazione"]
    end
    ADR --> Graph["Collegamento Diretto agli Elementi e Schemi Impattati"]

Stati del Ciclo di Vita:
- Proposed: Decisione in bozza sottomessa all’Architecture Review Board.
- Accepted: Decisione formalmente approvata e vincolante per i progetti.
- Superseded: Decisione superata da un ADR successivo (con link al record che la sostituisce).
- Deprecated: Prassi o standard tecnologico non più consentito nell’organizzazione.

2. Collegamento Diretto al Grafo Architetturale

La caratteristica distintiva dell’ADR Manager di EasyEA è il legame bidirezionale con il modello:

Associazione a Elementi Specifici: Puoi associare l’ADR a uno o più componenti applicativi, nodi cloud o processi di business (es. associare l’ADR “Adozione di PostgreSQL su RDS con Replica Multi-AZ” a tutti i nodi database del workspace).
Associazione a Schemi e Diagrammi: Collega la decisione allo schema che ne illustra l’applicazione concreta.
Visibilità nell’Inspector Elementi: Chiunque ispezioni un’applicazione nel catalogo o in un diagramma vedrà immediatamente l’elenco degli ADR collegati, comprendendo le motivazioni storiche della sua adozione.

3. Registro e Ricerca delle Decisioni

Dalla vista Architect Hub ➔ ADR Manager, puoi:

Ricercare per parola chiave in tutte le motivazioni e decisioni.
Filtrare per stato (es. individuare tutte le decisioni ancora in stato Proposed in attesa del comitato architettura).
Esportare l’intero registro decisionale in formato Markdown o PDF per gli audit di conformità.