Pianta e Tavoli

L'editor della Pianta è una tela visiva per disporre i tuoi tavoli. La pagina Tavoli è una vista operativa per tavolo che offre dettagli e azioni. Entrambe le schermate lavorano sugli stessi record di tavoli sottostanti.

Piani

I piani raggruppano i tavoli per posizione fisica, ad esempio "Sala Principale", "Soppalco" o "Patio Esterno". Puoi creare e gestire i piani da Impostazioni > Caffetteria.

Ogni caffetteria necessita di almeno un piano. I tavoli sono sempre assegnati a un solo piano. Puoi riordinare i piani con i controlli sposta su e sposta giù, e il piano in cima diventa quello predefinito quando si apre la scheda Pianta. La pagina Pianta offre anche un'opzione "Tutti i piani" che mostra ogni tavolo in una vista combinata.

Editor della Pianta

L'editor della Pianta si rende su una tela di 1200 per 720 con una griglia di 10 pixel. I tavoli appaiono come forme nelle loro posizioni memorizzate. L'editor supporta due modalità di visualizzazione:

Modalità	Usala per
2D	Modifica e disposizione. Trascina i tavoli, aggiungi o rimuovi, rinomina.
3D	Presentazioni e walkthrough. La tela si inclina usando la prospettiva CSS per produrre una vista dimetrica in stile architettonico. Il trascinamento è disabilitato in modalità 3D perché il mapping del puntatore è ambiguo su una tela inclinata.

Aggiunta e Posizionamento dei Tavoli

Apri Caffetteria > Pianta.
Seleziona il piano di destinazione dai pulsanti dei piani in alto.
Clicca su Aggiungi Tavolo. Un nuovo tavolo appare all'origine della tela con forma, dimensioni e numero di posti predefiniti.
Trascina il corpo del tavolo nella posizione desiderata. La posizione viene salvata automaticamente quando rilasci il pulsante del mouse.
Ripeti per ogni gruppo di posti.

Le posizioni si agganciano a una griglia di 10 pixel in modo che i tavoli allineati risultino ordinati senza richiedere un posizionamento al pixel.

Proprietà del Tavolo

Ogni tavolo ha i seguenti campi modificabili:

Campo	Significato
Codice	Breve identificativo stampato sul QR e visibile al personale. Deve essere univoco all'interno della tua caffetteria.
Nome Visualizzato	Etichetta più lunga mostrata al personale, ad esempio "Finestra 3" o "Cabina A".
Numero di Posti	Numero di posti al tavolo. Il predefinito è 2.
Forma	Una delle seguenti: quadrato, rettangolo orizzontale, rettangolo verticale, rotondo.
Dimensione	Intero da 1 a 10. Controlla la dimensione di rendering nell'editor e nella vista 3D.
Piano	Il piano a cui appartiene questo tavolo. I tavoli possono essere spostati tra i piani modificando questo campo.
Stato	libero, in_uso, o fuori_servizio.

Stati del Tavolo

Stato	Significato
libero	Nessuna sessione attiva. Nessun cliente può effettuare un ordine finché non viene fatto accomodare.
in_uso	È attivo un codice di sicurezza. Il cliente può scansionare il QR e ordinare.
fuori_servizio	Il tavolo non è disponibile. Appare attenuato sulla pianta e la pagina QR mostra un avviso di non disponibilità. Utile per manutenzione o riparazione mobili.

Fare Accomodare un Cliente

Per accettare ordini da un tavolo, il personale deve far accomodare il cliente. Fare accomodare emette un codice di sicurezza e sposta il tavolo nello stato in_uso.

Nella pagina Tavoli o dal menu azioni della Pianta, seleziona il tavolo.
Clicca su Fare Accomodare il Cliente (anche etichettato "Apri Tavolo").
Il sistema genera un codice di sicurezza a 6 cifre e lo visualizza.
Consegnare il codice al cliente. Lo digita dopo aver scansionato il QR.

Il codice è mostrato in testo semplice solo al momento della generazione e quando un amministratore apre la finestra Mostra Codice per un tavolo già occupato. È hashato lato server. Il codice scade dopo una durata predefinita e può essere ruotato o resettato in qualsiasi momento.

Mostrare e Ruotare il Codice

Mostra Codice. Visualizza il codice in testo semplice attualmente memorizzato per il tavolo aperto. Utile quando il cliente non ha colto il numero la prima volta. Questa azione non ruota il codice e non invalida il QR precedente.
Ruota QR. Genera un nuovo token QR per il tavolo. L'adesivo QR precedente diventa invalido. Usalo quando ristampi l'adesivo o quando sospetti che il vecchio QR sia stato condiviso esternamente.

Chiudere un Tavolo

Quando un cliente se ne va senza un conto in sospeso, clicca su Chiudi Tavolo. Il codice di sicurezza scade immediatamente, il tavolo torna a libero e qualsiasi ulteriore tentativo di scansione richiede un nuovo accomodamento.

Se ci sono ordini non pagati sul tavolo, usa invece Regola Conto. La regolazione chiude tutti gli ordini aperti con un metodo di pagamento scelto e poi riporta il tavolo a libero. Vedi la pagina Ordini per il flusso di regolazione.

Codici QR

Ogni tavolo ha un codice QR che codifica l'URL handy.cafe/{cafe-slug}/{table-code}. Un parametro di query trasporta il token QR che dimostra che l'adesivo è autentico. Quando il cliente scansiona il QR:

La pagina del menu risolve lo slug e il codice tavolo tramite l'API cloud.
Se il tavolo è nello stato in_uso, al cliente viene richiesto il codice di sicurezza a 6 cifre.
Al controllo riuscito, viene emesso un token di sessione e memorizzato in un cookie e in un token Bearer di riserva. Il fallback Bearer esiste perché Safari su iPhone può bloccare i cookie di terze parti in alcune configurazioni.

Genera il QR stampabile dalla pagina Tavoli. Ogni tavolo ha un'anteprima QR che puoi salvare come SVG o PNG. Ristampa gli adesivi ogni volta che ruoti il token QR o cambi lo slug.

Consigli per Progettare una Pianta

Inizia mappando la disposizione reale sulla tela. Posiziona l'ingresso vicino a un bordo e lavora verso l'interno. Questo facilita l'orientamento del personale.
Raggruppa i tavoli per piano anche se il tuo locale ha un solo livello. "Sala" e "Terrazza" come piani separati ti permettono di filtrare la dashboard degli ordini per area.
Usa valori di Dimensione maggiori per cabine che ospitano quattro o più persone e valori minori per sgabelli al bancone.
Segna i tavoli fuori_servizio quando i mobili necessitano di riparazione in modo che i clienti non possano effettuare ordini su di essi. Non eliminare il record del tavolo a meno che il posto non sia andato via permanentemente.