HandyCafe Docs
owner it-admin

Caffetteria

Caffetteria è il modulo integrato per il servizio di cibo e bevande in HandyCafe. Ti consente di creare un piano tavoli digitale, pubblicare un menu self-service con marchio sul web all'indirizzo handy.cafe/{your-slug} e monitorare ogni ordine in arrivo in tempo reale dalla dashboard del server.

I clienti scansionano il codice QR sul loro tavolo, inseriscono un codice di sicurezza a 6 cifre, consultano il menu nella loro lingua e effettuano un ordine. L'ordine appare sullo schermo Ordini della Caffetteria entro pochi secondi. Il tuo staff conferma ogni fase della preparazione e, quando il servizio è completo, l'azione "Chiudi Conto" chiude il conto in un solo passaggio.

A Chi È Rivolto

Caffetteria è progettato per internet cafe, centri gaming e arene esports che servono anche cibo e bevande ai posti dei clienti. Sostituisce i biglietti d'ordine cartacei e le richieste verbali al bancone. Funziona insieme al sistema di sessione e prezzi standard di HandyCafe; gli ordini della Caffetteria sono tracciati separatamente ma sulla stessa licenza del cafe.

Capacità Principali

Capacità Sommario
Piano tavoli Editor visivo per più piani. Trascina i tavoli in posizione, passa alla vista 3D, segna i tavoli fuori servizio.
Tavoli Configura il numero di posti per tavolo, forma, dimensione (da 1 a 10) e codice di visualizzazione. Genera codici QR e ruotali su richiesta.
Menu Categorie con icone MDI, prodotti con foto, descrizioni in markdown, liste di ingredienti e gruppi di varianti (ad esempio Dimensione, Condimenti).
Ordini Dashboard live con polling ogni 3 secondi, badge conteggio in sospeso, notifiche desktop e audio, stato per ordine e per articolo.
Chiusura conto Azione di chiusura conto con un clic che regola tutti gli ordini aperti su un tavolo con un metodo di pagamento scelto.
Menu clienti Menu web con marchio in 24 lingue su handy.cafe/{slug}, con tema chiaro e scuro e lingua predefinita in base al dispositivo.
Pagamento online Integrazione opzionale con Stripe Checkout per il pagamento all'ordine, con un'alternativa al pagamento in contanti al tavolo.
Stampante Stampante di ricevute TCP opzionale con taglio automatico e stampa automatica su nuovi ordini.

Dove Si Trova Caffetteria nell'Interfaccia del Server

Caffetteria ha due punti di accesso:

  1. Sezione Caffetteria nella barra laterale. Questo è lo spazio operativo per l'uso quotidiano. Contiene cinque schede: Tavoli, Piano Tavoli, Menu, Ordini e Programma. La scheda Ordini mostra un badge in sospeso ogni volta che ci sono nuovi ordini in attesa.
  2. Impostazioni > Caffetteria. Questa è l'area di configurazione. Contiene il profilo aziendale (slug, nome visualizzato, logo, immagine di intestazione, indirizzo, valuta, fuso orario), impostazioni della stampante, gestione dei piani e attivazione di funzionalità opzionali.

Configurazione di un Cafe

Quando abiliti Caffetteria per la prima volta, il server utilizza automaticamente la tua licenza HandyCafe come token di autorizzazione. Non devi incollare nulla manualmente. Il wizard di configurazione richiede quindi quattro informazioni:

  1. Slug. Questo diventa l'URL pubblico su handy.cafe/{slug}. I caratteri consentiti sono lettere minuscole, numeri e trattini. Lo slug è da 3 a 62 caratteri. Il sistema verifica la disponibilità in tempo reale e rifiuta gli slug riservati come "admin", "api" o "dashboard".
  2. Nome visualizzato. Il nome leggibile mostrato in cima al menu clienti.
  3. Paese e valuta. La valuta predefinita per i prezzi del menu. I prezzi sono memorizzati in unità minori (ad esempio centesimi) e visualizzati con il simbolo della valuta configurata.
  4. Fuso orario. Utilizzato per i calcoli dinamici dei tempi di preparazione, i timestamp sugli ordini e i registri di chiusura.

Dopo il completamento della configurazione, il cafe viene creato nel database cloud e si apre lo spazio di lavoro Caffetteria. Puoi quindi aggiungere piani, tavoli e articoli del menu.

Profilo Aziendale

Il profilo aziendale è modificabile in qualsiasi momento sotto Impostazioni > Caffetteria. Campi chiave:

Campo Scopo
Slug Segmento dell'URL pubblico. Cambiare lo slug interrompe i codici QR esistenti fino a quando non vengono rigenerati.
Nome Visualizzato Mostrato in cima al menu clienti.
Logo Immagine quadrata. Consigliato WebP fino a 2 MB.
Immagine di Intestazione Immagine banner larga in cima al menu clienti. Consigliato WebP fino a 2 MB.
Indirizzo e Telefono Opzionale. Mostrato nel piè di pagina del menu.
Valuta Applicata a ogni prezzo di prodotto nel menu.
Paese Utilizzato per le tasse e le impostazioni regionali predefinite.
Fuso Orario Applicato ai timestamp di ordini e chiusure.
Mostra Tempo di Preparazione nel Menu Interruttore. Quando attivo, ogni prodotto mostra un chip con il tempo di preparazione stimato.

Impostazioni della Stampante

La sezione stampante accetta la seguente configurazione:

  • Tipo. Disabilitato o TCP. La stampa diretta USB non è supportata in questa versione.
  • IP e Porta. L'indirizzo di rete della tua stampante di ricevute. La maggior parte delle stampanti ESC POS TCP ascolta sulla porta 9100.
  • Taglio Automatico. Aggiunge il comando di taglio carta dopo ogni ricevuta stampata.
  • Stampa Automatica su Nuovo Ordine. Quando attivo, ogni ordine in arrivo attiva automaticamente la stampa di una ricevuta.
  • Notifica Sonora. Riproduce un avviso audio oltre alla notifica desktop quando arriva un nuovo ordine.
  • Stampa di Prova. Invia una ricevuta di esempio alla stampante configurata per verificare la connessione.

Sommario dell'Architettura

Caffetteria utilizza un modello di dati cloud-first. Ogni tavolo, categoria, prodotto, ordine e registro di chiusura è memorizzato nel database cloud di handy.cafe. Il tuo server locale HandyCafe rispecchia questo stato e interroga l'endpoint Ordini ogni 3 secondi per nuove attività. Le pagine rivolte ai clienti sono servite direttamente dal cloud di handy.cafe; non richiedono che il tuo server sia raggiungibile da internet.

Poiché i dati risiedono nel cloud:

  • I codici QR continuano a funzionare anche quando il server è offline, ma il personale non può vedere gli ordini sulla dashboard fino al ritorno della connettività.
  • Le modifiche al menu vengono inviate a handy.cafe entro pochi secondi dal salvataggio.
  • Gli ordini effettuati dai clienti raggiungono la dashboard Ordini dopo il successivo polling di 3 secondi.

Prossimi Passi