CSAT — Customer Care

Web app statica (zero backend, zero build step) per monitorare il CSAT del team Customer Care e dei mercati globali.
Funziona interamente nel browser: i dati non lasciano mai il tuo dispositivo.

---

Come esportare il report CSAT1 da Salesforce

1. Apri Salesforce → Reports → cerca il report CSAT1.
2. Clicca Export → scegli formato Excel (.xlsx).
3. Salva il file sul tuo computer (resterà fuori dal repository, è nei .gitignore).

Il report deve contenere almeno queste colonne (il parser le trova automaticamente):

Colonna	Uso
Created By: Full Name	Agente (forward-fill per gruppo)
Created Date (prima occorrenza)	Gruppo mese
Number Value	Voto 1–5
Response Completion Date and Time	Data survey (preferita)
Created Date (seconda occorrenza)	Data fallback
Name	Filtra solo righe che iniziano con Case
Contact	Nome cliente (opzionale)

---

Come usare l'app

Caricare un export

1. Apri index.html nel browser (o visita l'URL GitHub Pages).
2. Clicca Carica export e seleziona il file .xlsx.
3. I KPI si aggiornano immediatamente.

Aggiungere una survey manuale

• Seleziona agente, data e voto (1–5), poi Aggiungi al totale team.
• Le survey manuali appaiono con il tag manuale nella lista e si possono eliminare.
• Se inserisci il numero Case, il sistema evita doppioni con il prossimo export.

Periodo

• YTD 2026: tutte le survey dell'anno corrente.
• Mese: filtra per mese specifico; usa il menu a tendina accanto.

Simulazione

• Impatto prossima survey: mostra come cambia il CSAT se prendi 1–3 oppure 4–5.
• Simulazione live: aggiungi pass/fail ipotetici con i pulsanti e vedi il risultato in tempo reale.
• Obiettivo: inserisci il target % e scopri quante 4/5 consecutive servono per raggiungerlo, o quante 1/2/3 per scenderci sotto.

Backup / Ripristino

• Esporta backup: scarica un file .json con tutti i dati (base + manuali + mercati).
• Importa backup: carica un backup precedente per ripristinare i dati.

---

Vista Mercati

Il pulsante Carica file rileva in automatico il tipo di file dalle intestazioni:

Tipo file	Colonne chiave	Cosa fa
CSAT1 (Team)	Number Value + Created By: Full Name	Popola la vista Team
Dettaglio mercati	ISO + CSAT score	Una riga per survey; categoria testuale → voto 1–5
Riepilogo mercati	Market + Comp rate	Una riga per paese con KPI aggregati

Mappa categorie (dettaglio mercati)

Testo Salesforce	Voto
Very Satisfied	5
Satisfied	4
Neither satisfied nor dissatisfied	3
Not satisfied	2
Not satisfied at all	1

Come usare la vista Mercati

1. Carica il riepilogo mercati (.xlsx) → appare la tabella paesi ordinata per CSAT.
2. Carica il dettaglio mercati → si sblocca il trend mensile, il drill-down per canale e la lista survey.
3. Clicca su un paese nella tabella per aprire il dettaglio.
4. Il segno ✓ verde accanto al CSAT conferma che il valore ricalcolato dal dettaglio coincide con il riepilogo ufficiale.

Nota: il file mercati misura il paese intero. Per l'IT il conteggio sarà diverso da quello del Team (es. ~159 vs ~153 survey): è corretto, misurano perimetri diversi.

---

Metrica

CSAT% = (survey con voto 4 o 5) / (totale survey) × 100

Arrotondato a 1 decimale. Nessun punteggio per singolo agente nella vista Team: si monitora solo il team.
Nella vista Mercati il CSAT è a livello-paese (nessun dato per agente).

---

Pubblicare su GitHub Pages

# 1. Crea un repository su GitHub (es. "csat-team"), poi:
git remote add origin https://github.com/<tuo-username>/csat-team.git
git push -u origin main

# 2. Su GitHub → Settings → Pages:
#    Source: "Deploy from a branch"
#    Branch: main  /  (root)
#    Save

# L'app sarà disponibile su:
# https://<tuo-username>.github.io/csat-team/

Importante: il .gitignore esclude già *.xlsx, *.xls, *.csv, data/, backups/ e i file csat-backup*.json.
Non committare mai file con dati reali di clienti o agenti.

---

Privacy

• Nessuna chiamata di rete con dati utente.
• Tutto elaborato localmente con JavaScript nel browser.
• I dati persistono in localStorage del browser; usa Esporta backup per spostarli tra dispositivi.
• Il codice sorgente (HTML/CSS/JS) non contiene dati reali.