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-секундного опроса.

Дальше