Architecture Decision Records (ADR)¶

Cos'è un ADR?¶

Un Architecture Decision Record documenta una decisione architetturale significativa: - Perché è stata presa - Quali alternative sono state considerate
- Quali conseguenze ha

Quando Creare un ADR?¶

Crea un ADR quando: - ✅ Scegli un framework/tecnologia (es: Quarkus vs Spring Boot) - ✅ Cambi pattern architetturale (es: monolite → microservizi) - ✅ Decisione ha impatto su più moduli - ✅ Decisione difficile da reversare - ✅ Trade-off significativi coinvolti

NON serve ADR per: - ❌ Refactoring locale (singolo modulo) - ❌ Bug fix - ❌ Aggiunta feature semplice

Come Creare un ADR¶

Copia il template:

   cp docs/adr/template.md docs/adr/0001-titolo-decisione.md

Numerazione: usa numero progressivo (0001, 0002, ...)
Compila tutte le sezioni

Commit:

   git add docs/adr/0001-*.md
   git commit -m "docs(adr): Aggiungo decisione su [topic]"

Include nel MR della relativa implementazione

Lista ADR¶

Nessun ADR ancora creato

Template¶

Vedi template.md per creare nuovi ADR.