HandyCafe Docs
owner it-admin

Come Configurare la Caffetteria

Questa guida illustra la configurazione completa del modulo Caffetteria. Alla fine avrai un menu clienti pubblicato su handy.cafe/{your-slug}, una piantina con almeno un tavolo funzionante, un menu con prodotti e un ordine di prova effettuato con successo.

Cosa Ti Serve

  • Una licenza HandyCafe attiva. L'autenticazione della Caffetteria utilizza automaticamente la licenza; non devi inserire manualmente una chiave.
  • Connessione internet sul server. La Caffetteria è cloud-first, quindi il provisioning, la sincronizzazione del menu e il polling degli ordini richiedono accesso in uscita all'API cloud.
  • Uno slug che desideri utilizzare per l'URL del menu pubblico. I caratteri consentiti sono lettere minuscole, numeri e trattini. La lunghezza è da 3 a 62 caratteri.
  • Opzionale: un logo e un'immagine di intestazione. Il formato consigliato è WebP fino a 2 MB.
  • Opzionale: una stampante di ricevute TCP sulla rete locale.

Passo 1: Abilitare la Caffetteria

  1. Apri il Server HandyCafe.
  2. Vai su Impostazioni nella barra laterale.
  3. Apri la scheda Caffetteria.
  4. Attiva Abilita Caffetteria.
  5. Il server contatta l'API cloud utilizzando la tua licenza come token di autorizzazione. Se ha successo, si apre la Procedura Guidata di Provisioning.

Risultato atteso: Viene visualizzata la schermata della Procedura Guidata di Provisioning. Se vedi un errore relativo alla licenza o alla connettività, controlla la tua connessione internet e conferma che la tua licenza HandyCafe sia attiva.

Passo 2: Configura il Tuo Café

La procedura guidata richiede quattro campi.

  1. Slug. Digita il suffisso URL desiderato. L'indicatore di disponibilità si aggiorna entro un secondo. Se lo slug è già preso o riservato, scegline un altro.
  2. Nome Visualizzato. Il nome leggibile mostrato in cima al menu clienti, ad esempio "Atilla's Gaming Lounge".
  3. Paese e Valuta. Seleziona il paese in cui opera il café. La valuta predefinita si basa sul paese e può essere modificata.
  4. Fuso Orario. Seleziona il fuso orario per i timestamp degli ordini e dei pagamenti.
  5. Clicca su Crea Café.

Risultato atteso: La procedura guidata si chiude e si apre l'area di lavoro della Caffetteria. Il tuo URL pubblico handy.cafe/{slug} è ora attivo, anche se il menu è vuoto.

Passo 3: Compila il Profilo Aziendale

  1. Sempre sotto Impostazioni > Caffetteria, scorri fino alla sezione Profilo Aziendale.
  2. Carica un Logo (immagine quadrata).
  3. Carica un'Immagine di Intestazione (banner largo).
  4. Inserisci l'Indirizzo e il Telefono da visualizzare nel piè di pagina del menu clienti.
  5. Attiva o disattiva Mostra Tempo di Preparazione nel Menu a seconda che tu voglia che i clienti vedano i tempi di preparazione stimati.
  6. Clicca su Salva.

Risultato atteso: Il logo e l'intestazione appaiono in un'anteprima. Visitando handy.cafe/{slug} in un browser ora viene mostrata l'intestazione con il marchio ma ancora contenuti vuoti.

Passo 4: Crea i Piani

  1. In Impostazioni > Caffetteria, trova la sezione Piani.
  2. Clicca su Aggiungi Piano e assegnagli un nome (ad esempio "Sala Principale").
  3. Aggiungi piani aggiuntivi se il tuo locale ha più aree (ad esempio "Soppalco", "Patio Esterno").
  4. Riordina i piani con i pulsanti sposta su e sposta giù. Il piano in cima diventa quello predefinito nell'editor della Piantina.

Risultato atteso: I tuoi piani appaiono nell'elenco. La scheda Caffetteria > Piantina ora mostra i pulsanti dei piani in alto.

Passo 5: Costruisci la Piantina

  1. Apri Caffetteria > Piantina.
  2. Seleziona il primo piano dai pulsanti.
  3. Clicca su Aggiungi Tavolo. Un tavolo quadrato appare all'origine della tela.
  4. Trascina il tavolo nella posizione desiderata. Rilascia per salvare.
  5. Clicca sul tavolo per aprire il pannello delle proprietà. Configura:
    • Codice (ad esempio "T1", "Finestra 3").
    • Nome Visualizzato (etichetta più lunga opzionale).
    • Numero di Posti.
    • Forma (quadrato, rettangolo orizzontale, rettangolo verticale o rotondo).
    • Dimensione (da 1 a 10).
  6. Ripeti per ogni tavolo nel piano.
  7. Facoltativamente passa alla vista 3D per rivedere il layout da una prospettiva architettonica.

Risultato atteso: La tua piantina rende tutti i tavoli nelle loro posizioni reali. Il trascinamento è disabilitato nella vista 3D; torna alla 2D per spostare i tavoli.

