Dashboard

La Dashboard è la schermata principale di CADrivit: offre una visione d'insieme dell'attività aziendale, le metriche chiave, i task in sospeso e le scorciatoie per le operazioni più frequenti.

Come accedere

• Menu: voce "Dashboard" nella barra di navigazione laterale
• Indirizzo: /dashboard
• Chi può usarla: Amministratore e Utente

Interfaccia

La pagina è composta da otto sezioni disposte verticalmente nell'ordine descritto qui sotto (alcune sono condizionali e compaiono solo in determinate circostanze).

Intestazione di benvenuto

Mostra un saluto personalizzato con il nome dell'utente e un sottotitolo descrittivo. Se sono presenti ordini in stato attivo (non ancora consegnati né annullati), appare un pulsante evidenziato in arancione "N ordini attivi" che porta direttamente alla pagina degli ordini.

Checklist di avvio (Onboarding)

Presente finché non sono completati tutti i passaggi iniziali. Mostra:

• Una barra di avanzamento con il conteggio dei passi completati sul totale.
• Un elenco di attività con spunta verde (completate) o cerchio vuoto (da fare):
  • Profilo azienda — configura logo e dati aziendali (/account/branding).
  • Primo profilo prodotto — aggiungi un profilo finestra o serramento nell'inventario (/inventory).
  • Primo cliente — registra il primo cliente (/clients?new=1).
  • Primo preventivo — crea il primo preventivo (/quote-builder?new=1).
  • Invita il team — aggiungi altri utenti (/team).
• Pulsante "Riapri procedura guidata" per tornare all'onboarding wizard.
• Pulsante × per nascondere la checklist in modo permanente.

Il rilevamento automatico vale solo per i passi "Primo profilo prodotto", "Primo cliente" e "Primo preventivo": vengono marcati completati se esiste già almeno un record corrispondente nel sistema. I passi "Profilo azienda" e "Invita il team" si considerano completati esclusivamente se svolti tramite la procedura guidata; non vengono rilevati automaticamente.

Quando tutti i passi sono completati o il banner è stato chiuso, la sezione scompare automaticamente.

Bozze in sospeso

Appare solo se esistono preventivi salvati in bozza. Elenca fino a tre bozze, ciascuna con:

• Titolo del preventivo.
• Nome del cliente associato (o "Nessun cliente" se assente).
• Numero di righe prodotto.
• Tempo trascorso dall'ultimo salvataggio (es. "5 minuti fa", "2 giorni fa").

L'intera riga è cliccabile e apre il preventivo nel costruttore (/quote-builder?editId=<id>). L'etichetta "Riprendi" presente nella riga è un elemento decorativo, non un pulsante separato.

Il pulsante × in alto a destra nasconde il pannello per la sessione corrente.

Task

Riquadro per la gestione delle attività interne del team. Contiene:

• Campo di testo per aggiungere rapidamente un nuovo task (premere Invio per salvare).
• Elenco dei task aperti assegnati all'utente corrente, con casella di spunta per segnarli completati e icona per modificarli o eliminarli.
• Link "Vedi tutti" che porta alla pagina completa /tasks.
• Navigazione pagina precedente / pagina successiva quando i task superano la dimensione della pagina del widget.

KPI aziendali

Striscia di cinque schede metriche. Ogni scheda mostra il valore principale, un indicatore di tendenza rispetto al mese precedente (freccia su/giù) e un link alla sezione correlata.

Metrica	Descrizione	Link
Preventivi totali	Numero complessivo di preventivi nel sistema	/quotes
Fatturato approvato	Somma totale dei preventivi in stato "Approvato" (€)	/quotes?status=Approved
Clienti	Numero totale di clienti registrati; il trend indica i nuovi nell'ultima settimana	/clients
Media €/m²	Prezzo medio per metro quadro su tutti i preventivi approvati con superficie calcolata	—
Margine medio	Margine lordo percentuale medio sui preventivi approvati con dati di costo; verde ≥ 20%, rosso < 0%	—

