Audit Log per SaaS B2B: Come Tracciare Chi Ha Modificato Cosa Senza Rallentare l'App
Quando un utente cancella dati o cambia i permessi di un team, supporto e clienti vogliono sapere esattamente chi ha fatto cosa e quando. Una tabella append-only su Postgres risolve il problema senza appesantire l'app.

Cos'è un Audit Log (E Perché I Clienti Aziendali Lo Chiedono)
Ogni volta che un membro del team elimina un progetto, cambia un ruolo o esporta una lista contatti in un software B2B, serve una risposta chiara a quattro domande: chi ha agito, quale azione ha fatto, su quale elemento e quando.
Senza uno storico ordinato, risolvere errori umani o superare i questionari di sicurezza dei clienti diventa una caccia al tesoro nei log grezzi del server. Fatto bene, l'audit log lavora in silenzio senza rallentare nessun click.
| Metodo | Sicurezza Storico | Impatto Velocità | Utile per Supporto e Sicurezza? |
| :--- | :--- | :--- | :--- |
| Log testuali del server | Bassa (scadono presto) | Basso | Difficile filtrare per singolo cliente |
| Solo colonna updated_by | Scarsa (sovrascrive la storia) | Nullo | Mostra solo l'ultima modifica |
| Tabella Append-Only in DB | Alta (solo inserimenti) | Trascurabile | Storico completo ed esportabile |
I 2 Errori Che Rendono Lenti o Inutili Gli Audit Log
Quasi tutti i problemi di logging nascono da due scelte pratiche sbagliate:
- Bloccare l'interfaccia aspettando servizi esterni: Se chiami un endpoint di logging esterno in modo sincrono prima di confermare l'azione, l'app rallenta a ogni click.
- Registrare anche ogni visualizzazione inutile: Loggare ogni lettura di pagina riempie il database di rumore e nasconde gli eventi davvero importanti (
role.updated,api_key.created,data.exported).
Schema Pulito Append-Only su Postgres / Supabase
Registra solo gli eventi critici, vieta modifiche/cancellazioni tramite Row Level Security (RLS) e indicizza (tenant_id, created_at DESC):
-- Storico immutabile isolato per workspace/azienda cliente
CREATE TABLE IF NOT EXISTS public.audit_events (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
tenant_id text NOT NULL,
actor_id text NOT NULL,
action text NOT NULL,
resource_type text NOT NULL,
resource_id text NOT NULL,
metadata jsonb NOT NULL DEFAULT '{}'::jsonb,
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE INDEX IF NOT EXISTS idx_audit_events_tenant_time
ON public.audit_events (tenant_id, created_at DESC);
ALTER TABLE public.audit_events ENABLE ROW LEVEL SECURITY;
-- Gli admin possono SOLO leggere gli eventi del proprio workspace (mai UPDATE/DELETE)
CREATE POLICY "Admins read own audit logs"
ON public.audit_events FOR SELECT
TO authenticated
USING (tenant_id = (auth.jwt() ->> 'tenant_id'));
Vuoi controllare anche la sicurezza degli header HTTP del tuo sito o vedere come strutturiamo workflow tracciabili? Prova l'Inspector Security Headers o leggi il Case Study sull'Architettura di gabrielcucos.dev.
Checklist Pratica per Partire Bene
- Parti dagli eventi ad alto impatto: cambi permessi, esportazioni CSV, modifiche fatturazione e webhook.
- Rendi la tabella append-only: consenti solo
INSERTeSELECT, maiUPDATEoDELETEsugli eventi passati. - Pianifica l'archiviazione: sposta i log più vecchi di
12–24 mesisu storage economico invece di tenerli tutti sul DB principale.
Vuoi mettere in sicurezza dati, permessi RLS o flussi automatici sul tuo prodotto? Richiedi una Diagnosi Gratuita entro 48h.
Memo Strategici Correlati
Tutti gli Articoli →Pricing SaaS B2B: Come Strutturare Piani e Soglie Che Portano Upgrade Naturali
Un prezzo unico fisso lascia margine sul tavolo con i clienti grandi, mentre listini troppo complessi frenano chi vuole iniziare. Legare i piani a una metrica semplice di valore rende naturali gli upgrade senza attrito.
Pattern di Row-Level Security per database di lead multi-tenant: PostgreSQL RLS per il SaaS
Applicare l'isolamento multi-tenant a livello applicativo è una passività architetturale insostenibile. Nelle moderne distribuzioni B2B SaaS che gestiscono flussi di lead ad alta velocità, affidarsi a clausole 'WHERE tenant_id = ?' delegate all'ORM genera inevitabili fughe di dati. Questo blueprint analizza come implementare nativamente PostgreSQL RLS per il SaaS: riscrittura dell'Abstract Syntax Tree (AST), iniezione sicura del contesto di sessione con SET LOCAL, prevenzione dei sequential scan tramite funzioni STABLE, architetture di indicizzazione composite e parziali con B-Tree e GIN, gestione del transaction pooling con PgBouncer, isolamento degli agenti AI senza service-role bypass e strategie di migrazione a zero downtime.
Vuoi applicare questo sistema nel tuo business?
Che tu gestisca un'azienda o un team marketing/tech, condividi il sito e il tuo collo di bottiglia: entro 48 ore ricevi un piano d'azione chiaro.