HandyCafe Docs
owner it-admin

Cafenea

Cafenea este modulul integrat de servire a mâncării și băuturilor din HandyCafe. Vă permite să construiți un plan digital al meselor, să publicați pe web un meniu de autoservire cu brandul dvs. la adresa handy.cafe/{your-slug} și să urmăriți în timp real fiecare comandă primită din panoul serverului.

Clienții scanează codul QR de la masă, introduc un cod de securitate din 6 cifre, răsfoiesc meniul în propria limbă și plasează comanda. Comanda apare pe ecranul Cafenea Orders în câteva secunde. Personalul dvs. confirmă fiecare etapă de preparare, iar când serviciul este finalizat acțiunea "Settle Check" închide nota dintr-un singur pas.

Pentru cine este

Cafenea este conceput pentru internet cafe-uri, centre de gaming și arene de esports care servesc și mâncare și băuturi la masa clientului. Înlocuiește bonurile de comandă pe hârtie și solicitările verbale la tejghea. Funcționează împreună cu sistemul standard HandyCafe pentru sesiuni și tarifare; comenzile Cafenea sunt urmărite separat, dar pe aceeași licență a cafenelei.

Capabilități de bază

Capacitate Rezumat
Plan de sală Editor vizual pentru mai multe etaje. Trageți mesele în poziție, comutați la vedere 3D, marcați mesele ca scoase din uz.
Mese Configurați pentru fiecare masă numărul de locuri, forma, dimensiunea (1 până la 10) și codul afișat. Generați coduri QR și rotiți-le la cerere.
Meniu Categorii cu pictograme MDI, produse cu fotografii, descrieri în Markdown, liste de ingrediente și grupuri de variante (de exemplu mărime, toppinguri).
Comenzi Panou live cu polling la 3 secunde, insignă pentru comenzi în așteptare, notificări pe desktop și audio, stare per comandă și per articol.
Decontare Acțiune de închidere a notei cu un singur clic, care decontează toate comenzile deschise de la o masă cu metoda de plată aleasă.
Meniu client Meniu web cu brand în 24 de limbi la handy.cafe/{slug}, cu temă deschisă și închisă și limba implicită adaptată dispozitivului.
Plată online Integrare opțională Stripe Checkout pentru plată la comandă, cu alternativă cash la masă.
Imprimantă Imprimantă de bonuri TCP opțională, cu auto-cut și auto-print la comenzile noi.

Unde se află Cafenea în Server UI

Cafenea are două puncte de intrare:

  1. Secțiunea Cafenea din bara laterală. Acesta este spațiul operațional pentru utilizarea zilnică. Conține cinci tab-uri: Tables, Floor Plan, Menu, Orders și Schedule. Tab-ul Orders afișează o insignă de așteptare ori de câte ori există comenzi noi.
  2. Settings > Cafenea. Aceasta este zona de configurare. Aici se află profilul afacerii (slug, nume afișat, logo, imagine antet, adresă, monedă, fus orar), setările imprimantei, administrarea etajelor și comutatoarele pentru funcțiile opționale.

Provisionarea unei cafenele

Când activați Cafenea pentru prima dată, serverul folosește automat licența HandyCafe drept token de autorizare. Nu trebuie să lipiți nimic manual. Asistentul de provisionare cere apoi patru informații:

  1. Slug. Acesta devine URL-ul public la handy.cafe/{slug}. Sunt permise litere mici, cifrele și cratimele. Slug-ul are între 3 și 62 de caractere. Sistemul verifică disponibilitatea în timp real și respinge slug-urile rezervate precum "admin", "api" sau "dashboard".
  2. Nume afișat. Numele lizibil pentru oameni, afișat în partea de sus a meniului pentru clienți.
  3. Țara și moneda. Moneda implicită pentru prețurile din meniu. Prețurile sunt stocate în unități minore (de exemplu cenți) și afișate cu simbolul monedei configurat.
  4. Fus orar. Folosit pentru calculele dinamice ale timpului de preparare, marcajele temporale ale comenzilor și înregistrările de decontare.

După finalizarea provisionării, cafeneaua este creată în baza de date cloud și se deschide spațiul de lucru Cafenea. Apoi puteți adăuga etaje, mese și produse din meniu.

Profilul afacerii

Profilul afacerii poate fi editat oricând din Settings > Cafenea. Câmpuri cheie:

Câmp Scop
Slug Segmentul public al URL-ului. Schimbarea slug-ului rupe codurile QR existente până când sunt regenerate.
Nume afișat Afișat în partea de sus a meniului pentru clienți.
Logo Imagine pătrată. Se recomandă WebP de până la 2 MB.
Imagine antet Banner lat în partea de sus a meniului pentru clienți. Se recomandă WebP de până la 2 MB.
Adresă și telefon Opțional. Afișate în subsolul meniului.
Monedă Aplicată fiecărui preț din meniu.
Țara Folosită pentru taxe și setările regionale implicite.
Fus orar Aplicat marcajelor temporale ale comenzilor și decontărilor.
Afișează timpul de preparare în meniu Comutator. Când este activ, fiecare produs afișează un indicator cu timpul estimat de preparare.

Setările imprimantei

Secțiunea imprimantei acceptă următoarea configurare:

  • Kind. Disabled sau TCP. Imprimarea directă prin USB nu este suportată în această versiune.
  • IP și Port. Adresa de rețea a imprimantei de bonuri. Majoritatea imprimantelor ESC POS TCP ascultă pe portul 9100.
  • Auto Cut. Adaugă comanda de tăiere a hârtiei după fiecare bon imprimat.
  • Auto Print on New Order. Când este activ, fiecare comandă nouă declanșează automat tipărirea unui bon.
  • Sound Notification. Redă o alertă audio în plus față de notificarea desktop atunci când apare o comandă nouă.
  • Test Print. Trimite un bon de probă la imprimanta configurată pentru a verifica conexiunea.

Rezumatul arhitecturii

Cafenea folosește un model de date cloud-first. Fiecare masă, categorie, produs, comandă și înregistrare de decontare este stocată în baza de date cloud handy.cafe. Serverul local HandyCafe oglindește această stare și interoghează endpoint-ul Orders la fiecare 3 secunde pentru activitate nouă. Pagini destinate clientului sunt servite direct de cloud-ul handy.cafe; ele nu necesită ca serverul dvs. să fie accesibil din internet.

Pentru că datele se află în cloud:

  • Codurile QR continuă să funcționeze chiar și când serverul este offline, dar personalul nu poate vedea comenzile în panou până revine conexiunea.
  • Modificările de meniu se propagă în handy.cafe în câteva secunde de la salvare.
  • Comenzile plasate de clienți ajung în panoul Orders după următorul polling de 3 secunde.

Pașii următori