Architecture Decision Records¶
Le ADR registrano le decisioni architetturali prese durante lo sviluppo del progetto.
Formato basato su Michael Nygard's ADR template.
Indice¶
| ID | Titolo | Stato |
|---|---|---|
| ADR-0001 | Clean Architecture con package by feature | Accettato |
| ADR-0002 | Error handling con RFC 7807 ProblemDetail | Accettato |
| ADR-0003 | PostgreSQL reale via Testcontainers (no H2) | Accettato |
Come scrivere una nuova ADR¶
- Copia il template (sezione sotto) in
docs/adr/NNNN-titolo-kebab-case.md. - Numerazione progressiva a 4 cifre.
- Mai modificare un'ADR accettata: se cambia idea, scrivine una nuova che superseda la precedente.
Template¶
# ADR-NNNN: Titolo
**Stato:** Proposto | Accettato | Superato da ADR-NNNN
**Data:** YYYY-MM-DD
## Contesto
Qual è il problema? Quali forze in gioco?
## Decisione
Cosa abbiamo deciso?
## Conseguenze
Positive, negative, neutre.
## Alternative valutate
- Alt A — perché scartata
- Alt B — perché scartata