📈 Reportistica

Le 5 viste di analisi: Dashboard Analitica, Statistiche Catalogo, Sales Funnel, Cash-flow Forecast, Top-N Parametrico

Dove trovi le viste

Tutte le 5 viste sono nella sidebar sotto il gruppo 📈 REPORTISTICA:

Dashboard Analitica — fatturato mensile, top clienti, marginalità prodotti.
Statistiche Catalogo — analisi articoli/prodotti con filtri categoria.
Sales Funnel ⚡ nuovo — conversione preventivo → ordine → DDT → fattura → incasso.
Cash-flow Forecast ⚡ nuovo — aging crediti 30/60/90 + proiezione 12 settimane.
Top-N Parametrico ⚡ nuovo — Pareto 80/20 su clienti, articoli o agenti.

💡Apri qualsiasi vista in nuova scheda con Ctrl / Cmd + click (anche Alt + click) per consultare in parallelo.

Sales Funnel

Mostra quanti record ci sono per ciascuno step del ciclo vendita e quanti progrediscono al passo successivo.

A cosa serve

Vedere dove perdi clienti: se da 100 preventivi solo 30 diventano ordini, hai un problema in fase di trattativa.
Identificare colli di bottiglia logistici: ordini che non diventano DDT = problema magazzino o fornitori.
Misurare il tempo di incasso: lo step finale (Incassate) mostra le scadenze pagate nel periodo.

Filtri disponibili

Filtro	Effetto
Periodo (Da / A)	Limita ai documenti con data emissione nel range.
Agente	Mostra il funnel di un solo agente per misurare la sua performance.
Preset rapidi	Mese corrente, Trimestre, YTD (anno-to-date), Ultimi 12 mesi.

Come leggere i numeri

Step su precedente: % dei record arrivati allo step corrente rispetto al precedente. Verde ≥60%, giallo 30-60%, rosso <30%.
Cumulativo da PRV: % che ha completato il ciclo fino a questo step partendo dai preventivi iniziali.

🎯Drill-down: clicca su uno step (es. "DDT") per aprire la lista documenti DDT del periodo selezionato.

Cash-flow Forecast

La vista che chi gestisce la tesoreria userà ogni mattina. Risponde a: "quanto incasserò nelle prossime 4 settimane?" e "quanto ho di scaduto?".

Le 4 KPI in alto

KPI	Significato
Scadute	Importo + numero di rate con data scadenza già passata e non incassate.
Crediti Aperti	Tutto il non incassato (scadute + future). Il "magazzino crediti".
Incassi YTD	Quanto hai incassato dall'inizio anno + media mensile.
Copertura	Crediti aperti ÷ media incassi mensile = mesi di "polmone" finanziario.

Aging crediti (barchart)

Ogni colonna è una fascia di scadenza:

Scadute (rosso) — agire subito: solleciti, blocco forniture, accordi rateali.
0-30 giorni (arancione) — incassi attesi nelle prossime 4 settimane.
30-60 / 60-90 — pianificazione cassa media-lunga.
Oltre 90 — clienti con condizioni lunghe (es. PA), vanno tenuti d'occhio.

Proiezione 12 settimane

L'area blu mostra l'incasso atteso settimana per settimana basandosi sulle scadenze in stato ATTESA. Picchi alti = settimane di forte incasso, valli = settimane "scoperte" dove pianificare uscite.

🎯Drill-down: clic su KPI Scadute / Crediti Aperti / Incassi YTD apre lo Scadenzario filtrato. Stesso vale per le voci della legenda dei bucket aging.

⚠️Il filtro "Modalità incasso" (MP01 contanti, MP05 bonifico, MP12 RIBA, ecc.) ti permette di isolare il flusso di un singolo canale di pagamento — utile se hai accordi RIBA con date fisse mensili.

Top-N Parametrico (Pareto 80/20)

La vista "chi è il mio 80/20?" applicabile a 3 ambiti diversi.

3 Tab Ambito

Ambito	Cosa aggrega	Drill-down
Top Clienti	Lordo totale fatture per soggetto.	Apre Documenti del cliente nel periodo.
Top Articoli	Totale riga per voce catalogo (somma su tutte le fatture).	Apre la scheda Catalogo dell'articolo.
Top Agenti	Importo provvigioni maturate per agente.	Apre la scheda Agente.

Filtri

Periodo + preset rapidi.
Top N — quanti record mostrare (10, 20, 50, 100).
Min € — soglia minima di valore per escludere il rumore di coda.

Come leggere il Pareto

Barre gold — valore individuale di ogni record.
Linea rossa — cumulativo: quale % di valore è coperto includendo i top-K record.
Linea tratteggiata 80% — soglia di riferimento Pareto. Le barre sopra la linea sono il "core 80/20".
Le righe della tabella nel core 80/20 hanno sfondo gold-tinted; oro/argento/bronzo medaglie sui primi 3.

🎯Drill-down: clic su qualsiasi riga apre il dettaglio (cliente, articolo o agente) filtrato per il periodo corrente.

📊Caso d'uso pratico: cambia l'ambito a "Top Articoli" con preset "12 mesi" e Top 50. Le righe nel core 80/20 sono i prodotti su cui concentrare scorte di sicurezza, fornitori multipli e attenzione commerciale.

Performance e endpoint backend

Le 3 nuove viste si appoggiano a 4 endpoint dedicati lato server (aggregazione SQL diretta):

GET /api/reporting/funnel-totali — count + somma per ogni tipo documento.
GET /api/reporting/top-clienti — group by soggettoId su lordoTotale.
GET /api/reporting/top-articoli — join documento_righe + voce_catalogo aggregato.
GET /api/reporting/top-agenti — group by agenteConfigId su provvigione_riga.

Questo significa: anche su workspace con migliaia di fatture, le viste rispondono in pochi secondi senza scaricare ogni singolo documento sul browser.

⚠️Il filtro periodo è obbligatorio (default = anno corrente). Selezionare un range troppo ampio su workspace con grossa storicità può rallentare la query.