Operazioni di Scrittura (INSERT/UPDATE/DELETE)

Non solo lettura: anche scrittura via AI

Il modulo Operazioni di Scrittura di ReportIA estende la piattaforma oltre la sola consultazione: puoi modificare i dati con comandi in linguaggio naturale. "Inserisci un nuovo cliente", "aggiorna il prezzo", "elimina i record duplicati". L'AI genera la SQL di scrittura, mostra l'anteprima, esegue solo dopo conferma. Tutto auditato.

Comandi naturali per modifica dati

INSERT

Esempi:

• "Inserisci un nuovo cliente con nome Mario Rossi, P.IVA 01234567890, città Milano".
• "Aggiungi il prodotto SKU-9999 con descrizione 'Vite M8' e prezzo 0,50 €".
• "Crea un appuntamento per il 15 maggio alle 10:00 con il cliente Bianchi".

UPDATE

Esempi:

• "Aggiorna il prezzo dell'articolo SKU-1234 a 19,90 €".
• "Imposta lo stato 'evaso' per tutti gli ordini consegnati prima del 1 maggio".
• "Cambia il telefono del cliente Rossi srl a 333-1234567".

DELETE

Esempi:

• "Elimina i fornitori che non hanno avuto ordini negli ultimi 5 anni".
• "Cancella il cliente con ID 9876".
• "Rimuovi gli articoli marcati come obsoleti".

Anteprima SQL prima dell'esecuzione

Sicurezza prima di tutto. Per ogni operazione di scrittura:

1. L'utente fa la richiesta in linguaggio naturale.
2. L'AI genera la SQL.
3. Anteprima all'utente:
   • SQL completa visibile.
   • Tipo operazione (INSERT/UPDATE/DELETE).
   • Stima righe coinvolte.
   • Tabelle modificate.
4. Pulsanti "Esegui" o "Annulla".
5. Solo dopo conferma esplicita: esecuzione.

Niente più "oh no, ho cancellato 5.000 record per errore".

Audit log completo

Per ogni operazione di scrittura, log immodificabile:

• Tipo operazione: INSERT/UPDATE/DELETE con badge colorato.
• Database e tabella coinvolti.
• Utente che ha eseguito.
• Data e ora di esecuzione.
• SQL completa eseguita.
• Righe modificate o ID inserito.
• Successo/fallimento con eventuale messaggio errore.
• IP di provenienza.

Dashboard operazioni

Pannello amministrativo con:

• Numero operazioni nell'ultimo periodo.
• Suddivisione per tipo (INSERT/UPDATE/DELETE).
• Top utenti per numero operazioni.
• Tabelle più modificate.
• Operazioni fallite (per troubleshooting).
• Ricerca testuale nelle SQL.

Permessi granulari

Le operazioni di scrittura sono disabilitate di default. Per attivarle:

A livello azienda

• Toggle "Scrittura ON/OFF" nelle impostazioni.
• L'admin azienda decide se permetterle in generale.

A livello ruolo

• Per ruolo specifico: permesso dedicato "operazioni_scrittura".
• Ruoli admin: scrittura permessa.
• Ruoli base (es. visualizzatore): solo lettura.

A livello tabella (avanzato)

• Whitelist di tabelle dove la scrittura è permessa.
• Blacklist di tabelle critiche (es. utenti, configurazione).

Rollback informativo

Se l'operazione fallisce parzialmente:

• Sistema rileva l'errore.
• Eventuale rollback automatico (transazione database).
• Messaggio chiaro all'utente: "Operazione annullata: errore foreign key".
• Audit log con dettaglio errore.

Niente stato di dati a metà.

Casi d'uso pratici

Aggiornamento prezzi listino

Responsabile commerciale: "Aumenta del 5% i prezzi degli articoli della categoria 'Elettrodomestici'".

• Anteprima: 234 articoli coinvolti.
• Conferma: aggiornati.
• Audit log: chi, quando, quale aumento.

Inserimento clienti da elenco esterno

Marketing: "Importa questi 50 contatti dal CSV nella tabella prospect".

• L'AI propone gli INSERT.
• Anteprima 50 righe.
• Conferma.

Pulizia dati

Data analyst: "Elimina tutti i record duplicati nella tabella ordini".

• L'AI propone la SQL di pulizia.
• Anteprima 17 duplicati identificati.
• Conferma.

Quando NON usare

• Operazioni di massa critiche: per sicurezza, conviene comunque IT/data engineer.
• Modifiche a dati storici: rischio integrità.
• Bulk operations molto grandi: possibile timeout, meglio script dedicati.

Sicurezza e best practice

• Abilitare scrittura solo se necessario.
• Limitare a ruoli specifici.
• Backup giornalieri automatici del database.
• Rivedere periodicamente l'audit log.
• Formare gli utenti sulle responsabilità.

I moduli ReportIA correlati

• Chat AI.
• Gestione Utenti e Permessi.
• Logging e Audit.

Scopri ReportIA e modifica i dati con linguaggio naturale.