Cruscotto KPI che prima controlla i dati

• Titolari di micro e piccole imprese senza un controller.
• Chi prepara ogni mese un riepilogo dei numeri partendo da export CSV.

Un cruscotto vale quanto l'export da cui parte. I file di vendite e spese dei programmi di contabilità contengono celle vuote, date impossibili, numeri di fattura ripetuti e IVA che non torna. Un cruscotto che li trasforma comunque in grafici nasconde il problema finché un totale non sembra strano.

1. Legge due export CSV, vendite (fatture) e spese: separati da virgola o punto e virgola, date all'italiana (31/03/2026), ISO o all'americana, importi 1.234,56 o 1,234.56. Scegli tu il formato di date e importi; l'app non lo indovina, e ti avvisa se un altro formato sembra più adatto.
2. Associa le colonne, con le intestazioni italiane e inglesi più comuni (Cliente, Imponibile, IVA, Totale, Scadenza, Data pagamento) già selezionate. Puoi cambiare ogni associazione.
3. Controlla i dati prima di qualsiasi grafico. Le righe con errori (celle obbligatorie vuote, date impossibili, importi non numerici, date future, copie identiche, lo stesso codice su righe diverse) sono escluse da ogni numero ed elencate con file, riga, colonna e valore. Gli avvisi (imponibile + IVA diverso dal totale, importi negativi, scadenza o pagamento prima della data fattura) lasciano la riga e la segnalano.
4. Calcola i KPI sulle righe valide, con un avviso che dice quante righe sono state escluse: ricavi, spese, utile e margine, saldo di cassa, clienti principali e fatture scadute per anzianità (1-30, 31-60, 61-90 e oltre 90 giorni). Gli importi sono gestiti in centesimi interi, quindi i totali sono esatti.

Elaborazione locale sul tuo computer, con accesso riservato.

Dodici mesi (da ottobre 2025 a settembre 2026) di fatture e spese inventate, con errori inseriti su righe note. Misurati il 5 ottobre 2026; numeri tratti dal riepilogo di valutazione del progetto.

• Errori inseriti trovati: ogni errore deve essere segnalato dal controllo giusto sulla riga giusta.
• KPI uguali al riferimento: ricavi, spese, cassa, importi scaduti, serie mensili e i 10 clienti principali calcolati dall'app sui file con errori coincidono, al centesimo, con i valori calcolati separatamente dalle risposte note del generatore.
• Che cosa non mostrano: gli errori sono quelli che abbiamo scelto di inserire, e il generatore e i controlli sono stati scritti dallo stesso sviluppatore. Un punteggio pieno mostra che i controlli fanno ciò che dichiarano; non mostra che trovino ogni problema negli export reali.

Python, pandas, Altair (grafici), Streamlit; test con pytest e Playwright; distribuito con Docker.

• Solo dati sintetici; non provato su export reali di alcun programma di contabilità o banca.
• Le spese sono considerate pagate alla loro data; non c'è una vista dei debiti verso fornitori.
• I pagamenti parziali non sono supportati: una fattura è pagata oppure no.
• Le note di credito vengono mantenute e segnalate, non abbinate alla loro fattura.
• Una sola valuta (EUR). I file Excel non vengono letti; esporta prima in CSV.
• Uno strumento di reportistica, non una consulenza contabile o fiscale.

Fonte: README e reports/summary.json di snello-kpi-dashboard, generati il 5 ottobre 2026. Il codice è privato, quindi non è collegato.