HandyCafe Docs
owner it-admin

Кафетерія

Кафетерія - це вбудований модуль обслуговування їжею та напоями в HandyCafe. Він дає змогу будувати цифровий план столів, публікувати фірмове меню самообслуговування в мережі за адресою handy.cafe/{your-slug} та в реальному часі відстежувати кожне вхідне замовлення з панелі сервера.

Клієнти сканують QR-код на своєму столі, вводять 6-значний код безпеки, переглядають меню своєю мовою та оформлюють замовлення. Замовлення з'являється на екрані замовлень Кафетерії протягом кількох секунд. Персонал підтверджує кожен етап приготування, а коли обслуговування завершено, дія "Закрити рахунок" закриває чек одним кроком.

Для кого це

Кафетерія призначена для інтернет-кафе, ігрових центрів і кіберспортивних арен, які подають їжу та напої просто за столами клієнтів. Вона замінює паперові записки та усні звернення до стійки. Модуль працює разом зі стандартною системою сеансів і тарифікації HandyCafe; замовлення Кафетерії обліковуються окремо, але в межах тієї самої ліцензії кафе.

Основні можливості

Можливість Коротко
План залу Візуальний редактор для кількох поверхів. Перетягуйте столи, перемикайтеся в 3D-вид, позначайте столи як недоступні.
Столи Налаштовуйте кількість місць, форму, розмір (від 1 до 10) і код відображення. Генеруйте QR-коди та змінюйте їх за потреби.
Меню Категорії з іконками MDI, товари з фотографіями, описами в Markdown, списками інгредієнтів і групами варіантів, наприклад розмір або додатки.
Замовлення Жива панель з опитуванням кожні 3 секунди, значком очікуваних замовлень, сповіщеннями на робочому столі та зі звуком, статусами по замовленню і по позиції.
Закриття рахунку Дія в один клік, яка закриває всі відкриті замовлення на столі вибраним способом оплати.
Меню для клієнтів Фірмове вебменю на 24 мовах за адресою handy.cafe/{slug} зі світлою й темною темою та вибором мови з урахуванням пристрою.
Онлайн-оплата Необов'язкова інтеграція Stripe Checkout для оплати під час оформлення замовлення із запасним варіантом оплати готівкою за столом.
Принтер Необов'язковий TCP-принтер чеків з автообрізанням і автодруком при нових замовленнях.

Де знаходиться Кафетерія в серверному інтерфейсі

У Кафетерії є два входи:

  1. Розділ Кафетерія в бічній панелі. Це робочий простір для щоденної роботи. У ньому п'ять вкладок: Столи, План залу, Меню, Замовлення і Розклад. На вкладці Замовлення показується значок очікування, коли є нові замовлення.
  2. Налаштування > Кафетерія. Це область конфігурації. Тут містяться профіль закладу (slug, відображуване ім'я, логотип, верхнє зображення, адреса, валюта, часовий пояс), налаштування принтера, керування поверхами та додаткові перемикачі функцій.

Створення кафе

Коли ви вперше вмикаєте Кафетерію, сервер автоматично використовує вашу ліцензію HandyCafe як токен авторизації. Нічого вручну вставляти не потрібно. Далі майстер налаштування запитує чотири параметри:

  1. Slug. Це стане публічною адресою handy.cafe/{slug}. Дозволено лише малі літери, цифри та дефіси. Slug має містити від 3 до 62 символів. Система перевіряє доступність у реальному часі та відхиляє зарезервовані slug на кшталт "admin", "api" або "dashboard".
  2. Відображуване ім'я. Людиночитна назва, яка показується вгорі меню для клієнтів.
  3. Країна і валюта. Валюта за замовчуванням для цін у меню. Ціни зберігаються в дрібних одиницях, наприклад у копійках чи центах, і показуються з налаштованим символом валюти.
  4. Часовий пояс. Використовується для динамічного розрахунку часу приготування, часових позначок замовлень і записів про закриття рахунку.

Після завершення створення кафе воно з'являється в хмарній базі даних, а робочий простір Кафетерії відкривається. Після цього можна додавати поверхи, столи та позиції меню.

Профіль закладу

Профіль закладу можна редагувати будь-коли в розділі Налаштування > Кафетерія. Основні поля:

Поле Призначення
Slug Публічна частина адреси. При зміні slug старі QR-коди перестають працювати, доки ви не згенеруєте їх заново.
Відображуване ім'я Показується вгорі меню для клієнтів.
Логотип Квадратне зображення. Рекомендовано WebP до 2 МБ.
Верхнє зображення Широкий банер у верхній частині меню для клієнтів. Рекомендовано WebP до 2 МБ.
Адреса і телефон Необов'язково. Показуються внизу меню.
Валюта Застосовується до всіх цін товарів у меню.
Країна Використовується для податків і регіональних значень за замовчуванням.
Часовий пояс Застосовується до часових позначок замовлень і закриття рахунку.
Показувати час приготування в меню Перемикач. Якщо ввімкнено, біля кожного товару показується орієнтовний час приготування.

Налаштування принтера

Розділ принтера приймає такі параметри:

  • Тип. Disabled або TCP. Прямий друк через USB у цій версії не підтримується.
  • IP і порт. Мережева адреса вашого чекового принтера. Більшість ESC POS TCP-принтерів слухають порт 9100.
  • Автообрізання. Додає команду обрізання паперу після кожного надрукованого чека.
  • Автодрук при новому замовленні. Якщо ввімкнено, кожне нове замовлення автоматично друкує чек.
  • Звукове сповіщення. Відтворює звуковий сигнал разом зі сповіщенням на робочому столі під час нового замовлення.
  • Тестовий друк. Надсилає пробний чек на налаштований принтер, щоб перевірити з'єднання.

Коротко про архітектуру

Кафетерія використовує хмарну модель даних у першу чергу. Кожен стіл, категорія, товар, замовлення і запис про закриття рахунку зберігаються в хмарній базі даних handy.cafe. Ваш локальний сервер HandyCafe дзеркалить цей стан і опитує endpoint замовлень кожні 3 секунди на наявність нової активності. Сторінки для клієнтів обслуговуються безпосередньо з хмари handy.cafe; для них не потрібно, щоб ваш сервер був доступний з інтернету.

Оскільки дані зберігаються в хмарі:

  • QR-коди продовжують працювати навіть якщо сервер офлайн, але персонал не побачить замовлення на панелі, доки з'єднання не відновиться.
  • Зміни меню потрапляють у handy.cafe протягом кількох секунд після збереження.
  • Замовлення, зроблені клієнтами, потрапляють до панелі замовлень після наступного 3-секундного опитування.

Далі