0001. Registrare le decisioni architetturali

• Stato: Accettata
• Data: 2026-06-03
• Decisori: Team BI/ETL

Contesto

Le scelte strutturali (dipendenze, pattern, convenzioni) vengono prese durante lo sviluppo e spesso dimenticate. Senza traccia, vengono rimesse in discussione a ogni cambio di persona o, peggio, cambiate senza valutarne il costo.

Decisione

Adottiamo gli Architecture Decision Records (ADR). Ogni decisione architetturale significativa viene registrata in docs/architecture/adr/ come file numerato e immutabile, discusso e approvato tramite Pull Request.

Alternative considerate

• Documentazione su wiki esterno — si disallinea dal codice e non passa per la review.
• Solo commit message — non discoverabile, non strutturato.

Conseguenze

• Positive: storia delle decisioni tracciabile, onboarding più rapido, meno dibattiti ripetuti.
• Costi: richiede disciplina nello scrivere l'ADR al momento della decisione.