HandyCafe Docs
owner it-admin

Cum configurați Cafenea

Acest ghid parcurge configurarea completă, de la zero, a modulului Cafenea. La final veți avea un meniu pentru clienți publicat la handy.cafe/{your-slug}, un plan de sală cu cel puțin o masă funcțională, un meniu cu produse și o comandă de test plasată cu succes.

Ce aveți nevoie

  • O licență HandyCafe activă. Autentificarea Cafenea folosește automat licența; nu introduceți manual nicio cheie.
  • Conectivitate la internet pe server. Cafenea este cloud-first, deci provisionarea, sincronizarea meniului și polling-ul comenzilor necesită acces outbound la API-ul cloud.
  • Un slug pe care vreți să îl folosiți pentru URL-ul public al meniului. Sunt permise literele mici, cifrele și cratimele. Lungimea este între 3 și 62 de caractere.
  • Opțional: logo și imagine de antet. Format recomandat: WebP până la 2 MB.
  • Opțional: o imprimantă TCP de bonuri în rețeaua locală.

Pasul 1: Activați Cafenea

  1. Deschideți HandyCafe Server.
  2. Navigați la Settings în bara laterală.
  3. Deschideți tab-ul Cafenea.
  4. Activați comutatorul Enable Cafenea.
  5. Serverul contactează API-ul cloud folosind licența dvs. drept token de autorizare. Dacă totul reușește, se deschide Provisioning Wizard.

Rezultat așteptat: Ecranul Provisioning Wizard apare. Dacă vedeți o eroare legată de licență sau conectivitate, verificați conexiunea la internet și confirmați că licența HandyCafe este activă.

Pasul 2: Provisionati cafeneaua

Asistentul cere patru câmpuri.

  1. Slug. Tastați sufixul dorit al URL-ului. Indicatorul de disponibilitate se actualizează în mai puțin de o secundă. Dacă slug-ul este deja folosit sau rezervat, alegeți altul.
  2. Display Name. Numele lizibil afișat în partea de sus a meniului clientului, de exemplu "Atilla's Gaming Lounge".
  3. Country and Currency. Alegeți țara în care funcționează cafeneaua. Moneda este setată implicit în funcție de țară și poate fi schimbată.
  4. Timezone. Alegeți fusul orar pentru marcajele temporale ale comenzilor și decontărilor.
  5. Dați clic pe Create Cafe.

Rezultat așteptat: Asistentul se închide și se deschide spațiul de lucru Cafenea. URL-ul public handy.cafe/{slug} este acum activ, deși meniul este gol.

Pasul 3: Completați profilul afacerii

  1. În continuare, în Settings > Cafenea, derulați până la secțiunea Business Profile.
  2. Încărcați un Logo (imagine pătrată).
  3. Încărcați o Header Image (banner lat).
  4. Introduceți Address și Phone pentru afișarea în subsolul meniului clientului.
  5. Activați sau dezactivați Show Prep Time on Menu în funcție de faptul dacă doriți ca clienții să vadă timpul estimat de preparare.
  6. Dați clic pe Save.

Rezultat așteptat: Logo-ul și antetul apar în previzualizare. Vizitarea handy.cafe/{slug} într-un browser afișează acum antetul branduit, dar conținutul rămâne gol.

Pasul 4: Creați etaje

  1. În Settings > Cafenea, găsiți secțiunea Floors.
  2. Dați clic pe Add Floor și denumiți-l (de exemplu "Main Hall").
  3. Adăugați etaje suplimentare dacă locația are mai multe zone (de exemplu "Mezzanine", "Outdoor Patio").
  4. Reordonați etajele cu butoanele muta în sus și muta în jos. Etajul de sus devine implicit în editorul Floor Plan.

Rezultat așteptat: Etajele apar în listă. Tab-ul Cafenea > Floor Plan afișează acum butoanele de etaj în partea de sus.

Pasul 5: Construiți planul de sală

  1. Deschideți Cafenea > Floor Plan.
  2. Selectați primul etaj din butoanele de etaj.
  3. Dați clic pe Add Table. O masă pătrată apare în originea pânzei.
  4. Trageți masa în poziția dorită. Eliberați pentru a salva.
  5. Dați clic pe masă pentru a deschide panoul de proprietăți. Configurați:
    • Code (de exemplu "T1", "Window 3").
    • Display Name (eticheta mai lungă, opțională).
    • Seat Count (numărul de locuri).
    • Shape (square, rectangle horizontal, rectangle vertical sau round).
    • Size (1 până la 10).
  6. Repetăți pentru fiecare masă din etaj.
  7. Opțional, comutați la 3D view pentru a revizui layout-ul din perspectiva unui arhitect.

Rezultat așteptat: Planul de sală redă toate mesele în pozițiile lor reale. Drag-ul este dezactivat în 3D view; reveniți la 2D pentru a muta mesele.

