Pannello del Valore

Il Pannello del Valore è la prima schermata che un cliente vede quando entra. A colpo d'occhio risponde alla domanda chiave: vale la pena ciò che sto pagando? Consolida nove widget che mostrano il ritorno reale — in USD e in tempo — che Rela AI genera sulla tua operazione.

Riepilogo esecutivo

Il cambio di gioco: la tua dashboard ha smesso di mostrare quanti token Gemini hai consumato (metrica utile per noi). Ora mostra downtime evitato, interventi predittivi attivati e il tuo ROI reale rispetto al costo del piano.

A cosa serve?

Con il pricing per-macchina, i token sono diventati un problema interno (vive nell'admin panel). Il cliente paga un canone fisso e ha bisogno di una risposta rapida a quattro domande:

1. Sto usando ciò che ho pagato? (Utilizzo del piano)
2. Il sistema funziona? (Salute operativa + Impatto degli agenti)
3. Dove sto lasciando soldi sul tavolo? (Avvisi di valore perduto)
4. Come mi confronto con il mercato e sono sul piano corretto? (Benchmark di settore + Plan fit)

Il Pannello del Valore risponde a tutte e quattro in meno di 30 secondi.

Come funziona?

flowchart LR
  A[Dati reali del tenant] --> B[Aggregazioni<br/>cross-collection]
  B --> C[Benchmark economici<br/>del tenant]
  C --> D[Hero ROI]
  C --> E[Avvisi di valore perduto]
  B --> F[Utilizzo del piano]
  B --> G[Salute operativa / Impatto agenti /<br/>Proattivo vs Reattivo / Inventario]
  B --> H[Benchmark settore]
  B --> I[Plan fit]
  D & E & F & G & H & I --> J[Pannello del Valore]

Ogni widget interroga un endpoint del backend che aggrega dati cross-collection: _assets per macchine attive, _machine_events per eventi del mese, _asset_kpis per OEE/MTTR/MTBF, _tenant_benchmarks per costi del cliente, _subscription_plans per prezzo e limiti.

Le cifre in USD si calcolano moltiplicando metriche fisiche (ore di downtime evitate, ore di tecnico risparmiate) per le ipotesi economiche che il tenant ha configurato in /settings/benchmarks. Se non sono state impostate, i widget mostrano solo metriche fisiche (senza USD) e un CTA per completarle.

Widget del pannello

1. Hero "Valore generato questo mese"

La card più importante: sopra la piega, a tutta larghezza.

Modalità configurata (benchmark pronti):

• Numero grande di risparmio netto (risparmio totale − costo piano).
• Delta ▲/▼ vs mese precedente.
• 6 metriche: risparmio totale, costo del piano, moltiplicatore ROI, downtime evitato (h), ore tecnico risparmiate, link "Modifica ipotesi".
• Badge del piano attuale (Essential/Professional/Enterprise).

Modalità fallback (senza benchmark): card ambra con metriche fisiche (downtime evitato, ore tecnico) e CTA "Configura ipotesi" → /settings/benchmarks. Non inventiamo mai cifre in USD senza dati reali del cliente.

Endpoint: GET /api/v1/roi/hero.

2. Avvisi di valore perduto

Widget a tutta larghezza appena sotto l'Hero. Trasforma dati passivi in azioni redditizie:

Ogni card ha un CTA inline che porta al percorso corrispondente (/assets, /parts, /tasks?filter=overdue).

Endpoint: GET /api/v1/roi/lost-value.

3. Utilizzo del piano

Sostituisce la vecchia vista di token. Mostra:

• Piano attuale (Essential / Professional / Enterprise) + prezzo/mese.
• Barre di progresso: Macchine (asset), Agenti (WhatsApp + Email), Interazioni (eventi del mese).
• Data di prossima fatturazione.

Endpoint: GET /api/v1/billing/overview (nuovo servizio composite).

4. Salute operativa

Cockpit di 6 metriche in griglia 3×2 con token di severità canonici:

• Allarmi critici attivi (emergency + critical).
• Allarmi warning attivi.
• Eventi ultime 24 h.
• Conformità manutenzione (%).
• SLA completion (%).
• Tempo medio di risoluzione.

Endpoint: GET /api/v1/dashboard/kpis + GET /api/v1/dashboard/sla.

5. Impatto degli agenti IA

Metriche del core value dell'abbonamento:

• Agenti attivi vs totali (WhatsApp + Email combinati).
• Conversazioni gestite (ultimi 30 giorni).
• Messaggi gestiti.
• Ultima attività con tempo relativo.
• Split WhatsApp vs Email nel footer.

6. Proattivo vs reattivo

Narrativa del cambio culturale verso la manutenzione pianificata:

• Percentuale di manutenzioni pianificate in tempo.
• OT scadute.
• Attività in corso.
• Attività completate.
• Barra segmentata con mix di priorità (urgent/high/medium/low).

7. Inventario + acquisti

• Valore totale dell'inventario (somma di unit_cost * quantity_on_hand).
• Pezzi registrati.
• Pezzi sotto minimo (con link a /parts?filter=low).
• Pezzi esauriti (con link a /parts?filter=zero).
• Footer con OT di acquisto aperte per stato + valore impegnato.

8. Benchmark vs settore

Confronta i KPI del tenant con baseline curati per 7 settori:

Tolleranza ±5 %: better / worse / on_par / no_data.

9. Sono sul piano giusto?

Euristica che rileva funzionalità tier-gated in uso e consiglia upgrade o downgrade:

• Upgrade: il tenant usa prognostics, anomaly_detection, energy_monitoring o extraction ma è su Essential. O usa oee, sso, audit_trail ma non è su Enterprise.
• Downgrade: il tenant è su Professional o Enterprise ma non tocca i gate esclusivi.
• Fit: il piano è allineato con l'uso reale.

Fiducia: high (≥2 funzionalità), medium (1), low (downgrade).

Endpoint condiviso con il benchmark: GET /api/v1/roi/insights.

Come usarlo

1. Vai alla home (/dashboard). È la prima schermata che vedi.
2. Controlla l'Hero per il numero titolo del mese.
3. Se vedi avvisi di valore perduto in ambra, fai clic su quello che ti interessa. Ogni card ha un CTA diretto all'azione redditizia.
4. Rivedi Utilizzo del piano per sapere se ti stai avvicinando a un limite.
5. Salute operativa + Proattivo/Reattivo riassumono lo stato fisico. Se vedi critici attivi, passa all'inbox operativo con il pulsante "Vai a operazioni".
6. Benchmark vs settore e Plan fit sono contestuali — rivedili ogni 2-3 mesi per calibrare aspettative e confermare di essere sul tier corretto.

Configurazione delle ipotesi economiche

Per sbloccare l'Hero in USD, il tenant deve compilare le ipotesi in /settings/benchmarks:

Finché non sono configurate, i widget pertinenti mostrano metriche fisiche (ore, count) e l'Hero adotta la modalità fallback ambra.

Endpoint: GET/PATCH/POST /api/v1/tenant-benchmarks (+ /reset).

Casi d'uso

1. Supervisore di manutenzione, lunedì 7:00. Entra nel Pannello del Valore, vede l'Hero con "Risparmio netto $33.200 questo mese, +12 % vs mese precedente". Poi scansiona gli avvisi di valore perduto, trova "3 asset degradati — potenziale $12.500", fa clic e crea OT per la settimana.
2. Plant manager, revisione mensile. Apre il pannello, conferma che il ROI si mantiene sopra 15×. Rivede il Benchmark vs Settore per validare che l'OEE del 78 % resta sopra la media del settore (alimentare: 65 %). Esporta uno screenshot per il comitato.
3. Onboarding di un cliente nuovo. Durante la prima settimana vedono l'Hero in modalità fallback con solo metriche fisiche. Finiscono il wizard di benchmark venerdì e da lunedì l'Hero mostra USD reali.

Limiti e ipotesi

• Le cifre in USD dipendono al 100 % dal tenant che ha configurato i suoi benchmark. Se i valori sono imprecisi, anche il ROI lo è.
• Il benchmark vs settore usa baseline pubblici fissi (non è la media live del settore). Si usa come riferimento direzionale, non come ranking esatto.
• Il widget "Plan fit" è un'euristica basata sul rilevamento di funzionalità tier-gated. Non considera il volume (numero di eventi, chiamate, ecc.).
• I widget fanno cache per richiesta — niente websocket. Un ricaricamento porta i dati più freschi.
• Ancora nessun layout mobile dedicato; tablet e desktop vanno bene.

Vantaggi chiave

• Il cliente capisce in 30 secondi quanto gli sta dando Rela AI questo mese.
• Gli avvisi proattivi trasformano la dashboard da passiva ad attiva — ogni card ha un CTA diretto all'azione redditizia.
• Il Plan fit previene il churn da sotto-utilizzo e fa emergere upgrade organici.
• L'Hero con ROI reale giustifica il rinnovo annuale con un numero verificabile.
• La separazione Pannello del Valore vs Pannello Operativo rispetta la legge di una sola responsabilità per schermata.

Riepilogo endpoint