01La pratica
Tutta la vertenza, a colpo d’occhio.
Ogni lavoratore ha la sua scheda: periodo, stato della vertenza, importi. I totali si ricalcolano mentre si lavora, senza fogli di calcolo paralleli.
Progetto 01 · Analisi documentale
Dalle buste paga a numeri che reggono un confronto.
Un ufficio vertenze sindacale ricostruiva a mano, busta per busta, quanto spettava ai lavoratori. ValOra legge i cedolini, li confronta con il contratto collettivo e produce conteggi e relazioni tecniche.
Non è un esercizio: con ValOra preparo le relazioni di vertenze vere, che arrivano all’avvocato che le segue.
142,5 in griglia = 142,50 sul cedolinoStraordinario diurno · voce 0152 · marzo 2023
- buste paga in archivio
- con una prova aritmetica conservata
- pochi minuti
- per una pratica che richiedeva mezza giornata: stima dal lavoro d’ufficio
- 6 profili
- aziendali, ciascuno con le sue regole
In breve
- Problema
- Un ufficio vertenze sindacale ricostruiva a mano, busta per busta, quanto spettava ai lavoratori.
- Il mio contributo
- Dall’idea al rilascio: raccolta delle regole con chi le applica, sviluppo del software, automazione documentale e progettazione dei controlli.
- Risultato
- Da mezza giornata a pochi minuti per una pratica, secondo una stima dall’esperienza d’ufficio. Stima operativa, non una misurazione strutturata.
- Stato del progetto
- In uso: con ValOra preparo relazioni di vertenze vere, che arrivano all’avvocato che le segue. Il codice è in un repository privato.
Percorso guidato
Sei schermate, una pratica.
Dal cedolino al documento per l’avvocato, con i punti che contano segnati sulle schermate. In fondo, la domanda che regge tutto il resto: perché questo numero?
02La lettura
La busta entra. L’interfaccia racconta cosa succede.
Mentre il modello legge il cedolino, la Dynamic Island in alto mostra lo stato del lavoro: scansione, conferma, esito. Chi usa l’app non resta davanti a una rotellina.
In produzione la lettura la fa Google Gemini, e un secondo controllo la rifà senza il modello (più sotto). In questa demo la lettura è simulata su un cedolino di fantasia.
03La verifica
Ogni numero, accanto al documento da cui viene.
Il visore apre la busta accanto alla griglia. Chi controlla non deve fidarsi: confronta. Qui marzo 2023 riporta 142,50 € di straordinario diurno e 188,00 € di indennità notturna, e il cedolino dice lo stesso.
04I controlli
Una pratica che dice cosa le manca.
Prima di consegnare, la scheda riassume i controlli: documenti, anomalie, calcolo, consegna. Un buco non si nasconde in fondo a una tabella: sta in cima, con il suo nome.
05Il documento
Quello che arriva all’avvocato.
Un unico PDF con i conteggi di tutte le tabelle, la relazione sul caso specifico e il riepilogo finale. Qui una delle tabelle: anno per anno, competenze accessorie, giorni lavorati, media giornaliera, giorni di ferie e indennità che spettava.
Prova tu
Un numero in griglia. Chiedigli da dove viene.
In ValOra la domanda parte dalla cella: clic destro, «Perché questo dato?». Fai lo stesso sulla cella di agosto, e la risposta si apre qui sotto.
La risposta di EVE| Mese | Giorni lav. | Ind. lav. notturno 0470 | Ferie |
|---|---|---|---|
| Giugno | 21 | 40,00 | – |
| Luglio | 22 | 80,00 | – |
| Agosto | 20 | 2 | |
| Settembre | 19 | 20,00 | 3 |
06La spiegazione · EVE
Perché questa cella vale questo numero?
Su una cella della griglia, EVE ricostruisce la strada del valore e mostra le prove: il rigo del cedolino ritagliato dal PDF, le voci sommate e quelle escluse, le decisioni prese a mano. Non ricalcola niente: legge quello che l’app ha conservato. Una spiegazione che rifà il conto sarebbe una seconda opinione, non una prova.
La somma delle voci torna con il totale stampato, e sotto c’è il rigo del cedolino ritagliato dal PDF: la carta accanto al numero.
Il cerchio tratteggiato è un passaggio che non c’è. Resta scritto: nasconderlo farebbe sembrare completa la catena.
Cosa si vede nel film
- Un ufficio vertenze ricostruiva a mano, busta per busta, quanto spettava: 7.343 buste paga in archivio.
- ValOra legge il cedolino e mette ogni voce nel suo mese, accanto al documento da cui viene.
- Poi rifà i conti: la somma delle voci deve dare il totale stampato. Quando uno scarto di 12,50 € la smentisce, la busta resta «non determinata». Se non torna, non passa.
- Perché questo numero? Su una cella, EVE mostra i sette passaggi della prova, fino al rigo del cedolino.
- All’avvocato arriva un unico PDF: i conteggi di tutte le tabelle, la relazione sul caso specifico e il riepilogo finale.
- ValOra: dalle buste paga a numeri che reggono un confronto.
Il metodo
Il controllo che non si fida dell’AI.
Due letture che concordano possono sbagliare insieme. Per questo il controllo guarda la fonte e fa i conti, invece di chiedere un secondo parere allo stesso modello.
- 01Il modello legge
Google Gemini estrae dal cedolino voci, importi, giorni e periodo.
- 02Un secondo lettore rilegge
Un parser locale riapre il documento originale e confronta. Non vede il ragionamento del modello: vede la fonte.
- 03L’aritmetica decide
La somma delle voci deve dare il totale stampato sulla busta. La prova resta salvata accanto all’importo.
- esitoSe non torna, non passa.
La busta resta «non determinata», con il motivo scritto. Un risultato che risponde comunque sarebbe indistinguibile da uno buono.
Negli anelli, la stessa busta fac-simile del pannello EVE.
Chi decide
Il criterio lo decide l’avvocato. ValOra lo applica e lo mostra.
Quali voci entrano nel calcolo non è una scelta tecnica. A settembre l’avvocato ha stabilito che, in ogni anno, contano le voci variabili pagate almeno sei mesi su dodici: la regola è nel codice, e la scheda dice quale criterio è attivo. Quando la verifica sul documento trova una differenza, la propone: i dati cambiano solo quando una persona la conferma.
- L’avvocatoStabilisce il criteriovoci variabili pagate almeno 6 mesi su 12
- ValOraLo applica e lo scrive sulla schedacriterio attivo
- Una personaConferma ogni correzioneproposta conferma
Un caso vero
Il test che ha trovato un buco, e la correzione misurata.
L’8 settembre ho dato al riconoscitore del formato pagine che avrebbe dovuto rifiutare. Ne ha accettati 11 su 19. Il 17 settembre ho aggiunto un cancello: dopo la forma, qualcosa nel contenuto deve confermare la lettura. Rifatta la misura sullo stesso banco di 77 pagine.
- 08/09il test: 11 pagine su 19 accettate
- 17/09il cancello sul contenuto
- dopostessa misura, stesso banco
Le 19 pagine di un altro formato: l’8 settembre 11 accettate per errore, dopo la correzione del 17 settembre nessuna.
- 11/19 → 0/19
- pagine di un altro formato accettate per errore
- 381 = 381
- buste verificate prima e dopo: nessuna busta vera persa
Campione, fonte e limiti
Esperimento dell’8 settembre 2026. Conteggi ricalcolati dal CSV locale: 18 pagine del formato atteso e 19 di un altro formato. Nel primo gruppo 11 letture sono corroborate e 7 non corroborate; nel secondo, tutte le 11 letture accettate sono non corroborate. È un test diagnostico su un campione limitato, non una misura di accuratezza generale.
Correzione del 17 settembre: dopo il riconoscimento della forma serve una conferma dal contenuto. Sullo stesso banco di 77 pagine le accettazioni errate scendono a 0 in tutti i gruppi di altro formato (0 su 19, 0 su 13 e 0 su 11 nei tre gruppi); le pagine del formato atteso accettate passano da 18 a 16, e le due escluse non contribuivano a nessuna busta. Sull’intero archivio di quel formato le buste verificate restano 381 prima e dopo.
Fonte: dati-falsi-template-2026-09-08.csv e relativo referto nel progetto ValOra. Sono mostrati soltanto aggregati, senza documenti o dati personali.
I limiti
Dove si ferma.
Un limite scritto vale quanto una funzione: dice dove serve ancora una persona.
- Non riempie i vuoti.
Un mese senza busta resta scoperto e segnalato: una stima non diventa un dato.
- Sulle scansioni la prova è più debole, e lo dice.
Sui PDF testuali la verifica rilegge il documento al centesimo; sulle buste scansionate restano i controlli aritmetici e la revisione a occhio. I tre livelli non sono equivalenti, e non vengono presentati come uno solo.
- Rilettura del PDF testuale: forza 3 su 3
- Controlli aritmetici: forza 2 su 3
- Revisione a occhio: forza 1 su 3
- Senza fonte non risponde.
L’assistente legale risponde solo sui documenti che ha in biblioteca; se non trova la fonte lo dice, invece di rispondere a memoria.
Per chi legge il codice
Come è costruita.
Il codice è in un repository privato: lo mostro volentieri in un colloquio.
- InterfacciaReact 19
e TypeScript, con Vite
- Dati12 tabelle
PostgreSQL su Supabase: 61 migrazioni versionate, sicurezza a livello di riga su tutte le tabelle
- Server7 funzioni
serverless su Netlify
- AIGemini
per la lettura dei documenti; ricerca semantica con pgvector su sentenze e accordi
- Qualità1.564 test
automatici, end-to-end con Playwright, mutation test manuale sulle prove critiche, CI con GitHub Actions
- DocumentiPDF · Word · Excel
relazioni da un’unica fonte
CAF studioParliamone
Costruire strumenti utili.
Capire dove funzionano. Verificare dove si fermano.