Pasul 6: Construiți meniul

  1. Deschideți Cafenea > Menu.
  2. Dați clic pe Add Category. Introduceți un nume și alegeți o pictogramă MDI din selectorul de iconițe. Dați clic pe Save.
  3. Repetăți pentru fiecare categorie (de exemplu "Hot Drinks", "Cold Drinks", "Burgers", "Desserts").
  4. În interiorul unei categorii, dați clic pe Add Product. Introduceți:
    • Name.
    • Description (Markdown suportat).
    • Ingredients line.
    • Base Price.
    • VAT Rate.
    • Preparation Time (rezervă statică).
    • Opțional: Unit label, Track Stock flag, In Stock count.
  5. Încărcați o Photo pentru produs. Orice format este acceptat; se recomandă WebP până la 2 MB.
  6. Dați clic pe Save.
  7. Dacă produsul are alegeri, derulați la secțiunea Variants și dați clic pe Add Variant. Creați un rând pentru fiecare opțiune cu diferența ei de preț. Activați Required dacă clientul trebuie să aleagă una.
  8. Repetăți pentru fiecare produs din meniu.

Rezultat așteptat: Meniul clientului la handy.cafe/{slug} afișează acum categoriile și produsele dvs. Vizitați-l într-un browser pentru verificare.

Pasul 7: Configurați imprimanta (opțional)

  1. Tot în Settings > Cafenea, derulați la Printer Settings.
  2. Setați Kind la TCP.
  3. Introduceți IP și Port ale imprimantei. Majoritatea imprimantelor ESC POS TCP ascultă pe portul 9100.
  4. Activați Auto Cut dacă imprimanta îl suportă.
  5. Activați Auto Print on New Order pentru a declanșa tipărirea la fiecare comandă nouă.
  6. Activați Sound Notification pentru o alertă audio pe lângă notificarea desktop.
  7. Dați clic pe Test Print. Un bon de probă ar trebui să fie tipărit în câteva secunde.

Rezultat așteptat: Bonul de test se tipărește cu succes. Dacă nu se tipărește nimic, verificați IP-ul, portul și faptul că imprimanta se află în aceeași rețea locală cu serverul.

Pasul 8: Așezați o masă și faceți o comandă de test

  1. Deschideți Cafenea > Tables (sau folosiți meniul de acțiuni din Floor Plan).
  2. Alegeți o masă și dați clic pe Seat Customer (numit și "Open Table").
  3. Notați codul de securitate din 6 cifre afișat. Scrieți-l sau lăsați dialogul deschis.
  4. Pe telefon, navigați la handy.cafe/{slug}/{table-code}. Puteți și scana QR-ul dacă aveți un autocolant imprimat.
  5. Introduceți codul din 6 cifre.
  6. Răsfoiți meniul și adăugați un articol în coș.
  7. Mergeți la checkout. Alegeți Cash ca metodă de plată (configurarea Stripe este opțională și poate fi adăugată mai târziu).
  8. Trimiteți comanda.
  9. Pe server, comutați la Cafenea > Orders.

Rezultat așteptat: În 3 secunde apare un card nou de comandă în panoul Orders. Se declanșează o notificare desktop. Se redă o alertă audio dacă notificările sonore sunt activate. Insigna cu numărul de comenzi în așteptare crește în tab-ul Orders.

Pasul 9: Avansați și decontați comanda de test

  1. Pe cardul comenzii, dați clic pe butonul următoarei stări. Comanda trece din placed în confirmed.
  2. Continuați să dați clic pentru a trece prin preparing, ready și served.
  3. Pe pagina Tables, deschideți aceeași masă și dați clic pe Settle Check.
  4. Alegeți Cash ca metodă de plată și confirmați.

Rezultat așteptat: Masa revine la idle. Codul de securitate expiră. Se creează o înregistrare de decontare care poate fi auditata ulterior.

Greșeli frecvente de evitat

  • Sărirea peste profilul afacerii. Clienții văd numele implicit și o zonă goală pentru logo dacă lansați înainte de a salva profilul.
  • Nereimprimarea codurilor QR după schimbarea slug-ului. Schimbarea slug-ului invalidează fiecare QR existent. Imprimați autocolante noi și înlocuiți-le pe fiecare masă.
  • Publicarea prea multor categorii la lansare. Țintiți 6 până la 10 categorii de top. Clienții răsfoiesc mai repede când meniul încape pe ecran.
  • Uitarea configurării imprimantei înainte de prima tură reală. Fără Auto Print on New Order, personalul poate rata comenzi în perioade aglomerate. Rulați întotdeauna cel puțin un test print.
  • Lăsarea activă a opțiunii implicite Show Prep Time on Menu fără istoric dinamic. În primele 30 de zile, valoarea statică este ceea ce văd clienții. Setați timpi statici realiști sau dezactivați indicatorul până când estimarea dinamică s-a antrenat.
  • Folosirea aceluiași dispozitiv pentru testarea personalului și a clientului. Sesiunea clientului persistă 24 de ore; dacă dispozitivul de test ajunge ulterior la un client, acesta ar fi deja în meniu fără verificare. Curățați dispozitivul sau folosiți un profil de browser curat pentru teste.