Le metriche "Fatturato approvato" e "Media €/m²" mostrano — se non ci sono ancora preventivi approvati con i dati necessari.

Pipeline vendite

Quattro riquadri cliccabili che mostrano il conteggio dei preventivi per stato:

Stato	Colore indicatore
Bozza	Grigio
Inviato	Blu
Approvato	Verde
Rifiutato	Rosso

Ogni riquadro è un collegamento che apre la lista preventivi filtrata per quello stato (/quotes?status=<Stato>).

Azioni rapide

Quattro scorciatoie per le operazioni più comuni:

Azione	Destinazione
Nuovo preventivo (evidenziato)	/quote-builder
Pipeline preventivi	/quotes
Ordini	/orders
Catalogo prodotti	/inventory

Preventivi recenti

Tabella con gli ultimi sei preventivi creati, ordinati dal più recente. Per ciascuno sono visibili:

• Titolo del preventivo.
• Nome del cliente (o "Nessun cliente").
• Data di creazione.
• Badge di stato colorato (Bozza, Inviato, Approvato, Rifiutato).
• Totale in euro.

Ogni riga è cliccabile e apre il dettaglio del preventivo. Il pulsante "Vedi tutti →" porta alla pagina /quotes.

Se non esiste ancora nessun preventivo, appare un messaggio vuoto con il pulsante "Crea il tuo primo preventivo".

Operazioni

Aggiungere un task dalla Dashboard

1. Individua il riquadro Task.
2. Digita il titolo del task nel campo in alto.
3. Premi Invio o clicca il pulsante di conferma.
4. Il task appare immediatamente nell'elenco.

Segnare un task come completato

1. Nel riquadro Task, clicca la casella di spunta a sinistra del task.
2. Il task viene rimosso dalla lista del widget (spostato nello stato "completato").

Modificare o eliminare un task

1. Nel riquadro Task, clicca l'icona di modifica a destra del task.
2. Si apre la finestra di modifica: aggiorna titolo, descrizione o scadenza e salva. Per eliminare usa il pulsante "Elimina" nella stessa finestra.

Riprendere una bozza

1. Nel pannello Bozze in sospeso, individua la bozza desiderata.
2. Clicca la riga (l'intera riga è cliccabile).
3. Il costruttore di preventivi si apre con la bozza caricata.

Completare l'onboarding

1. Nella Checklist di avvio, clicca il passo da completare.
2. Esegui l'operazione nella pagina di destinazione (es. aggiungi un cliente).
3. Torna alla Dashboard: il passo appare con spunta verde.
4. Una volta completati tutti i passi la checklist scompare automaticamente.

Stati e messaggi

• Pulsante "N ordini attivi" — arancione, visibile solo se ci sono ordini in stato attivo. Sparisce quando tutti gli ordini sono consegnati o annullati.
• Checklist di avvio — appare solo se l'onboarding non è ancora completato e non è stato chiuso manualmente.
• Pannello bozze — appare solo se esistono preventivi in stato bozza; scompare se chiuso con × (per la sessione corrente).
• Stato vuoto preventivi recenti — se non esistono preventivi, mostra un messaggio informativo con call-to-action per crearne uno.

Note e limiti

• I dati dei KPI sono calcolati lato server al caricamento della pagina. I valori si aggiornano riaprendo o navigando verso la Dashboard; alcuni eventi di sistema possono innescare un aggiornamento automatico della pagina.
• La Media €/m² e il Margine medio richiedono che i preventivi approvati abbiano rispettivamente la superficie calcolata e i dati di costo compilati.
• Il widget Task mostra solo i task in stato "aperto" (non completati); per visualizzare tutti i task — inclusi quelli completati o assegnati ad altri utenti — vai a /tasks.
• Sia Amministratore sia Utente vedono la stessa Dashboard; non ci sono sezioni riservate a un ruolo specifico all'interno di questa pagina.