- Add docs/README.md as the index of all documentation. - Split the 52 DEC entries of decisioni-e-limiti.md into docs/adr/ADR-NN files (same numbers), add ADR-53 (audit log), TEMPLATE.md and an ADR index with a feature -> ADR table. - Rename decisioni-e-limiti.md to limiti-noti.md (LIM only) and rewrite all DEC-nn references as links to the ADRs. - Document the docs-first / SSOT / ADR rules in processo-di-modifica.md and map the docs in CLAUDE.md and README.md. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
1.3 KiB
1.3 KiB
ADR-53 — Il registro di audit è in sola aggiunta e si scrive nella transazione che descrive
- Stato: Accettata
- Area: Account, amministrazione e sicurezza
- Fonte di verità per: la scelta di progetto descritta qui sotto; i requisiti (
PREFISSO-NN) che la attuano stanno nei documenti di dominio, indicati nelle Conseguenze.
Decisione
Tutto ciò che muove denaro o cambia la configurazione lascia una riga in
audit_log; la riga nasce da un'unica funzione, è salvata nella stessa
transazione del cambiamento che descrive (tranne gli eventi puramente
osservativi) e non viene mai modificata né cancellata.
- Motivazione: l'amministrazione ha un solo token condiviso senza identità per singolo operatore (ADR-40): il registro è l'unica forma di responsabilità per le azioni dal pannello e il primo posto dove ricostruire cosa è successo dopo un problema.
- Conseguenze: o si salvano insieme il cambiamento e la sua riga, o nessuno
dei due; il registro dice cosa è cambiato ma non chi (vedi
ADR-40). Il
catalogo degli eventi e le regole di scrittura e lettura sono in
audit-log.md (
AUD-01…AUD-05).
Codice: app/audit/log.py:write_audit_log