# Runbook operativi

## Metadata
- ultima_verifica: 2026-05-28
- stato_validazione: parzialmente_confermato
- owner_documentazione: team_documentazione_tecnica

## Scopo operativo
Rendere ripetibili le operazioni di verifica post-rilascio, import dati, diagnosi rapida errori e controlli di coerenza applicativa.

## Perimetro e prerequisiti
- Accesso al repository codice target e all'ambiente corretto (dev/test/prod).
- Permessi su log applicativi e strumenti DB di sola lettura.
- Ticket o change request di riferimento aperta prima dell'intervento.

## Flusso end-to-end
1. Identificare capability/funzione coinvolta e confermare perimetro impatto.
2. Verificare configurazione ambiente e costanti applicative rilevanti.
3. Eseguire controlli preventivi su dati critici (campione minimo definito per dominio).
4. Applicare intervento tecnico o funzionale previsto.
5. Validare esito su UI/API/job con check funzionali e tecnici.
6. Eseguire query diagnostiche di coerenza post-intervento.
7. Annotare evidenze, rischi residui e outcome nel ticket.

## Componenti tecnici da controllare
- Controller/action coinvolti nel flusso.
- Model e query principali.
- Tabelle target e tabelle staging/event log.
- Schedulazioni/job asincroni collegati.
- Canali notifica (mail, log, audit).

## Failure mode e segnali di errore
- Incongruenze di mapping anagrafiche o chiavi esterne.
- Record in staging non elaborati o scartati senza motivazione.
- Timeout o errori DB su query massiva.
- Notifiche non inviate o inviate a destinatari errati.
- Stati applicativi incoerenti tra UI e DB.

## Checklist pre intervento
- Backup logico dei dati ad alta criticita (quando previsto).
- Conferma finestra operativa e impatto utente.
- Allineamento filtri/parametri prima di query manuali.

## Checklist post intervento
- Nessun errore bloccante nei log applicativi.
- Coerenza dati su campione di controllo.
- Funzione core validata da almeno un test end-to-end.
- Evidenze aggiornate nel ticket di riferimento.

## Criteri di accettazione operativa
- Intervento ripetibile senza conoscenza implicita dell'operatore.
- Diagnosi guidata disponibile in documentazione.
- Nessuna dipendenza da repository documentali esterni.

## Scopo
Descrivere obiettivo operativo e risultato atteso.

## Perimetro
Definire modulo, confini funzionali e prerequisiti.

## Flusso
1. Input e contesto.
2. Esecuzione del processo.
3. Output e verifica.

## Componenti
- Controller/servizi.
- Model e tabelle.
- Job/log/integrazioni correlate.

## Failure mode
- Errori ricorrenti.
- Cause tipiche.
- Segnali diagnostici.

## Checklist
- Pre: prerequisiti validati.
- Post: outcome e coerenza dati verificati.

## Criteri di accettazione
Contenuto azionabile, verificabile e coerente con il codice.