Clienti

L'elenco clienti raccoglie tutte le anagrafiche dei tuoi acquirenti finali (privati o aziende). Da qui puoi creare, cercare, modificare ed eliminare clienti, e accedere alla scheda dettaglio con i preventivi e gli ordini collegati.

Come accedere

• Menu: Clienti
• Indirizzo: /clients
• Chi può usarla: Amministratore e Utente

Interfaccia

Barra superiore

• Pulsante "Aggiungi cliente" — apre il modulo di creazione in una finestra sovrapposta.
• Interruttore densità (in alto a destra del riquadro tabella) — alterna tra vista compatta e normale. La preferenza viene salvata automaticamente.

Campo di ricerca

Casella di testo con icona lente. Filtra la lista in tempo reale sui campi: nome, azienda, email, telefono. La ricerca è fuzzy: tollera piccoli errori di battitura e corrispondenze parziali. Il tasto / (barra obliqua) da tastiera sposta il cursore direttamente nel campo di ricerca.

Il filtro attivo viene rispecchiato nell'URL (?q=…) così da poter condividere o salvare la ricerca come segnalibro; il valore viene ripristinato quando si torna alla pagina con il pulsante Indietro del browser.

Tabella clienti (desktop)

Colonna	Descrizione
★ (preferiti)	Stella cliccabile per aggiungere/rimuovere il cliente dai preferiti. I clienti preferiti appaiono sempre in cima all'elenco quando non è attiva una ricerca.
Nome	Nome del cliente, cliccabile per aprire la scheda dettaglio. Affianco all'occhio per accedere direttamente al profilo.
Preventivi	Numero di preventivi collegati al cliente, mostrato come badge.
Azienda	Ragione sociale o nome dell'azienda (facoltativo).
Email	Indirizzo email (facoltativo).
Telefono	Numero di telefono (facoltativo).
Azioni	Pulsanti Modifica e Elimina.

Su dispositivi mobili la tabella si trasforma in schede verticali con gli stessi campi.

Operazioni

Creare un cliente

1. Clicca Aggiungi cliente in alto a destra.
2. Compila i campi nel modulo:
   • Nome (obbligatorio)
   • Azienda (facoltativo)
   • Email (facoltativo)
   • Telefono (facoltativo)
   • Indirizzo (facoltativo, campo testo libero)
3. Clicca Salva. Il cliente appare subito nell'elenco.

Modificare un cliente

1. Nella riga del cliente, clicca Modifica.
2. Aggiorna i campi desiderati.
3. Clicca Salva.

Eliminare un cliente

1. Nella riga del cliente, clicca il pulsante Elimina (icona cestino).
2. Conferma l'eliminazione nella finestra di dialogo.
3. Il cliente viene rimosso immediatamente dalla lista. Per i 4 secondi successivi compare un avviso in basso con il pulsante Annulla: cliccandolo il cliente viene ripristinato senza alcuna perdita di dati.

Eliminazione definitiva

Dopo i 4 secondi di undo l'eliminazione diventa definitiva. I preventivi già creati per quel cliente non vengono cancellati, ma il cliente non sarà più collegabile a nuovi preventivi.

Aggiungere/rimuovere dai preferiti

Clicca la stella (★) nella prima colonna della riga. La stella diventa dorata quando il cliente è tra i preferiti. I clienti preferiti vengono mostrati in cima all'elenco finché non è attiva una ricerca.

Scheda dettaglio cliente

Clicca sul nome del cliente (o sull'icona occhio) per aprire la scheda dettaglio all'indirizzo /clients/<id>.

Riepilogo KPI

Quattro riquadri in cima mostrano:

• Preventivi — numero totale di preventivi e valore complessivo in €.
• Approvati — valore totale dei soli preventivi con stato "Approvato".
• Ordini — numero di ordini confermati e relativo valore in €.
• Ultimo preventivo — data dell'ultimo preventivo creato.

Contatti e anagrafica

Riquadro con i campi: Azienda, Email, Telefono, Indirizzo. Clicca Modifica (in alto a destra nell'intestazione della scheda) per aggiornare i dati.

Preventivi collegati

Elenco degli ultimi 10 preventivi del cliente con: titolo (cliccabile), stato e importo. Il link Apri nell'elenco rimanda all'elenco preventivi già filtrato per questo cliente. Il pulsante Nuovo preventivo apre direttamente il costruttore di preventivi con il cliente pre-selezionato.

Ordini collegati

Elenco degli ultimi 10 ordini con: titolo, stato, data di consegna prevista e importo. Il link Apri nella bacheca rimanda alla sezione Ordini.

Stati e messaggi

Messaggio	Causa
Errore di caricamento con pulsante Riprova	Il server non ha risposto correttamente. Clicca Riprova per ricaricare l'elenco.
"Nessun cliente" (stato vuoto)	Non è ancora stato creato nessun cliente. Usa il pulsante nell'area vuota per creare il primo.
"Nessun risultato per <testo>"	La ricerca non ha trovato corrispondenze. Modifica o cancella il testo nel campo di ricerca.
Toast giallo "Cliente eliminato — Annulla"	Conferma dell'eliminazione con possibilità di undo entro 4 secondi.

Note e limiti

• I clienti sono condivisi tra tutti gli utenti dello stesso tenant; chiunque può crearne, modificarli o eliminarli.
• La ricerca fuzzy opera in locale sul dato già caricato: non è necessario premere Invio.
• L'elenco si aggiorna automaticamente in tempo reale se un altro utente del team crea o modifica un cliente mentre la pagina è aperta.
• La scheda dettaglio mostra al massimo 10 preventivi e 10 ordini in anteprima; usa i link "Apri nell'elenco" / "Apri nella bacheca" per vedere tutti i record.