HandyCafe Docs
owner it-admin

Jak skonfigurować kafeterię

Ten przewodnik przeprowadzi Cię przez kompletną, pierwszą konfigurację modułu kafeterii. Na końcu będziesz mieć opublikowane menu dla klientów na handy.cafe/{your-slug}, plan piętra z co najmniej jednym działającym stolikiem, menu z produktami oraz pomyślnie złożone zamówienie testowe.

Co będzie potrzebne

  • Aktywna licencja HandyCafe. Autoryzacja kafeterii wykorzystuje licencję automatycznie, nie musisz ręcznie wklejać klucza.
  • Połączenie z internetem na serwerze. Kafeteria jest skoncentrowana na chmurze, więc przygotowanie, synchronizacja menu i pobieranie zamówień wymagają dostępu do chmury.
  • Slug, którego chcesz użyć dla publicznego URL menu. Dozwolone znaki to małe litery, cyfry i myślniki. Długość od 3 do 62 znaków.
  • Opcjonalnie: logo i obraz nagłówka. Zalecany format to WebP do 2 MB.
  • Opcjonalnie: drukarka paragonów TCP w lokalnej sieci.

Krok 1: Włącz kafeterię

  1. Otwórz HandyCafe Server.
  2. Przejdź do Ustawienia w pasku bocznym.
  3. Otwórz zakładkę Kafeteria.
  4. Przełącz Włącz kafeterię na włączone.
  5. Serwer kontaktuje się z chmurą API używając Twojej licencji jako tokenu autoryzacji. Jeśli się powiedzie, otwiera się Kreator Przygotowania.

Oczekiwany wynik: Pojawia się ekran Kreatora Przygotowania. Jeśli widzisz błąd dotyczący licencji lub połączenia, sprawdź swoje połączenie internetowe i potwierdź, że Twoja licencja HandyCafe jest aktywna.

Krok 2: Przygotuj swoją kawiarnię

Kreator prosi o cztery pola.

  1. Slug. Wpisz żądany sufiks URL. Wskaźnik dostępności aktualizuje się w ciągu sekundy. Jeśli slug jest zajęty lub zarezerwowany, wybierz inny.
  2. Nazwa wyświetlana. Nazwa czytelna dla ludzi, wyświetlana na górze menu klienta, na przykład "Atilla's Gaming Lounge".
  3. Kraj i waluta. Wybierz kraj, w którym działa kawiarnia. Waluta domyślnie ustawia się na podstawie kraju i można ją zmienić.
  4. Strefa czasowa. Wybierz strefę czasową dla znaczników czasu zamówień i rozliczeń.
  5. Kliknij Utwórz kawiarnię.

Oczekiwany wynik: Kreator zamyka się, a otwiera się przestrzeń robocza kafeterii. Twój publiczny URL handy.cafe/{slug} jest teraz aktywny, choć menu jest puste.

Krok 3: Uzupełnij profil firmy

  1. Nadal w Ustawieniach > Kafeteria, przewiń do sekcji Profil firmy.
  2. Prześlij Logo (obraz kwadratowy).
  3. Prześlij Obraz nagłówka (szeroki baner).
  4. Wprowadź Adres i Telefon, które będą wyświetlane w stopce menu klienta.
  5. Przełącz Pokaż czas przygotowania w menu włączony lub wyłączony, w zależności od tego, czy chcesz, aby klienci widzieli szacowany czas przygotowania.
  6. Kliknij Zapisz.

Oczekiwany wynik: Logo i nagłówek pojawiają się w podglądzie. Odwiedzając handy.cafe/{slug} w przeglądarce, teraz widzisz markowy nagłówek, ale wciąż pustą treść.

Krok 4: Utwórz piętra

  1. W Ustawieniach > Kafeteria, znajdź sekcję Piętra.
  2. Kliknij Dodaj piętro i nazwij je (na przykład "Główna Sala").
  3. Dodaj dodatkowe piętra, jeśli Twoje miejsce ma wiele obszarów (na przykład "Antresola", "Patio na zewnątrz").
  4. Przestaw piętra za pomocą przycisków przenoszenia w górę i w dół. Górne piętro staje się domyślnym w edytorze planu piętra.

Oczekiwany wynik: Twoje piętra pojawiają się na liście. Zakładka Kafeteria > Plan piętra teraz pokazuje pigułki pięter na górze.

Krok 5: Zbuduj plan piętra

  1. Otwórz Kafeteria > Plan piętra.
  2. Wybierz pierwsze piętro z pigułek.
  3. Kliknij Dodaj stolik. Kwadratowy stolik pojawia się na początku płótna.
  4. Przeciągnij stolik do żądanej pozycji. Zwolnij, aby zapisać.
  5. Kliknij stolik, aby otworzyć panel właściwości. Skonfiguruj:
    • Kod (na przykład "T1", "Okno 3").
    • Nazwa wyświetlana (opcjonalna dłuższa etykieta).
    • Liczba miejsc (liczba miejsc).
    • Kształt (kwadrat, prostokąt poziomy, prostokąt pionowy lub okrągły).
    • Rozmiar (1 do 10).
  6. Powtórz dla każdego stolika na piętrze.
  7. Opcjonalnie przełącz się na widok 3D, aby przejrzeć układ z perspektywy architekta.

Oczekiwany wynik: Twój plan piętra renderuje wszystkie stoliki na ich rzeczywistych pozycjach. Przeciąganie jest wyłączone w widoku 3D; przełącz się z powrotem na 2D, aby przesuwać stoliki.