Passo 6: Costruisci il Menu

  1. Apri Caffetteria > Menu.
  2. Clicca su Aggiungi Categoria. Inserisci un nome e scegli un'icona MDI dal selettore di icone. Clicca su Salva.
  3. Ripeti per ogni categoria (ad esempio "Bevande Calde", "Bevande Fredde", "Hamburger", "Dolci").
  4. All'interno di una categoria, clicca su Aggiungi Prodotto. Inserisci:
    • Nome.
    • Descrizione (supporto Markdown).
    • Linea Ingredienti.
    • Prezzo Base.
    • Aliquota IVA.
    • Tempo di Preparazione (valore statico di fallback).
    • Opzionale: Etichetta unità, Flag Traccia Stock, Quantità in Stock.
  5. Carica una Foto del prodotto. È accettato qualsiasi formato; WebP fino a 2 MB è consigliato.
  6. Clicca su Salva.
  7. Se il prodotto ha delle scelte, scorri fino alla sezione Varianti e clicca su Aggiungi Variante. Crea una riga per ogni opzione con il suo delta di prezzo. Attiva Obbligatorio se il cliente deve sceglierne una.
  8. Ripeti per ogni prodotto nel tuo menu.

Risultato atteso: Il menu clienti su handy.cafe/{slug} ora mostra le tue categorie e prodotti. Visitalo in un browser per verificare.

Passo 7: Configura la Stampante (Opzionale)

  1. Sempre sotto Impostazioni > Caffetteria, scorri fino a Impostazioni Stampante.
  2. Imposta Tipo su TCP.
  3. Inserisci l'IP e la Porta della stampante. La maggior parte delle stampanti ESC POS TCP ascolta sulla porta 9100.
  4. Abilita Taglio Automatico se la stampante lo supporta.
  5. Abilita Stampa Automatica su Nuovo Ordine per attivare una stampa per ogni ordine in arrivo.
  6. Abilita Notifica Sonora per un avviso audio insieme alla notifica desktop.
  7. Clicca su Test Stampa. Una ricevuta di prova dovrebbe stampare entro pochi secondi.

Risultato atteso: La ricevuta di prova viene stampata con successo. Se non stampa nulla, verifica l'IP, la porta e che la stampante sia sulla stessa rete locale del server.

Passo 8: Assegna un Tavolo e Effettua un Ordine di Prova

  1. Apri Caffetteria > Tavoli (o utilizza il menu azioni della Piantina).
  2. Scegli un tavolo e clicca su Assegna Cliente (anche etichettato "Apri Tavolo").
  3. Nota il codice di sicurezza a 6 cifre visualizzato. Annotalo o lascia aperto il dialogo.
  4. Su un telefono, naviga su handy.cafe/{slug}/{table-code}. Puoi anche scansionare il QR se hai un adesivo stampato.
  5. Inserisci il codice a 6 cifre.
  6. Sfoglia il menu e aggiungi un articolo al carrello.
  7. Procedi al checkout. Scegli Contanti come metodo di pagamento (l'impostazione di Stripe è opzionale e può essere aggiunta successivamente).
  8. Invia l'ordine.
  9. Sul server, passa a Caffetteria > Ordini.

Risultato atteso: Entro 3 secondi, una nuova scheda ordine appare sulla dashboard degli Ordini. Viene attivata una notifica desktop. Viene riprodotto un avviso audio se le notifiche sonore sono abilitate. Il badge del conteggio in sospeso incrementa nella scheda Ordini.

Passo 9: Avanza e Regola l'Ordine di Prova

  1. Sulla scheda ordine, clicca sul pulsante del prossimo stato. L'ordine passa da effettuato a confermato.
  2. Continua a cliccare per progredire attraverso in preparazione, pronto e servito.
  3. Nella pagina Tavoli, apri lo stesso tavolo e clicca su Regola Conto.
  4. Scegli Contanti come metodo di pagamento e conferma.

Risultato atteso: Il tavolo torna a libero. Il codice di sicurezza è scaduto. Viene creato un record di regolamento che può essere verificato successivamente.

Errori Comuni da Evitare

  • Saltare il profilo aziendale. I clienti vedono il nome visualizzato predefinito e un'area logo rotta se lanci prima di salvare il profilo.
  • Non ristampare i codici QR dopo i cambiamenti di slug. Cambiare lo slug invalida ogni QR esistente. Stampa nuovi adesivi e sostituiscili su ogni tavolo.
  • Pubblicare troppe categorie al lancio. Punta a 6-10 categorie di primo livello. I clienti navigano più velocemente quando il menu si adatta allo schermo.
  • Dimenticare di configurare la stampante prima del primo turno reale. Senza Stampa Automatica su Nuovo Ordine, il personale potrebbe perdere ordini durante un periodo intenso. Esegui sempre almeno una stampa di prova.
  • Lasciare abilitato il valore predefinito Mostra Tempo di Preparazione nel Menu senza una storia dinamica. Per i primi 30 giorni il valore statico è ciò che i clienti vedono. Imposta tempi statici realistici o disabilita la funzione fino a quando la stima dinamica non è stata addestrata.
  • Usare lo stesso dispositivo per test del personale e dei clienti. La sessione cliente persiste per 24 ore; se il tuo dispositivo di test è stato successivamente consegnato a un cliente, questi sarebbe già nel menu senza verifica. Cancella il dispositivo o usa un profilo browser pulito per i test.