01 / Caso studio 04
Impiantistica — 40 tecnici, commesse di cantiere
Software su misura per la gestione commesse in impiantistica
Le ore stavano su fogli piegati in tasca, i materiali nella memoria del capocantiere e i documenti in quattro posti diversi. Il margine di una commessa si scopriva a lavori finiti, cioè quando non si poteva più fare niente.
Stack dell'intervento
- Next.js
- TypeScript
- PostgreSQL
- PWA offline
- IndexedDB
- S3
- API contabilità
- Docker
Offline-first non è una funzione in più: in un vano tecnico interrato non c'è campo, e un rapportino che si perde perché mancava la linea è un rapportino che torna sulla carta il giorno dopo.
- Settore
- Impianti elettrici e termoidraulici, lavori su commessa
- Sistemi coinvolti
- Applicativo su misura, contabilità, archivio documenti
- Durata
- 16 settimane in quattro rilasci
- Intervento
- Applicativo su misura offline-first per cantiere e ufficio
Che cosa stai leggendo
02 / Contesto
Da dove si parte
Quaranta tecnici, sessanta cantieri aperti, un foglio Excel
Un'impresa di impianti che lavora su commessa: appalti privati, qualche pubblico, manutenzioni programmate. La produzione è tutta fuori sede, l'ufficio è cinque persone, e il collegamento fra le due cose erano telefonate e fogli di carta.
La commessa esisteva in quattro posti
Il preventivo in un foglio Excel, gli ordini di materiale nel gestionale contabile, i documenti in una cartella di rete, le foto e le comunicazioni nei gruppi WhatsApp. Nessuno dei quattro sapeva degli altri: ricostruire una commessa era un lavoro di archeologia.
I rapportini erano carta, e la carta arriva in ritardo
Il tecnico compilava a fine giornata, consegnava il venerdì o il lunedì, l'ufficio digitava. Fra il lavoro fatto e il lavoro registrato passavano fino a dieci giorni, e i fogli persi non erano rari.
I materiali si imputavano a memoria
Il magazziniere caricava sul furgone quello che serviva; a quale commessa andasse davvero si decideva dopo, spesso a occhio. Il 18% delle ore e una quota simile di materiali finivano su una commessa generica che non voleva dire niente.
Il margine si scopriva a lavori chiusi
Quando arrivavano le ultime fatture dei fornitori, quarantacinque giorni dopo. A quel punto sapere che una commessa era andata sotto serve solo a saperlo: non c'è più nessuna decisione da prendere.
Dimensione
- Tecnici in cantiere
- 40, su 3 squadre e manutentori singoli
- Commesse aperte
- 50–70 contemporanee
- Personale d'ufficio
- 5
- Rapportini
- circa 800 al mese
Sistemi in campo
- Contabilità
- gestionale contabile con API di lettura
- Preventivi
- fogli Excel per commessa
- Documenti
- cartella di rete senza versioni
- Comunicazione di cantiere
- gruppi di messaggistica
03 / Punto di partenza
Misurato prima, non ricordato dopo
Sei ore a settimana solo per digitare fogli di carta
Tre settimane di rilevazione con l'ufficio e due squadre. Anche qui la cifra più utile non è quella di cui si lamentavano: il costo vero non era la digitazione, era il 18% di ore che finiva su una commessa sbagliata e falsava ogni preventivo successivo.
Sei ore a settimana di sola digitazione
Ottocento rapportini al mese, digitati da due persone dell'ufficio fra le altre cose. È il lavoro che tutti vedono e di cui tutti si lamentano, ma è il meno caro dei quattro problemi.
Il 18% delle ore non arrivava alla commessa giusta
Finiva su voci generiche o su commesse sbagliate. La conseguenza vera si vede al preventivo successivo: se non sai quanto è costato davvero un lavoro simile, il preventivo lo fai a sentimento, e a sentimento si sbaglia sempre nella stessa direzione.
Fino a dieci giorni di ritardo fra lavoro e registrazione
Un tecnico che consegna il lunedì un rapportino del venerdì precedente scrive quello che ricorda, e ricorda le ore meglio dei materiali. Il ritardo non è solo lentezza: è perdita di precisione.
Quarantacinque giorni per sapere com'era andata
Misurati come differenza fra la data di fine lavori e la data in cui il margine risultava calcolabile in contabilità. In quel mese e mezzo si erano già preventivate altre commesse con i numeri sbagliati.
Le grandezze rilevate prima dell'intervento
Tre settimane di rilevazione, con due squadre e l'ufficio, su commesse reali.
| Grandezza | Valore rilevato | Come è stata misurata |
|---|---|---|
| Digitazione rapportini | 6 h/settimana | Foglio ore tenuto dalle 2 addette per 3 settimane |
| Ore non imputate alla commessa corretta | 18% | Confronto fra rapportini cartacei e commesse aperte su un campione di 200 giornate |
| Ritardo fra lavoro svolto e registrazione | 4,8 giorni di media, fino a 10 | Differenza fra data del rapportino e data di inserimento |
| Tempo per conoscere il margine di commessa | 45 giorni dalla chiusura | Differenza fra fine lavori e data di calcolabilità in contabilità |
| Documenti non reperibili in 5 minuti | circa 1 su 4 | Prova pratica su 40 richieste di documento estratte a caso |
L'ultima riga è stata la più convincente in riunione: su quaranta documenti chiesti a caso, dieci non si trovavano in cinque minuti. Nessuno lo sapeva perché nessuno aveva mai provato a cercarli tutti di fila.
04 / Diagnosi
Che problema è davvero
Non serviva digitalizzare i rapportini. Serviva che la commessa esistesse
Finché ore, materiali, documenti e foto vivono in quattro posti diversi, la commessa non è un oggetto: è un'idea che sta nella testa del capocantiere.
La richiesta era «un'app per i rapportini». Digitalizzare i rapportini e basta avrebbe risolto le sei ore di digitazione — il problema più visibile e il meno costoso — lasciando intatti gli altri tre. La domanda giusta era un'altra: qual è l'oggetto attorno a cui gira questa azienda? È la commessa. Da lì il progetto è diventato: far esistere la commessa come cosa unica a cui si attaccano ore, materiali, documenti, foto e comunicazioni, e a cui si può chiedere in qualunque momento «quanto sei costata finora». I rapportini sono uno dei modi di attaccarci le ore, non il centro.
Come sono arrivato alla diagnosi
- Due giornate intere in cantiere con due squadre diverse, dall'apertura alla chiusura, per vedere quando e come si può realisticamente compilare qualcosa.
- Ricostruzione a ritroso di tre commesse chiuse, cercando ogni documento e ogni costo: è così che è venuto fuori il quarto di documenti irreperibili.
- Colloquio con chi fa i preventivi, per capire su quali dati storici si basa — e scoprire che si basava sulla memoria.
- Prova pratica di copertura di rete in cinque cantieri tipo, compresi due interrati: la premessa tecnica del funzionamento offline.
- Verifica di cosa il gestionale contabile può esporre sugli acquisti, per non doverli reinserire.
Cosa è saltato fuori
- In tre dei cinque cantieri provati la rete era assente o inutilizzabile per parte della giornata. Una soluzione solo online sarebbe stata abbandonata nella prima settimana.
- I tecnici erano disposti a compilare, ma non a compilare due volte: qualunque cosa chiedesse di ripetere un'informazione già data sarebbe stata aggirata.
- Il materiale caricato sul furgone al mattino è il momento giusto per imputarlo, non la sera: la sera nessuno si ricorda cosa ha usato dove.
- Le foto di cantiere erano già scattate da tutti, ma finivano nei telefoni personali. Non serviva convincere nessuno a fotografare: serviva dare alle foto un posto dove andare.
05 / Architettura
Cosa ho costruito
Un'applicazione che funziona anche quando la rete non c'è
Il telefono del tecnico tiene una copia locale di quello che gli serve, accetta il lavoro anche senza rete e lo sincronizza da solo appena può. L'ufficio vede la commessa aggiornata, non un archivio di fogli.
L'applicazione è una sola, con due facce: quella di cantiere, ridotta all'osso e pensata per essere usata con i guanti e con una mano; quella d'ufficio, completa, dove si aprono le commesse, si controllano i costi e si preparano i documenti. Sul telefono i dati necessari — commesse assegnate, voci di manodopera, materiali frequenti — stanno in una copia locale; le registrazioni finiscono in una coda che si svuota appena c'è linea, con l'ordine garantito e senza duplicati. Dal gestionale contabile arrivano gli acquisti, che si agganciano alla commessa: è l'unico pezzo di costo che l'applicazione non raccoglie da sé.
Flusso dei dati
Tre tocchi per registrare una giornata
Commessa (già proposta in base a ieri e alla posizione), ore, conferma. Tutto il resto è facoltativo. Ogni campo aggiuntivo obbligatorio sarebbe stato pagato con una percentuale di adozione, e la percentuale di adozione è il progetto.
La coda locale è la vera architettura
Quello che il tecnico registra viene salvato sul dispositivo e messo in coda. Quando torna la linea, la coda si svuota nell'ordine giusto e ogni registrazione porta una chiave che ne impedisce il doppio inserimento. Il tecnico non sa se era online: non è una sua preoccupazione.
Il materiale si imputa al carico, non alla sera
Il magazziniere assegna quello che carica sul furgone alla commessa, dal suo telefono, al momento in cui lo carica. È l'unico momento in cui l'informazione è certa. Le rettifiche successive restano possibili ma sono l'eccezione.
I documenti hanno una versione e un posto solo
Preventivo, varianti, disegni, certificati, verbali: agganciati alla commessa, con la versione e chi li ha caricati. La cartella di rete resta in sola lettura come archivio storico e non si scrive più lì.
Le foto e la firma si prendono sul posto
Foto agganciate alla commessa e alla data, firma del cliente sul verbale direttamente sullo schermo. Sono le due cose che, mancando, generano le contestazioni più costose mesi dopo.
Il margine si vede mentre la commessa è aperta
Ore già registrate per il costo orario, materiali imputati, acquisti presi dalla contabilità: il consuntivo parziale è disponibile in qualunque momento. Non è un dato contabile e non pretende di esserlo — è il dato che serve a decidere, che è una cosa diversa e arriva prima.
06 / Decisioni
Ogni scelta con la sua alternativa scartata
Le cinque scelte che hanno determinato tutto il resto
La prima è quella su cui il progetto si giocava: sbagliata, avrebbe prodotto un software perfetto e inutilizzato.
Scelte tecniche e loro costo
| Decisione | Alternativa scartata | Perché così |
|---|---|---|
| Funzionamento offline con coda locale | Applicazione solo online | In 3 cantieri su 5 la rete manca per parte della giornata. Costo: una parte consistente di complessità in più, e la gestione dei conflitti quando due dispositivi toccano la stessa commessa. |
| Applicazione web installabile | App nativa negli store | Quaranta tecnici con telefoni personali di ogni tipo: una web app si aggiorna da sé e non richiede installazioni gestite. Costo: accesso ai sensori più limitato e nessuna presenza negli store. |
| Imputazione del materiale al carico sul furgone | Imputazione a fine giornata insieme alle ore | La sera nessuno ricorda cosa ha usato dove: il dato sarebbe stato preciso quanto quello di prima. Costo: coinvolgere il magazziniere, che nella richiesta iniziale non era nemmeno un utente. |
| Nessuna sostituzione del gestionale contabile | Gestionale unico che copre anche la contabilità | La contabilità funziona e il commercialista ci lavora: sostituirla avrebbe raddoppiato il progetto e il rischio. Costo: un'integrazione da mantenere e due sistemi invece di uno. |
| Consuntivo gestionale, dichiarato non contabile | Margine calcolato con criteri contabili completi | Aspettare che ogni costo sia contabilizzato significa tornare a 45 giorni. Costo: due numeri diversi in azienda, che vanno spiegati una volta e ricordati sempre. |
07 / Come è andata
Sedici settimane, quattro rilasci
Le fasi, con quello che è stato consegnato a ognuna
Quattro rilasci veri in produzione, non quattro tappe su un diagramma. Dal secondo, l'azienda usava il sistema per lavorare mentre il resto veniva costruito.
- 01
Cantiere e misura
Due giornate in cantiere, ricostruzione di tre commesse chiuse, prova di copertura di rete, colloqui con chi preventiva. Disegno del modello della commessa.
- Cosa ricevi
- Modello dati della commessa condiviso e approvato, con le grandezze di partenza misurate
- Durata
- 3 settimane
- 02
Ore in cantiere
Applicazione di cantiere con registrazione ore offline, commesse assegnate, sincronizzazione. Avvio con una squadra di otto persone, la più scettica.
- Cosa ricevi
- Ore registrate dal telefono da una squadra, con la carta abbandonata per quel gruppo
- Durata
- 5 settimane
- 03
Materiali, documenti, foto
Imputazione dei materiali al carico, archivio documenti con versioni, foto e firma sul verbale. Estensione a tutte le squadre.
- Cosa ricevi
- Commessa completa di ore, materiali e documenti per tutti i cantieri aperti
- Durata
- 5 settimane
- 04
Costi, margine, consegna
Integrazione con la contabilità per gli acquisti, consuntivo parziale, cruscotto d'ufficio, importazione dello storico e formazione.
- Cosa ricevi
- Margine di commessa disponibile in 48 ore, manuale operativo e codice consegnato
- Durata
- 3 settimane
Partire dalla squadra più scettica invece che dalla più disponibile è stata una scelta deliberata e la rifarei: se funziona con loro funziona con tutti, e quando poi sono loro a dire agli altri che va bene, la formazione la fanno da soli.
08 / Attriti
Quello che è andato storto
Tre cose che non erano nel piano
In un progetto che mette un telefono in mano a quaranta persone che non l'hanno chiesto, gli attriti sono la parte prevedibile. Quali siano, no.
Il primo rilascio chiedeva troppi campi
Commessa, fase, ore, tipo di lavorazione, note: cinque campi, di cui tre obbligatori. Dopo una settimana metà delle registrazioni aveva «varie» ovunque fosse possibile. Ho tolto due obbligatorietà e proposto la commessa in automatico sulla base del giorno prima: le registrazioni utili sono passate dal 50% al 90% senza toccare altro. Ogni campo obbligatorio ha un prezzo, e si paga in qualità del dato.
Lo storico Excel importato era sporco più del previsto
Tre anni di preventivi in fogli con formule rotte, celle unite e commesse chiamate in tre modi diversi. L'importazione automatica ha prodotto dati inutilizzabili al primo tentativo. Abbiamo importato solo gli ultimi diciotto mesi, con una revisione manuale delle commesse più grandi, e lasciato il resto come archivio in sola lettura. Meglio uno storico corto e affidabile che uno lungo di cui non ti fidi.
Due telefoni non reggevano l'applicazione
Su quaranta tecnici, due avevano telefoni di sette anni con browser non aggiornabili, e su quelli l'applicazione non partiva. Il piano non prevedeva un budget hardware. È stato risolto dall'azienda con due telefoni base, ma è il tipo di dettaglio che va accertato all'inizio: la prima settimana ora comprende sempre un censimento dei dispositivi reali, non di quelli che si immaginano.
09 / Risultati
Stesse grandezze, stesse fonti
Cosa è cambiato, misurato dove era stato misurato prima
Rilevazione a tre mesi dal quarto rilascio, con lo stesso metodo e sulle stesse commesse tipo.
Prima e dopo, con la fonte di ogni numero
| Grandezza | Prima | Dopo | Come è misurata |
|---|---|---|---|
| Digitazione rapportini | 6 h/settimana | 20 min/settimana | Stesso foglio ore delle addette, ripetuto per 3 settimane |
| Ore non imputate alla commessa corretta | 18% | 3% | Confronto fra registrazioni e commesse su un campione di 200 giornate |
| Ritardo fra lavoro svolto e registrazione | 4,8 giorni | meno di 1 giorno | Differenza fra data della prestazione e data di sincronizzazione |
| Tempo per conoscere il margine di commessa | 45 giorni dalla chiusura | 48 ore, e parziale in tempo reale | Data di disponibilità del consuntivo nell'applicativo |
| Documenti non reperibili in 5 minuti | circa 1 su 4 | 1 su 40 nella prova ripetuta | Stessa prova pratica su 40 richieste estratte a caso |
| Registrazioni compilate in modo utile | — | 90% dopo la semplificazione, era il 50% | Percentuale di registrazioni senza campi «varie», misurata dall'applicativo |
Il 3% di ore ancora non imputate correttamente è quasi tutto di due manutentori che lavorano su chiamata con più interventi brevi nello stesso giorno: per loro il modello «una giornata, una commessa» non funziona, e la soluzione è un'altra schermata che non è stata fatta. Sta nell'elenco delle cose aperte, non fra i risultati.
Quello che non si misura in tabella
- Chi fa i preventivi ha per la prima volta uno storico di costi reali per tipo di lavorazione, invece della memoria.
- Le contestazioni sulle varianti si chiudono con foto e firma datate, non con la parola di due persone.
- Il venerdì pomeriggio in ufficio non è più il giorno dei rapportini.
10 / Dopo
Perimetro e manutenzione
Cosa è entrato nel progetto e cosa no
Il sistema non sostituisce la contabilità e non pretende di essere un ERP. È una scelta che tiene il progetto finito in sedici settimane invece di aperto per sempre.
Consegnato
- Applicativo di cantiere offline con ore, materiali, foto e firme
- Applicativo d'ufficio con commesse, costi e documenti
- Imputazione del materiale al carico dal magazzino
- Archivio documenti con versioni agganciato alla commessa
- Integrazione con la contabilità per i costi d'acquisto
- Consuntivo parziale e margine per commessa
- Importazione dello storico degli ultimi 18 mesi
- Codice sorgente, ambienti e documentazione consegnati
Fuori perimetro, dichiarato in partenza
- Sostituzione del gestionale contabile
- Fatturazione e ciclo attivo
- Pianificazione automatica delle squadre
- Modello a interventi multipli per i manutentori su chiamata
- Gestione del personale, ferie e permessi
La lezione che mi porto da questo lavoro
In un software che usano persone che non l'hanno chiesto, ogni campo obbligatorio è un prestito che si ripaga in dati sbagliati. Il salto dal 50% al 90% di registrazioni utili non è venuto da una funzione nuova: è venuto dal togliere due obbligatorietà e dall'indovinare la commessa al posto del tecnico. Da allora il primo rilascio di qualunque strumento da campo lo progetto contando i tocchi, e il numero di tocchi è un requisito scritto nel documento di analisi come qualunque altro.
11 / Obiezioni
Le domande che mi fanno su questo caso
Le tre domande che arrivano sempre
Le prime due le fa la proprietà, la terza la fa sempre qualcuno in ufficio.
- Non esiste già un gestionale di cantiere che fa queste cose?
- Esistono, sono buoni prodotti e in molti casi sono la risposta giusta: se il tuo modo di lavorare rientra nel loro, costano meno e sono pronti prima. Qui non rientrava su due punti — l'imputazione del materiale al carico e il consuntivo parziale con i criteri interni dell'azienda — ed erano esattamente i due punti che generavano il problema. Un pacchetto che sbaglia proprio dove ti fa male costa più di uno su misura, e si paga in aggiramenti quotidiani.
- I miei tecnici non useranno mai il telefono per lavorare.
- Lo usano già: fanno foto, mandano messaggi, cercano schede tecniche. Quello che non useranno è un modulo con dodici campi. In questo progetto la differenza fra il 50% e il 90% di registrazioni utili è stata togliere due campi obbligatori. Se un'app da cantiere richiede più di tre tocchi per la cosa che si fa tutti i giorni, il problema non sono i tecnici.
- Che succede se voglio cambiare fornitore fra due anni?
- Il codice, il database e gli ambienti sono del cliente dal primo giorno, la documentazione è scritta per essere letta da chi non l'ha costruito e non ci sono componenti proprietarie mie in mezzo. È una condizione che metto io nel contratto, non una concessione: un cliente che resta perché non può andarsene è un cliente che appena può se ne va.
12 / Correlate
Dove approfondire
Se questo caso somiglia al tuo
Il servizio spiega il metodo in generale, gli altri casi lo mostrano su problemi diversi.
13 / Contatto
Trenta minuti, senza impegno
Sai quanto è costata davvero l'ultima commessa?
Se la risposta arriva dopo la chiusura, arriva troppo tardi per servire a qualcosa. In mezz'ora guardiamo dove si perdono le ore e i materiali, e se vale la pena intervenire.
Porta un preventivo e il consuntivo della stessa commessa: la differenza fra i due è la conversazione.
Tutti i dati di contattoCome funziona la chiamata
- Minuti 0–10
- Come nasce e come si chiude oggi una commessa
- Minuti 10–20
- Dove finiscono ore, materiali e documenti
- Minuti 20–30
- Cosa costruirei per primo e con quale squadra partirei