Как настроить Кафетерию

Этот гид проведет вас через полную первичную настройку модуля Кафетерия. К концу у вас будет опубликованное меню для клиентов на handy.cafe/{your-slug}, план зала хотя бы с одним рабочим столом, меню с товарами и успешно оформленный тестовый заказ.

Что понадобится

Активная лицензия HandyCafe. Кафетерия использует ее для авторизации автоматически; вручную вводить ключ не нужно.
Интернет-соединение на сервере. Кафетерия работает в облаке в первую очередь, поэтому создание кафе, синхронизация меню и опрос заказов требуют исходящего доступа к cloud API.
Slug, который вы хотите использовать для публичного адреса меню. Разрешены строчные буквы, цифры и дефисы. Длина - от 3 до 62 символов.
Необязательно: логотип и верхнее изображение. Рекомендуемый формат - WebP до 2 МБ.
Необязательно: TCP-чековый принтер в локальной сети.

Шаг 1: Включите Кафетерию

Откройте HandyCafe Server.
Перейдите в Настройки на боковой панели.
Откройте вкладку Кафетерия.
Включите переключатель Enable Кафетерий.
Сервер обращается к cloud API, используя вашу лицензию как токен авторизации. Если все успешно, откроется мастер создания кафе.

Ожидаемый результат: Появляется экран мастера создания кафе. Если видите ошибку о лицензии или соединении, проверьте интернет и убедитесь, что лицензия HandyCafe активна.

Шаг 2: Создайте кафе

Мастер запрашивает четыре поля.

Slug. Введите желаемый суффикс адреса. Индикатор доступности обновляется в течение секунды. Если slug занят или зарезервирован, выберите другой.
Display Name. Человекочитаемое имя, которое показывается вверху меню для клиентов, например "Atilla's Gaming Lounge".
Country and Currency. Выберите страну, в которой работает кафе. Валюта по умолчанию выбирается по стране и может быть изменена.
Timezone. Выберите часовой пояс для временных меток заказов и закрытия счета.
Нажмите Create Cafe.

Ожидаемый результат: Мастер закрывается, и открывается рабочее пространство Кафетерии. Ваш публичный адрес handy.cafe/{slug} теперь работает, хотя меню еще пустое.

Шаг 3: Заполните профиль заведения

Оставаясь в Настройки > Кафетерия, прокрутите до раздела Профиль заведения.
Загрузите Logo (квадратное изображение).
Загрузите Header Image (широкий баннер).
Укажите Address и Phone, чтобы они отображались внизу меню для клиентов.
Включите или выключите Show Prep Time on Menu в зависимости от того, хотите ли вы показывать клиентам время приготовления.
Нажмите Save.

Ожидаемый результат: Логотип и верхнее изображение появляются в предпросмотре. Если открыть handy.cafe/{slug} в браузере, там уже будет фирменная шапка, но контент пока пустой.

Шаг 4: Создайте этажи

В Настройки > Кафетерия найдите раздел Этажи.
Нажмите Add Floor и задайте название, например "Main Hall".
Добавьте дополнительные этажи, если у вашего заведения несколько зон, например "Mezzanine" или "Outdoor Patio".
Переставляйте этажи кнопками вверх и вниз. Верхний этаж становится значением по умолчанию в редакторе Плана зала.

Ожидаемый результат: Этажи появляются в списке. Вкладка Кафетерия > План зала теперь показывает переключатели этажей вверху.

Шаг 5: Постройте план зала

Откройте Кафетерия > План зала.
Выберите первый этаж с помощью переключателей.
Нажмите Добавить стол. На начале холста появится квадратный стол.
Перетащите стол в нужное место. Отпустите, чтобы сохранить.
Нажмите на стол, чтобы открыть панель его свойств. Настройте:
- Code (например "T1", "Window 3").
- Display Name (необязательная более длинная подпись).
- Seat Count (количество мест).
- Shape (квадрат, прямоугольник горизонтальный, прямоугольник вертикальный или круг).
- Size (от 1 до 10).
Повторите для каждого стола на этаже.
При желании переключитесь в 3D view, чтобы посмотреть план с архитектурной перспективы.

Ожидаемый результат: План зала отображает все столы в их реальных позициях. В 3D-режиме перетаскивание отключено; вернитесь в 2D, чтобы перемещать столы.

Шаг 6: Создайте меню

