Introduzione
A settembre 2026 sono entrato in Attiva Servizi, un'azienda di pulizie del veneziano: case private, condomini, pulizie di fondo, sgomberi, disinfestazioni. Mi occupo di experience design e di intelligenza artificiale, e il legale privacy dell'azienda mi ha nominato ufficialmente Responsabile dell'Intelligenza Artificiale.
Il lavoro più grande di questi mesi è il gestionale web che sto costruendo con Claude Code e una squadra di agenti AI. Tiene il magazzino, pianifica il lavoro degli operatori, gestisce preventivi, ferie, timbrature e scadenze. Al posto di un sistema di file Excel collegati tra loro.
Ti racconto come l'ho impostato, con i numeri e le scelte che hanno funzionato. Se gestisci un'azienda di servizi, o progetti strumenti per chi lavora sul campo, molte di queste scelte valgono anche per te.
Da dove si parte: gli Excel collegati
Attiva Servizi non partiva da zero. Aveva un sistema serio di file Excel: uno per il magazzino, uno per i consumi di ogni anno, uno per la pianificazione, uno per lo scadenzario dei lavori periodici, collegati da formule e cruscotti. Funzionava, e proprio per questo era difficile da cambiare.
I limiti però erano chiari a chi lo usava ogni giorno:
- Dal cantiere non si aggiornava niente. Per registrare i materiali usati bisognava essere in ufficio, davanti al file.
- Un file condiviso lo modifica una persona alla volta. Ufficio e magazzino non potevano lavorare insieme sugli stessi dati.
- I passaggi tra un file e l'altro si facevano a mano. Un preventivo accettato, il piano della settimana e le scadenze vivevano in posti diversi.
- Nessuna traccia di chi aveva cambiato cosa. Una riga cancellata spariva senza lasciare segni.
L'obiettivo era tenere tutto quello che l'azienda aveva già imparato a fare con quei file, e togliere questi quattro problemi.
Prima del codice, la mappa
Il primo documento del progetto non contiene codice: è una tabella con ogni foglio di ogni file Excel, a cosa serve, quali colonne ha, quali calcoli fa, quali colori usa per avvisare, e lo stato nel gestionale (fatto, in parte, manca). Per scriverla gli agenti hanno letto solo i nomi dei fogli e i titoli delle colonne, mai una riga di dati.
Quella mappa è servita tre volte. Ha fissato il perimetro della prima fase (solo magazzino e consumi), ha mostrato cosa mancava in ogni momento e ha evitato la tentazione di riprogettare quello che funzionava già. La pianificazione del gestionale, per esempio, usa la stessa idea del file Excel, che l'ufficio conosceva e rispettava: il piano non si ricopia ogni settimana, si scrivono solo le eccezioni.
| Prima, negli Excel | Ora, nel gestionale |
|---|---|
| Materiali registrati in ufficio, davanti al file | Scarico dal telefono, anche senza rete, con il cantiere obbligatorio |
| Un file modificato da una persona alla volta | Ufficio, magazzino e operatori insieme, ognuno con i suoi permessi |
| Preventivi, piano e scadenze in file separati | Un percorso unico, dal preventivo alla fattura |
| Turni scoperti da cercare nel piano | Turni scoperti in evidenza e sostituti proposti |
| Righe cancellate senza traccia | Cestino con chi ha cancellato e quando |
Progettare per gli imprevisti
In un'azienda di pulizie la regola è facile: chi va dove, quando, per quante ore. Il lavoro vero lo fanno le eccezioni. Una persona si ammala alle sei del mattino, un cliente sposta il passaggio, un furgone è in officina.
La pianificazione parte da una formula che l'ufficio può leggere ad alta voce:
giornata = settimana tipo + passaggi a data fissa + spot - assenze ± variazioni del giorno
Da lì sono venute le scelte dell'interfaccia:
- L'imprevisto si segna in due clic. "Malata da oggi a venerdì": tutti i suoi turni di quei giorni diventano scoperti e finiscono nel riquadro "Da sistemare", con il numero rosso nel menu.
- "Trova chi". Su ogni turno scoperto il gestionale propone le persone libere in quella fascia, in ordine: chi conosce già il cantiere, chi è in zona, chi ha ancora ore libere sul contratto, chi ha i corsi richiesti. Accanto a ogni nome c'è il motivo ("conosce il cantiere, +6 h libere"), e un clic copre il turno.
- "Solo questa volta" o "Da ora in poi". Quando trascini un turno su un'altra persona, il gestionale chiede una cosa sola. Nel primo caso è una variazione del giorno, nel secondo cambia la settimana tipo da quella data, senza riscrivere niente.
Le ferie seguono la stessa logica: l'operatore le chiede dal telefono, l'ufficio approva o rifiuta con un motivo, e finché la richiesta aspetta i turni di quei giorni compaiono già come scoperti. Nessuno scopre il buco il giorno stesso.
Non bloccare mai il lavoro
Il percorso ideale di un lavoro è lineare: preventivo, ordine confermato, pianificazione, lavoro svolto, fattura. Nella realtà un'emergenza si fa prima di avere l'ordine, e capita di registrare una fattura per un lavoro fatto prima che esistesse il gestionale.
Un gestionale che obbliga a seguire l'ordine dei passi spinge le persone a tenere i dati fuori, sui foglietti. Così ho scelto la regola opposta: ogni passo si può saltare. Il gestionale non blocca il passo successivo, segna quello che manca e lo mette nell'elenco "Da sistemare": interventi fatti senza ordine, ordini confermati e non pianificati, lavori svolti e non fatturati. Su ogni lavoro una riga mostra i passi fatti in verde e quelli saltati in arancio.
L'ufficio lavora alla velocità della giornata, e a fine settimana sa cosa deve ancora sistemare.
Il lavoro sul campo, dal telefono
Il gestionale è un'app web installabile: in ufficio si apre sul computer, gli operatori la usano dal telefono. Tre funzioni hanno cambiato più delle altre il modo di lavorare:
- Scarichi dal telefono, anche senza rete. Molti cantieri sono scantinati o locali tecnici dove il telefono non prende. Lo scarico resta in coda e parte appena torna il segnale, senza doppioni. Il cantiere è obbligatorio: è quello che permette di sapere quanto materiale consuma ogni cantiere e se il contratto ci sta dentro.
- Timbrature che valgono come prova per il cliente. Inizio e fine del lavoro con il cantiere e la posizione, letta solo al momento della timbratura e confrontata con il raggio del cantiere. Non c'è nessun tracciamento durante la giornata.
- Sopralluoghi a voce. Una piccola app separata: chi fa il sopralluogo detta la descrizione del lavoro, scatta le foto e il gestionale prepara la bozza del preventivo, con i servizi proposti dal catalogo.
Per le timbrature ho fatto prima il lavoro legale e poi quello tecnico. L'interruttore che le accende lo può usare solo l'amministratore, e va acceso dopo l'informativa scritta agli operatori, la valutazione d'impatto privacy e il parere del consulente del lavoro. Finché è spento, l'app non mostra la voce e il database rifiuta le timbrature.
Una squadra di agenti AI, con regole scritte
Il gestionale l'ho costruito con Claude Code e una squadra di agenti, ognuno con un ruolo: architetto dell'infrastruttura e della sicurezza, analista dei dati e della migrazione dagli Excel, sviluppatore del database, sviluppatore dell'interfaccia, revisore della sicurezza e della qualità. Io decido, progetto e rivedo.
Le regole che hanno retto in cinque settimane:
- Un documento di passaggio di consegne. Ogni volta che qualcuno comincia o finisce un lavoro, scrive cosa sta facendo, su quale ramo, l'esito e cosa resta. Un agente nuovo legge quel file e sa da dove ripartire.
- Un ramo per funzione, test verdi prima di unire. Il revisore di sicurezza guarda ogni blocco prima che entri nella versione principale.
- Istruzioni precise, senza scelte aperte. All'inizio un agente consumava fino a 800.000 token per un lavoro, perché leggeva molto e provava di tutto. Con istruzioni a schema fisso (obiettivo in una frase, file da toccare già indicati, passi già decisi) siamo scesi a 140.000-250.000.
- I lavori piccoli senza agenti. Un colore, un testo, un filtro li cambio io in conversazione. L'agente serve quando un lavoro tocca database, app e prove insieme.
La lezione più utile riguarda il mio ruolo. Il codice ormai si scrive in fretta. Quello che rallenta sono le decisioni non prese: chi vede i prezzi, cosa succede se un operatore lascia una timbratura aperta, quale passo si può saltare. Ogni decisione è scritta nei documenti del progetto con la data e il motivo.
Privacy prima di tutto
Un gestionale contiene i dati più delicati di un'azienda: clienti, contratti, prezzi, persone. E tutto quello che un'AI legge esce dal computer. Da qui le regole che Claude e gli agenti seguono senza eccezioni:
- Si sviluppa solo su dati inventati. Database locale, clienti e cantieri finti. I dati veri non passano mai dall'AI.
- Le chiavi le usa solo una persona. I comandi che toccano il database vero li prepara l'AI e li lancio io; l'esito mostra solo conteggi, mai nomi o valori.
- Nel repository va solo codice. Un controllo automatico rifiuta file Excel, fotografie, chiavi, IBAN e codici fiscali prima di ogni salvataggio.
- Solo i dati che servono. Niente dati bancari, server in Europa, secondo fattore per chi vede dati sensibili, e su ogni tabella la regola "tutto vietato, salvo ciò che è permesso".
Sono le stesse regole che come Responsabile dell'Intelligenza Artificiale chiedo a tutta l'azienda quando usa l'AI.
L'AI dove serve, le regole dove bastano
Ottimizzare con l'AI non significa mettere un modello dappertutto. Per i sopralluoghi l'idea iniziale era far proporre all'AI le righe del preventivo partendo dalla descrizione dettata. Funzionava, ma costava qualche centesimo a sopralluogo e mandava il testo fuori dall'azienda.
Abbiamo scelto un'altra strada: la dettatura dell'iPhone per la voce e, nel preventivo, un pulsante che confronta il testo con il nome e le parole chiave dei servizi del catalogo, più un elenco di sinonimi ("vetri", "vetrate" e "finestre" portano allo stesso servizio). Il pulsante riconosce anche le frequenze dette, come "due volte alla settimana". Non costa niente e il testo resta in azienda. L'API di Claude resta un'opzione per quando servirà davvero.
L'AI ha costruito lo strumento. Dentro lo strumento, spesso bastano regole semplici che l'ufficio capisce e può correggere da solo.
I numeri, dopo cinque settimane
| Cosa | Dato |
|---|---|
| Primo salvataggio del codice | 11 ottobre 2026 |
| Versione al 13 novembre | 3.78 |
| Salvataggi del codice (commit) | 824 |
| Modifiche alla struttura del database | 149 |
| Controlli automatici sul database | oltre 3.500 |
| Aree dell'app | magazzino, ordini, consumi, clienti e cantieri, preventivi, contratti, pianificazione, ferie, timbrature, sopralluoghi, scadenzario |
Il primo salvataggio del codice è dell'11 ottobre; il giorno dopo i dati veri erano importati dagli Excel, e da metà ottobre il gestionale è in uso in ufficio. Le nuove funzioni nascono dalle richieste mie e dell'ufficio, quasi ogni giorno, e ogni richiesta ha la sua data nei documenti del progetto.
Come applicarlo alla tua azienda
Se vuoi rendere più snelli i flussi di lavoro della tua azienda con l'AI, questi sono i passi che rifarei:
- Mappa quello che esiste. File, fogli, colonne, calcoli, chi li usa e quando. Il sistema che hai già contiene anni di decisioni.
- Scegli un perimetro piccolo. Noi siamo partiti da magazzino e consumi. Il resto è arrivato quando quella parte funzionava.
- Progetta le eccezioni. Chiedi all'ufficio cosa succede quando le cose vanno storte, e parti da lì.
- Non bloccare il lavoro. Lascia saltare i passi e tieni traccia di cosa manca.
- Scrivi le regole per l'AI prima di cominciare. Cosa può leggere, cosa non deve mai toccare, chi approva cosa.
- Usa l'AI per costruire, e le regole semplici dove bastano. Ogni modello in produzione costa e porta dati fuori: deve valerne la pena.
FAQ
Serve un programmatore per costruire un gestionale con l'AI?
Nel mio caso no: progetto e coordino, e il codice lo scrivono Claude Code e gli agenti. Servono però competenze di prodotto e di sicurezza per decidere cosa costruire, controllare cosa arriva e proteggere i dati.
Quanto tempo ci vuole?
La prima versione del gestionale, con il magazzino e i dati veri importati dagli Excel, era pronta in due giorni. In cinque settimane ha raggiunto 824 salvataggi del codice e copre quasi tutto il lavoro dell'ufficio.
I dati dei clienti finiscono all'AI?
No. Lo sviluppo avviene su dati inventati e i comandi sul database vero li lancia una persona, con un esito che mostra solo conteggi.
Che cosa conviene digitalizzare per primo?
La parte che produce più ricopiature e più errori. Per Attiva Servizi erano i materiali usati nei cantieri: registrati in ufficio a posteriori, con il cantiere non sempre indicato.
Conclusione
Il gestionale è nato da un sistema di Excel che funzionava e da un ufficio che sapeva già cosa voleva. L'AI ha reso possibile costruirlo in poche settimane con una persona sola alla guida. Il lavoro di design è stato il resto: capire gli imprevisti, decidere cosa non bloccare, mettere la privacy prima della comodità.
Se stai pensando di fare lo stesso nella tua azienda, o vuoi capire se ha senso nel tuo caso, scrivimi.