arc42

Un template gratuito e open source per la documentazione dell'architettura software, organizzato in dodici sezioni, dagli obiettivi e dal contesto fino ai rischi e al glossario.

Che cos'è arc42?

arc42, creato da Peter Hruschka e Gernot Starke, struttura la documentazione dell'architettura in dodici sezioni: introduzione e obiettivi, vincoli, contesto e ambito, strategia della soluzione, vista dei building block, vista di runtime, vista di deployment, concetti trasversali, decisioni architetturali, requisiti di qualità, rischi e debito tecnico, e glossario. Non prescrive alcuna notazione per i diagrammi, quindi i team spesso vi disegnano dentro diagrammi C4: il diagramma di contesto nella sezione 3, i diagrammi dei contenitori e dei componenti nella vista dei building block (sezione 5) e i diagrammi dinamici nella vista di runtime (sezione 6). La sua stessa indicazione è documentare solo ciò di cui i lettori hanno bisogno, invece di compilare ogni sezione.

Conosciuto anche come: arc42 template.

Termini correlati

  • Modello C4 — Un approccio leggero alla visualizzazione dell'architettura che descrive i sistemi software su quattro livelli: Contesto di Sistema, Contenitore, Componente e Codice.
  • Architecture Decision Record (ADR) — Un breve documento che cattura una singola decisione architetturalmente significativa, il suo contesto e le sue conseguenze.
  • Living Documentation — Documentazione generata o convalidata a partire dal sistema in esecuzione, così da rimanere accurata man mano che il sistema evolve.

Scopri di più