Krok 6: Zbuduj menu

  1. Otwórz Kafeteria > Menu.
  2. Kliknij Dodaj kategorię. Wprowadź nazwę i wybierz ikonę MDI z selektora ikon. Kliknij Zapisz.
  3. Powtórz dla każdej kategorii (na przykład "Gorące napoje", "Zimne napoje", "Burgery", "Desery").
  4. Wewnątrz kategorii kliknij Dodaj produkt. Wprowadź:
    • Nazwę.
    • Opis (obsługiwany Markdown).
    • Linię składników.
    • Cenę bazową.
    • Stawkę VAT.
    • Czas przygotowania (statyczna wartość zastępcza).
    • Opcjonalnie: etykieta jednostki, flaga śledzenia zapasów, liczba w magazynie.
  5. Prześlij Zdjęcie produktu. Akceptowany jest każdy format; WebP do 2 MB jest zalecany.
  6. Kliknij Zapisz.
  7. Jeśli produkt ma opcje, przewiń do sekcji Warianty i kliknij Dodaj wariant. Utwórz wiersz dla każdej opcji z jej różnicą cenową. Przełącz Wymagane, jeśli klient musi wybrać jedną.
  8. Powtórz dla każdego produktu w menu.

Oczekiwany wynik: Menu klienta na handy.cafe/{slug} teraz pokazuje Twoje kategorie i produkty. Odwiedź je w przeglądarce, aby zweryfikować.

Krok 7: Skonfiguruj drukarkę (opcjonalnie)

  1. Nadal w Ustawieniach > Kafeteria, przewiń do Ustawień drukarki.
  2. Ustaw Rodzaj na TCP.
  3. Wprowadź IP drukarki i Port. Większość drukarek ESC POS TCP nasłuchuje na porcie 9100.
  4. Włącz Automatyczne cięcie, jeśli drukarka to obsługuje.
  5. Włącz Automatyczne drukowanie przy nowym zamówieniu, aby wyzwolić drukowanie dla każdego przychodzącego zamówienia.
  6. Włącz Powiadomienie dźwiękowe dla alertu dźwiękowego obok powiadomienia na pulpicie.
  7. Kliknij Testuj drukowanie. Przykładowy paragon powinien wydrukować się w ciągu kilku sekund.

Oczekiwany wynik: Testowy paragon drukuje się pomyślnie. Jeśli nic się nie drukuje, sprawdź IP, port i czy drukarka jest w tej samej lokalnej sieci co serwer.

Krok 8: Posadź stolik i zrealizuj zamówienie testowe

  1. Otwórz Kafeteria > Stoliki (lub użyj menu akcji w Planie piętra).
  2. Wybierz jeden stolik i kliknij Posadź klienta (również oznaczone "Otwórz stolik").
  3. Zapisz wyświetlony 6-cyfrowy kod bezpieczeństwa. Zapisz go lub pozostaw okno dialogowe otwarte.
  4. Na telefonie przejdź do handy.cafe/{slug}/{table-code}. Możesz także zeskanować QR, jeśli masz wydrukowaną naklejkę.
  5. Wprowadź 6-cyfrowy kod.
  6. Przeglądaj menu i dodaj pozycję do koszyka.
  7. Przejdź do kasy. Wybierz Gotówka jako metodę płatności (konfiguracja Stripe jest opcjonalna i można ją dodać później).
  8. Złóż zamówienie.
  9. Na serwerze przejdź do Kafeteria > Zamówienia.

Oczekiwany wynik: W ciągu 3 sekund pojawia się nowa karta zamówienia na pulpicie zamówień. Wystrzeliwuje powiadomienie na pulpicie. Odtwarza się alert dźwiękowy, jeśli powiadomienia dźwiękowe są włączone. Licznik oczekujących zwiększa się na karcie Zamówienia.

Krok 9: Przesuń i rozlicz zamówienie testowe

  1. Na karcie zamówienia kliknij przycisk następnego statusu. Zamówienie przechodzi z złożone na potwierdzone.
  2. Kontynuuj klikanie, aby przejść przez przygotowywane, gotowe i podane.
  3. Na stronie Stoliki otwórz ten sam stolik i kliknij Rozlicz rachunek.
  4. Wybierz Gotówka jako metodę płatności i potwierdź.

Oczekiwany wynik: Stolik wraca do wolny. Kod bezpieczeństwa wygasa. Tworzony jest zapis rozliczenia, który można później audytować.

Częste błędy do uniknięcia

  • Pomijanie profilu firmy. Klienci widzą domyślną nazwę wyświetlaną i uszkodzony obszar logo, jeśli uruchomisz przed zapisaniem profilu.
  • Nie drukowanie ponownie kodów QR po zmianach slug. Zmiana slug unieważnia każdy istniejący QR. Wydrukuj nowe naklejki i wymień na każdym stoliku.
  • Publikowanie zbyt wielu kategorii na starcie. Celuj w 6 do 10 kategorii głównych. Klienci przeglądają szybciej, gdy menu mieści się na ekranie.
  • Zapominanie o skonfigurowaniu drukarki przed pierwszą prawdziwą zmianą. Bez Automatycznego drukowania przy nowym zamówieniu personel może przegapić zamówienia w czasie dużego ruchu. Zawsze wykonaj co najmniej jeden testowy wydruk.
  • Pozostawienie domyślnego Pokaż czas przygotowania w menu włączonego bez dynamicznej historii. Przez pierwsze 30 dni statyczna wartość jest tym, co widzą klienci. Ustaw realistyczne statyczne czasy lub wyłącz chip, dopóki dynamiczna prognoza się nie wytrenuje.
  • Używanie tego samego urządzenia do testów personelu i klientów. Sesja klienta trwa 24 godziny; jeśli Twoje urządzenie testowe zostało później przekazane klientowi, byłby już na menu bez weryfikacji. Wyczyść urządzenie lub użyj czystego profilu przeglądarki do testów.