HandyCafe Docs
owner it-admin

Kafeteria

Kafeteria to zintegrowany moduł serwisu gastronomicznego w HandyCafe. Pozwala na stworzenie cyfrowego planu stołów, opublikowanie markowego menu samoobsługowego w sieci pod adresem handy.cafe/{your-slug} oraz śledzenie każdego zamówienia w czasie rzeczywistym z panelu serwera.

Klienci skanują kod QR na swoim stole, wprowadzają 6-cyfrowy kod bezpieczeństwa, przeglądają menu w swoim języku i składają zamówienie. Zamówienie pojawia się na ekranie Zamówień Kafeterii w ciągu kilku sekund. Twoi pracownicy potwierdzają każdy etap przygotowania, a gdy serwis jest zakończony, akcja "Rozlicz Rachunek" zamyka rachunek jednym krokiem.

Dla Kogo Jest Przeznaczona

Kafeteria jest zaprojektowana dla kafejek internetowych, centrów gier i aren e-sportowych, które również serwują jedzenie i napoje przy miejscach klientów. Zastępuje papierowe karteczki zamówień i ustne prośby przy ladzie. Działa obok standardowego systemu sesji i cen HandyCafe; zamówienia kafeterii są śledzone oddzielnie, ale na tej samej licencji kafejki.

Główne Funkcje

Funkcja Podsumowanie
Plan stołów Edytor wizualny dla wielu pięter. Przeciągnij stoły na pozycję, przełącz na widok 3D, oznacz stoły jako wyłączone z użytku.
Stoły Konfiguruj liczbę miejsc przy stole, kształt, rozmiar (1 do 10) i kod wyświetlania. Generuj kody QR i obracaj je na żądanie.
Menu Kategorie z ikonami MDI, produkty ze zdjęciami, opisami w markdown, listami składników i grupami wariantów (np. Rozmiar, Dodatki).
Zamówienia Panel na żywo z odświeżaniem co 3 sekundy, odznaka liczby oczekujących, powiadomienia na pulpicie i dźwiękowe, statusy dla zamówień i poszczególnych pozycji.
Rozliczenie Jednoklikowe zamknięcie rachunku, które rozlicza wszystkie otwarte zamówienia na stole wybraną metodą płatności.
Menu dla klientów Markowe menu internetowe w 24 językach na handy.cafe/{slug}, z jasnym i ciemnym motywem oraz domyślnym językiem zależnym od urządzenia.
Płatność online Opcjonalna integracja z Stripe Checkout dla płatności przy zamówieniu, z możliwością płatności gotówką przy stole.
Drukarka Opcjonalna drukarka paragonów TCP z automatycznym cięciem i automatycznym drukowaniem nowych zamówień.

Gdzie Znajduje się Kafeteria w Interfejsie Serwera

Kafeteria ma dwa punkty wejścia:

  1. Sekcja Kafeteria w pasku bocznym. To operacyjne miejsce pracy do codziennego użytku. Zawiera pięć zakładek: Stoły, Plan Stołów, Menu, Zamówienia i Harmonogram. Zakładka Zamówienia pokazuje odznakę oczekujących, gdy nowe zamówienia czekają.
  2. Ustawienia > Kafeteria. To obszar konfiguracji. Zawiera profil biznesowy (slug, nazwa wyświetlana, logo, obraz nagłówka, adres, waluta, strefa czasowa), ustawienia drukarki, zarządzanie piętrami i opcjonalne przełączniki funkcji.

Przygotowanie Kafejki

