Com'è fatto il report, campo per campo.
Questo è un esempio di struttura, non un documento che ti viene garantito. Serve a farti vedere come si legge un confronto: da dove viene ogni numero e che cosa dichiara.
In questa pagina capisci che cosa contiene un report e come si legge. Formato, contenuti e modalità di consegna dei materiali vengono definiti nell'accordo specifico: non esiste un pacchetto uguale per tutti. Qui trovi la struttura dei campi, le condizioni che impediscono di emettere il documento, un esempio della sua forma e il confronto tecnico autorizzato.
Le tre pagine di prova rispondono a domande diverse: il confronto tecnico è un calcolo realmente eseguito su dati di un'azienda; lo scenario sintetico usa dati inventati per mostrare il metodo; questa mostra la forma del documento.
01 — I campi obbligatori
Se manca uno di questi, non è un report Nigin.
Perimetro e provenienza
- ✓ Settore e area geografica
- ✓ Numero di mezzi, ordini e fermate
- ✓ Periodo analizzato
- ✓ Tipo di baseline e sua provenienza
- ✓ Vincoli attivi (dal registro vincoli), con lo stato dichiarato di ciascuno: applicato, delimitato dai dati disponibili, soltanto verificato o non dichiarato
- ✓ Provider di routing e solver, con configurazione
Risultati e limiti
- ✓ Chilometri baseline vs ricalcolati
- ✓ Durata baseline vs ricalcolata
- ✓ Mezzi utilizzati e consegne non assegnate
- ✓ Warning strutturati: codice, messaggio, origine
- ✓ Assunzioni economiche, una per una, con identificatore
- ✓ Non-garanzia e impronta di integrità del record
Non sono campi editoriali: il generatore del report li pretende. Le distanze entrano in metri e le durate in secondi — unità canoniche — e una conversione fatta a monte con unità diverse ferma l'emissione invece di passare inosservata. Le assunzioni economiche non sono testo libero: sono voci con un identificatore stabile (consumo per 100 km, prezzo del carburante, costo orario dell'autista, costo veicolo per km, giri al giorno, giorni operativi all'anno, fattore di emissione), dichiarate una per una o assenti.
Sull'impronta di integrità: è calcolata con SHA-256 sul contenuto del record serializzato in forma stabile, e riportata in forma abbreviata. Serve a verificare che il record non sia cambiato tra emissione e consegna. Non prova, da sola, la correttezza dei dati o del calcolo — per quello contano provenienza, configurazione e validazione, che il report dichiara separatamente.
Il record non porta un orario di generazione, ed è voluto. Il contratto del documento è deterministico: a parità di input il record è identico e l'impronta coincide. Un timestamp renderebbe diversa ogni riemissione anche a dati immutati, e renderebbe inutile il confronto. Il periodo analizzato, invece, è obbligatorio: è un dato del perimetro, non un artefatto dell'esecuzione.
02 — Le condizioni di blocco
Quando il report non esce affatto.
Un report che si adatta a input incompleti non è un report: è una presentazione. Qui il generatore preferisce fallire. Se una di queste condizioni si verifica, non viene emesso un documento con un asterisco — non viene emesso nulla, e l'errore riporta il codice e il campo che l'ha causato.
Provenienza e validazione
- ✕ Manca la provenienza del provider di routing
- ✕ Manca la provenienza del solver
- ✕ Il risultato del provider non è validato in modo indipendente
- ✕ Il risultato del solver non è validato
- ✕ La baseline è assente o non dichiarata
Coerenza numerica
- ✕ Le unità della baseline non corrispondono a quelle del calcolo
- ✕ Distanze e durate non sono in metri e secondi
- ✕ Una metrica tecnica non è un numero finito e valido
- ✕ Richiesta, dataset e risultato non hanno la stessa identità
- ✕ I totali del solver non si riconciliano con le matrici del provider
L'ultima è la più severa e la meno visibile: i chilometri e i minuti dichiarati vengono ricalcolati dalle matrici del provider seguendo l'ordine delle fermate prodotto dal solver. Se i due totali non coincidono, il documento non esce. È il controllo che impedisce a un risultato «bello» di sopravvivere a un errore di somma.
03 — Ciò che il report si rifiuta di dire
Quattro numeri che non troverai, per costruzione.
Sono affermazioni commerciali bloccate a monte, non omesse per prudenza editoriale. Il motivo del rifiuto è sempre lo stesso: nessun modello documentato è stato fornito per sostenerle. Se un giorno vorrai calcolarle, servirà definire il modello e assumersene le ipotesi — e quel documento non sarà il report tecnico.
Aumento di fatturato
Nessun modello causale documentato che leghi i chilometri risparmiati ai ricavi.
Aumento di margine
Nessun modello di margine fornito: struttura dei costi e prezzi non sono nel perimetro tecnico.
ROI
Nessun modello documentato di investimento e beneficio: mancano entrambi i termini del rapporto.
Aumento di produttività
Nessuna definizione esplicita: senza numeratore, denominatore e perimetro dichiarati, la parola non significa nulla.
04 — La forma del documento
Come si presenta, in un mockup della struttura.
Quello che segue è un mockup editoriale sintetico della struttura del report. I numeri non provengono da un'esecuzione del sistema: sono inventati per mostrare dove si collocano i campi e come si legge la riconciliazione. Non sono un caso reale, non sono una simulazione, non sono un benchmark: sono un fac-simile. Il caso reale, con i numeri veri e il verbale firmato, è nella sezione successiva.
La riconciliazione, per esteso: baseline 1.412 km; ricalcolato 1.301 km; differenza 111 km; variazione 111 / 1.412 × 100 = 7,8611898017%; arrotondata a una cifra decimale, −7,9%. Il conto è pubblicato per intero perché è così che va letta ogni percentuale del report: i due valori assoluti prima, la percentuale dopo, e mai la percentuale da sola.
Campi di contorno del mockup: perimetro distribuzione provinciale · baseline dichiarata come sequenza operativa registrata · vincoli attivi: deposito fisso, capacità, finestre orarie · provider di routing e solver con identità di configurazione · 3 warning, ciascuno con codice, messaggio e origine · assunzioni economiche: nessuna, quindi nessun costo e nessuna CO₂ nel documento · limiti: turni non modellati nel perimetro.
05 — L'evidenza reale
Preferisci numeri veri? Ci sono, con i conti per esteso.
Confronto tecnico autorizzato
IDEA Global Service S.r.l. (Terni): 54 consegne settimanali reali su 49 punti distinti, giro chiuso, baseline dichiarata, calcolo pubblicato giornata per giornata. Con una nota interpretativa che distingue il risultato tecnico, le assunzioni e i limiti di trasferibilità, e che dichiara ciò che non è stato misurato.
Leggi il confronto tecnico →Campi e formati
Il record nativo è JSON; l’esportazione avviene anche in TXT, CSV, HTML e PDF, e in tutti i casi porta con sé la provenienza. Il tracciato d’ingresso e i limiti dichiarati sono documentati pubblicamente; i codici interni no, perché non esiste un’interfaccia programmatica pubblica di cui possano essere il contratto.
Vai alla documentazione →La struttura è questa. I numeri saranno i tuoi.