Registro di Audit

Log Immutabile delle Azioni

Ogni operazione significativa in Rela AI genera un registro di audit immutabile. I registri non possono essere modificati né eliminati, garantendo l'integrità della catena di audit per la conformità normativa.

Gli eventi vengono registrati utilizzando un pattern fire-and-forget: l'operazione principale non viene mai bloccata in attesa del completamento del registro di audit.

Campi del Registro

Ogni voce di audit contiene:

Campo	Tipo	Descrizione
`action`	string	Azione eseguita (create, update, delete)
`resource_type`	string	Tipo di risorsa interessata
`resource_id`	string	ID della risorsa interessata
`actor`	string	ID dell'utente o sistema che ha eseguito
`actor_type`	string	Tipo: user, system, api_key
`details`	object	Dati aggiuntivi dell'operazione
`previous_state`	object	Stato della risorsa prima della modifica
`new_state`	object	Stato della risorsa dopo la modifica
`timestamp`	datetime	Momento esatto dell'azione (UTC)
`hash`	string	Hash SHA-256 per verifica della catena

Il campo hash viene calcolato includendo l'hash del registro precedente, formando una catena verificabile simile alla blockchain.

Consultazione con Filtri

I registri vengono consultati tramite GET /api/v1/admin/audit con filtri:

GET /api/v1/admin/audit?resource_type=agent&action=update&actor=user_123
    &start_date=2026-01-01&end_date=2026-03-31
    &skip=0&limit=50

Filtri disponibili:

resource_type — Filtra per tipo di risorsa
resource_id — Filtra per risorsa specifica
action — Filtra per tipo di azione
actor — Filtra per attore
start_date / end_date — Intervallo di date

I risultati sono ordinati per timestamp discendente con paginazione.

Esportazione per Conformità

Per audit esterni, i registri vengono esportati tramite GET /api/v1/admin/audit/export:

Formato JSON con tutti i campi
Filtrato per intervallo di date
Include metadati di verifica dell'integrità
Compatibile con strumenti di analisi di conformità

L'esportazione è limitata agli utenti con permesso manage_billing e disponibile solo nei piani Professional ed Enterprise.

Cronologia della Risorsa

Per visualizzare tutte le modifiche di una risorsa specifica:

GET /api/v1/admin/audit/resource/{resource_type}/{resource_id}

Restituisce la cronologia completa delle modifiche della risorsa, permettendo di ricostruire il suo stato in qualsiasi momento.

Pattern Fire-and-Forget

Il registro di audit utilizza un pattern asincrono che non blocca mai l'operazione principale:

L'operazione di business viene eseguita normalmente
Il registro di audit viene accodato in background
Se il registro fallisce, viene ritentato con backoff esponenziale
L'operazione non fallisce mai a causa di un errore di audit

Questo garantisce che le prestazioni del sistema non siano degradate dall'audit mantenendo un registro completo di tutte le azioni.