Gdy po raz pierwszy włączysz Kafeterię, serwer automatycznie używa Twojej licencji HandyCafe jako tokenu autoryzacyjnego. Nie musisz nic wklejać ręcznie. Kreator konfiguracji poprosi następnie o cztery informacje:

  1. Slug. Staje się publicznym adresem URL pod handy.cafe/{slug}. Dozwolone znaki to małe litery, cyfry i myślniki. Slug ma od 3 do 62 znaków. System sprawdza dostępność w czasie rzeczywistym i odrzuca zarezerwowane slugi, takie jak "admin", "api" czy "dashboard".
  2. Nazwa wyświetlana. Nazwa czytelna dla człowieka, wyświetlana na górze menu dla klientów.
  3. Kraj i waluta. Domyślna waluta dla cen w menu. Ceny są przechowywane w jednostkach mniejszych (np. centy) i wyświetlane z skonfigurowanym symbolem waluty.
  4. Strefa czasowa. Używana do dynamicznych obliczeń czasu przygotowania, znaczników czasu na zamówieniach i zapisów rozliczeń.

Po zakończeniu konfiguracji kafejka jest tworzona w bazie danych w chmurze, a przestrzeń robocza Kafeterii otwiera się. Możesz wtedy dodać piętra, stoły i pozycje w menu.

Profil Biznesowy

Profil biznesowy można edytować w dowolnym momencie w Ustawieniach > Kafeteria. Kluczowe pola:

Pole Cel
Slug Segment publicznego URL. Zmiana slug powoduje, że istniejące kody QR przestają działać, dopóki nie zostaną wygenerowane ponownie.
Nazwa wyświetlana Wyświetlana na górze menu dla klientów.
Logo Kwadratowy obraz. Zalecany WebP do 2 MB.
Obraz nagłówka Szeroki obraz banera na górze menu dla klientów. Zalecany WebP do 2 MB.
Adres i telefon Opcjonalne. Wyświetlane w stopce menu.
Waluta Stosowana do każdej ceny produktu w menu.
Kraj Używany do podatków i domyślnych ustawień regionalnych.
Strefa czasowa Stosowana do znaczników czasu zamówień i rozliczeń.
Pokaż czas przygotowania w menu Przełącznik. Gdy włączony, każdy produkt wyświetla przewidywany czas przygotowania.

Ustawienia Drukarki

Sekcja drukarki akceptuje następującą konfigurację:

  • Rodzaj. Wyłączona lub TCP. Bezpośrednie drukowanie USB nie jest obsługiwane w tej wersji.
  • IP i Port. Adres sieciowy Twojej drukarki paragonów. Większość drukarek ESC POS TCP nasłuchuje na porcie 9100.
  • Automatyczne cięcie. Dodaje polecenie cięcia papieru po każdym wydrukowanym paragonie.
  • Automatyczne drukowanie nowego zamówienia. Gdy włączone, każde nowe zamówienie automatycznie wyzwala drukowanie paragonu.
  • Powiadomienie dźwiękowe. Odtwarza alert dźwiękowy oprócz powiadomienia na pulpicie, gdy przychodzi nowe zamówienie.
  • Testowy wydruk. Wysyła próbny paragon do skonfigurowanej drukarki w celu weryfikacji połączenia.

Podsumowanie Architektury

Kafeteria korzysta z modelu danych opartego na chmurze. Każdy stół, kategoria, produkt, zamówienie i zapis rozliczenia jest przechowywany w bazie danych w chmurze handy.cafe. Twój lokalny serwer HandyCafe odzwierciedla ten stan i co 3 sekundy sprawdza punkt końcowy Zamówień w poszukiwaniu nowej aktywności. Strony skierowane do klientów są serwowane bezpośrednio przez chmurę handy.cafe; nie wymagają, aby Twój serwer był dostępny z internetu.

Ponieważ dane znajdują się w chmurze:

  • Kody QR działają nawet wtedy, gdy serwer jest offline, ale personel nie może zobaczyć zamówień na panelu, dopóki nie powróci łączność.
  • Zmiany w menu są przesyłane do handy.cafe w ciągu kilku sekund od zapisania.
  • Zamówienia składane przez klientów trafiają na panel Zamówień po kolejnym 3-sekundowym odświeżeniu.

Kolejne Kroki