Files
plm-lottery/docs/adr/ADR-53-registro-audit-solo-aggiunta-stessa-transazione.md
davideandClaude Sonnet 5.5 b424f670c5 Restructure docs: docs-first, SSOT, one ADR per decision
- 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>
2026-10-14 12:05:57 +02:00

25 lines
1.3 KiB
Markdown

# 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](ADR-40-l-amministrazione-usa-unico-token-condiviso.md)):
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](ADR-40-l-amministrazione-usa-unico-token-condiviso.md)). Il
catalogo degli eventi e le regole di scrittura e lettura sono in
[audit-log.md](../audit-log.md) (`AUD-01` … `AUD-05`).
*Codice:* `app/audit/log.py:write_audit_log`