Откройте Кафетерия > Меню.
Нажмите Добавить категорию. Введите название и выберите иконку MDI в селекторе. Нажмите Save.
Повторите для каждой категории, например "Hot Drinks", "Cold Drinks", "Burgers", "Desserts".
Внутри категории нажмите Add Product. Укажите:
- Название.
- Описание (поддерживается Markdown).
- Строку ингредиентов.
- Базовую цену.
- Ставку НДС.
- Время приготовления (статический резерв).
- Необязательно: подпись единицы измерения, флаг Track Stock, значение In Stock.
Загрузите Photo товара. Поддерживается любой формат; для более быстрой загрузки рекомендуется WebP до 2 МБ.
Нажмите Save.
Если у товара есть выбор, прокрутите до раздела Variants и нажмите Add Variant. Создайте строку для каждого варианта с изменением цены. Включите Required, если клиент обязан выбрать один вариант.
Повторите для каждого товара в меню.

Ожидаемый результат: Меню для клиентов на handy.cafe/{slug} теперь показывает ваши категории и товары. Откройте его в браузере, чтобы проверить.

Шаг 7: Настройте принтер (необязательно)

Оставаясь в Настройки > Кафетерия, прокрутите до Настроек принтера.
Установите Kind в TCP.
Введите IP и Port принтера. Большинство ESC POS TCP-принтеров слушают порт 9100.
Включите Auto Cut, если принтер это поддерживает.
Включите Auto Print on New Order, чтобы печатать чек при каждом новом заказе.
Включите Sound Notification для звукового оповещения вместе со всплывающим уведомлением.
Нажмите Test Print. Пробный чек должен распечататься через несколько секунд.

Ожидаемый результат: Тестовый чек печатается успешно. Если ничего не печатается, проверьте IP, порт и то, что принтер находится в той же локальной сети, что и сервер.

Шаг 8: Посадите за стол и сделайте тестовый заказ

Откройте Кафетерия > Столы (или используйте меню действий Плана зала).
Выберите один стол и нажмите Посадить клиента (также может называться "Открыть стол").
Запомните показанный 6-значный код безопасности. Запишите его или оставьте диалог открытым.
На телефоне перейдите на handy.cafe/{slug}/{table-code}. Если у вас есть наклейка, можно также отсканировать QR.
Введите 6-значный код.
Просмотрите меню и добавьте товар в корзину.
Перейдите к оформлению заказа. Выберите Cash как способ оплаты (настройку Stripe можно сделать позже).
Отправьте заказ.
На сервере переключитесь на Кафетерия > Заказы.

Ожидаемый результат: В течение 3 секунд на панели заказов появляется новая карточка заказа. Срабатывает уведомление на рабочем столе. Если звуковые уведомления включены, воспроизводится аудиосигнал. Значок количества ожидающих заказов на вкладке Заказы увеличивается.

Шаг 9: Продвиньте и закройте тестовый заказ

На карточке заказа нажмите кнопку следующего статуса. Заказ переходит из placed в confirmed.
Продолжайте нажимать, чтобы пройти через preparing, ready и served.
На странице Столы откройте тот же стол и нажмите Закрыть счет.
Выберите Cash как способ оплаты и подтвердите.

Ожидаемый результат: Стол возвращается в idle. Код безопасности истекает. Создается запись о закрытии счета, которую можно будет проверить позже.

Частые ошибки, которых стоит избегать

Пропуск профиля заведения. Клиенты увидят имя по умолчанию и сломанное место под логотип, если вы запустите кафе до сохранения профиля.
Не печатать QR-коды заново после изменения slug. При смене slug каждый старый QR становится недействительным. Напечатайте новые наклейки и замените их на каждом столе.
Публиковать слишком много категорий при запуске. Лучше начать с 6--10 верхнеуровневых категорий. Клиенты быстрее ориентируются, когда меню помещается на экране.
Забыть настроить принтер до первой реальной смены. Без Auto Print on New Order персонал может пропустить заказы в загруженный период. Всегда делайте хотя бы одну тестовую печать.
Оставлять включенным Show Prep Time on Menu без динамической истории. Первые 30 дней клиенты видят статическое значение. Задавайте реалистичное время или отключайте метку, пока динамическая оценка не обучится.
Использовать одно и то же устройство для тестов персонала и клиентов. Сеанс клиента сохраняется 24 часа; если потом это устройство попадет к клиенту, он уже увидит меню без проверки. Очищайте устройство или используйте чистый профиль браузера для тестов.