Revisione e Validazione

Revisione Documento

La pagina Revisione Documento (/documents/{id}/review) è il cuore del processo di validazione. Qui puoi verificare e correggere i dati estratti automaticamente dall’OCR a partire dal PDF dell’ODL cartaceo.

Struttura del Documento ODL Originale

Il foglio di Lavorazione Interna (ODL) cartaceo ha la seguente struttura:

• Intestazione: Cliente, Padre ID, Num. ID (commessa), descrizione lavoro, quantità
• Tabella “Lavorazioni Svolte”: Data | Operaio (matricola) | Ore Lav. | Fuori (flag cantiere esterno) | Descrizione Lavoro
• Compilato manualmente dagli operai, con firma del responsabile

Colonna “Fuori”

La colonna Fuori (spunta quadrato) indica se la lavorazione è avvenuta fuori sede – informazione cruciale per attivare il calcolo delle ore di viaggio nel sistema.

Durante l’estrazione OCR, il flag viene impostato automaticamente anche quando nella Descrizione Lavoro compare la scritta VIAGGIO oppure FUORI SEDE, anche se la casella non risulta barrata nel documento.

Intestazione ODL

La sezione superiore della pagina di revisione mostra i dati generali estratti dall’OCR:

Campo	Descrizione
Cliente	Nome del cliente associato all’ODL
Padre ID	Identificativo del documento padre
Num. ID (Commessa)	Codice commessa – selezionabile dal dropdown o digitabile manualmente
Quantità	Quantità specificata nell’ODL
Descrizione Lavoro	Descrizione testuale del lavoro svolto

Consiglio

Il campo Num. ID (Commessa) offre un dropdown con le commesse padre aperte nel gestionale. Puoi anche digitare manualmente un codice se la commessa non è presente nella lista (es. 14_Pr000021).

Tabella Lavorazioni Svolte

La tabella mostra il dettaglio delle lavorazioni estratte dall’OCR:

Colonna	Descrizione
Data	Data in cui è stata svolta la lavorazione
Operaio	Dropdown per selezionare l’operaio dalla lista delle risorse attive del gestionale. Ogni voce mostra Cod. Risorsa — Descrizione (es. RIS001 — Rossi Mario). Se l’operaio ha compilato il modulo con il proprio codice risorsa, il sistema lo riconosce automaticamente
Cod. Risorsa	Codice risorsa del gestionale (compilato automaticamente dalla selezione operaio o dal riconoscimento OCR). Corrisponde all’ID risorsa nel gestionale, non al numero badge delle timbrature
Ore Lav.	Ore lavorate nella giornata
Fuori	Checkbox che indica lavoro fuori sede – attiva il calcolo ore di viaggio
Sotto-commessa	Badge con il codice sotto-commessa (se assegnato dopo uno split)
Descrizione Lavoro	Descrizione specifica della lavorazione svolta

Identificazione Operaio

Il sistema si basa sul codice risorsa scritto dall’operaio nel modulo ODL cartaceo per l’identificazione automatica. È fondamentale che gli operai seguano lo standard di compilazione indicato nella sezione Caricamento Documenti scrivendo il proprio codice risorsa (matricola) nella colonna “Operaio”. Se il codice non è riconosciuto, l’operatore dovrà selezionare manualmente l’operaio dal dropdown.

Operazioni sulla Tabella

Aggiungere una Riga

Premi il pulsante “Aggiungi riga” in alto a destra della tabella per inserire una nuova lavorazione manualmente (es. se l’OCR ha mancato una riga del PDF).

Eliminare una Riga

Clicca l’icona cestino (🗑️) nella colonna azioni della riga da rimuovere (es. riga duplicata dall’OCR).

Dividere in Sotto-commesse

Clicca l’icona split (↕️) per aprire la modale di suddivisione delle ore in sotto-commesse.

Suddivisione in Sotto-commesse

Quando un operaio ha lavorato su più sotto-commesse nella stessa giornata, puoi dividere le ore:

1. Clicca l’icona split sulla riga desiderata
2. Si apre una modale con le sotto-commesse disponibili per la commessa padre
3. Assegna le ore a ciascuna sotto-commessa
4. (Opzionale) Usa il pulsante “Suggerisci con AI” per ottenere un suggerimento automatico basato sulla descrizione del lavoro
5. Verifica che il totale delle ore assegnate corrisponda al totale originale
6. Premi “Conferma Split”

Suggerisci con AI

Il pulsante “Suggerisci con AI” invia la descrizione del lavoro al sistema AI per ricevere una proposta automatica di suddivisione delle ore tra le sotto-commesse.

• Descrizione: il campo descrizione della riga viene mostrato in sola lettura nella modale, come riferimento per il contesto inviato all’AI

• Suggerimento: se il sistema AI riesce a interpretare la descrizione, propone automaticamente la distribuzione delle ore sulle sotto-commesse disponibili

• Esito negativo: se il sistema AI non riesce a identificare uno split valido, viene mostrato il messaggio:

  ⚠️ Non ho compreso

  In questo caso l’operatore deve assegnare le ore manualmente.

Attenzione

Il totale delle ore assegnate alle sotto-commesse deve corrispondere esattamente alle ore totali della riga originale. Il pulsante “Conferma Split” sarà disabilitato finché i valori non corrispondono.

Sistema di Alert

Durante la revisione, il sistema genera automaticamente degli alert in caso di:

Alert	Descrizione
⚠️ Ore discrepanti	Ore timbrate significativamente superiori o inferiori alle ore ODL (soglia configurabile)
⚠️ Operaio mancante	Operaio presente in timbratura ma assente nell’ODL, o viceversa
⚠️ ODL senza timbrature	ODL aperto senza timbrature associate per più di N giorni lavorativi
⚠️ Risorsa non trovata	Il codice risorsa dell’operaio non corrisponde a nessuna risorsa attiva nel gestionale

Esclusione Righe Già Inserite

L’operatore ha la possibilità di escludere le righe già inserite in precedenza durante la validazione, evitando duplicazioni nei dati confermati.

Salva Bozza

Durante la revisione puoi salvare i dati in qualsiasi momento premendo il pulsante “Salva Bozza” (💾). Questo persiste le correzioni senza confermare il documento, permettendoti di riprendere la revisione in un secondo momento.

• Il documento rimane nello stato “Da revisionare”
• Puoi salvare la bozza tutte le volte che vuoi
• Le modifiche vengono salvate sul server e saranno disponibili alla riapertura

Conferma Dati

Dopo aver verificato e corretto tutti i dati:

1. Controlla ogni riga della tabella
2. Verifica la correttezza di commessa, operai, ore e flag Fuori
3. (Opzionale) Premi “Salva Bozza” per salvare le correzioni intermedie
4. Premi il pulsante “Conferma Dati” (✅)
5. Il documento passerà allo stato Confermato

Documento bloccato dopo la conferma

Una volta confermati, i dati non sono più modificabili. Tutti i campi e le azioni di modifica (aggiungi riga, elimina, split, assegnazione sotto-commessa) vengono disabilitati. Un banner informativo indica che il documento è bloccato. Assicurati che tutti i dati siano corretti prima di confermare.