HandyCafe Docs
owner

Управление меню

Вкладка Меню в Кафетерии - это место, где вы собираете каталог, который видят клиенты по адресу handy.cafe/{slug}. Меню состоит из категорий и товаров. У товаров могут быть группы вариантов для выбора вроде размера или начинки.

Структура

Уровень Назначение
Категория Раздел меню, например "Горячие напитки" или "Бургеры". У каждой категории есть иконка и порядок сортировки.
Товар Отдельная позиция, которую можно заказать. Содержит название, описание, фото, цену, ставку НДС и время приготовления.
Группа вариантов Необязательно. Набор выбора, прикрепленный к товару, например "Размер: маленький, средний, большой". У каждого варианта есть добавочная цена.

Категории

У каждой категории есть такие поля:

Поле Значение
Название Показывается как заголовок раздела в меню для клиентов.
Иконка Имя MDI (Material Design Icons). Выбирается в селекторе иконок.
Порядок сортировки Целое число. Меньшие значения отображаются выше. Меняется перетаскиванием или кнопками вверх и вниз.
Активна Если выключено, категория и все ее товары скрываются из меню для клиентов, но не удаляются.

Добавление категории

  1. Откройте Кафетерия > Меню.
  2. Нажмите Добавить категорию.
  3. Введите название.
  4. Нажмите на поле иконки и выберите иконку MDI. Селектор открывает поиск по списку. Попробуйте запросы вроде "coffee", "burger" или "pizza".
  5. Сохраните. Категория появится в редакторе меню.

Сортировка категорий

Перетащите ручку у строки категории, чтобы изменить ее положение. Новая позиция сохраняется сразу после отпускания. Для точной расстановки можно также использовать стрелки вверх и вниз.

Мягкое удаление

Если удалить категорию, у которой есть связанные товары, она помечается неактивной вместо физического удаления записи. Это сохраняет историю заказов, которая ссылается на исходные ID товаров. Чтобы восстановить категорию, снова включите ее в интерфейсе администратора.

Товары

У каждого товара есть такие поля:

Поле Значение
Категория Родительская категория.
Название Видно клиенту.
Описание Поддерживается Markdown. Показывается на карточке товара, когда клиент открывает позицию.
Ингредиенты Короткая строка под описанием. Используйте ее для аллергенов или ключевых ингредиентов.
Базовая цена Цена до вариантов. Хранится в младших единицах, например в копейках или центах, но вводится в целых единицах валюты.
Ставка НДС Процент. Применяется при показе итогов в чеке клиента.
Единица Необязательная подпись вроде "мл" или "г". Показывается рядом с ценой.
Фото Изображение товара. Поддерживается любой формат. Для более быстрой загрузки меню рекомендуется WebP до 2 МБ.
Учитывать остаток Если включено, товар ведет остаток, который уменьшается при каждом заказе.
В наличии Текущий остаток. Когда он доходит до нуля, заказ для клиента не проходит, а товар автоматически скрывается.
Активен Если выключено, товар скрывается из меню для клиентов.
Порядок сортировки Позиция внутри категории.
Время приготовления Статическая резервная оценка в минутах. См. Динамическое время приготовления ниже.

Загрузка фото

  1. Откройте товар.
  2. Нажмите на область фото.
  3. Выберите изображение на своем компьютере. Endpoint загрузки принимает любой формат.
  4. Сервер обрабатывает файл, сохраняет идентификатор ресурса, MIME-тип и контрольную сумму, а затем возвращает URL.
  5. Фото сразу появляется в редакторе и в меню для клиентов в течение нескольких секунд.

Чтобы заменить фото, нажмите на существующее изображение и загрузите новый файл. Старый файл будет заменен.

Markdown в описаниях

Описание товара поддерживает Markdown. Обычные варианты использования:

  • Выделение жирным через **strong**.
  • Переносы строк для многострочных описаний.
  • Короткие списки для ингредиентов или сочетаний.

Не используйте заголовки (H1--H6) в описаниях товаров. Меню для клиентов показывает описание в ограниченной карточке, и заголовки выглядят неаккуратно.

Группы вариантов

Варианты учитывают выбор клиента, который меняет цену или конфигурацию. У товара может быть несколько групп вариантов, например размер и начинки у одного бургера.

У каждого варианта есть:

Поле Значение
Название Подпись для клиента, например "Размер" или "Дополнительный сыр".
Изменение цены Сумма, которая добавляется к базовой цене при выборе этого варианта. Может быть нулевой или отрицательной.
Обязательный Если включено, клиент должен выбрать хотя бы один вариант из этой группы перед добавлением в корзину.
Порядок сортировки Позиция внутри группы.

Создание группы вариантов

  1. Откройте товар.
  2. Прокрутите до раздела Варианты.
  3. Нажмите Добавить вариант.
  4. Введите название и изменение цены. Если выбор обязателен, включите Обязательный.
  5. Сохраните.

Повторите для каждого варианта в группе. Типичная группа "Размер" содержит три строки: Маленький с изменением 0, Средний с +1.00, Большой с +2.00.

Динамическое время приготовления

HandyCafe может вычислять оценку времени приготовления в реальном времени для каждого товара на основе фактической скорости кухни. Это повышает точность метки времени, которая показывается в меню для клиентов и в активных заказах.

Параметр Эффект
Статическое время Хранится у товара. Используется, когда истории недостаточно для расчета динамического значения.
Динамическая оценка Рассчитывается по истории заказов за последние 30 дней. Среднее время приготовления по товару умножается на коэффициент загруженности, который выводится из текущей длины очереди. Множитель ограничивается диапазоном от 1.0 до 2.0. Итоговое значение ограничивается от 1 до 120 минут.

Параметр "Показывать время приготовления в меню" в профиле заведения управляет тем, видна ли эта метка клиентам. Персонал всегда видит оценку на панели заказов.

Отслеживание остатков

Включайте Учитывать остаток для отдельных товаров, чтобы не продавать позиции, которые закончились.

  • Когда оформляется заказ, остаток уменьшается на количество заказанных единиц.
  • Когда остаток достигает нуля, товар автоматически скрывается из меню для клиентов, пока вы не обновите количество.
  • Чтобы пополнить остаток, откройте товар и введите новое значение В наличии.

Товары без учета остатков ведут себя как бесконечный склад и никогда не скрываются автоматически.

Изменение порядка товаров внутри категории

Перетащите ручку, чтобы переместить товар выше или ниже. Новый порядок сохраняется после отпускания. Меню для клиентов отражает его после следующего обновления меню, которое происходит при каждой загрузке сеанса.

Советы

  • Начинайте с 6--10 категорий. Слишком много категорий замедляет просмотр меню для клиентов.
  • Используйте фотографии с хорошим контрастом и освещением. Темные или шумные фото снижают количество заказов.
  • По возможности держите описания короче 120 символов. Слишком длинные описания могут увести кнопку Добавить в корзину за пределы первого экрана на телефоне.
  • Задавайте реалистичное статическое время приготовления. Динамической системе нужно 30 дней на обучение. До этого клиенты видят статическое значение.
  • Для товаров с большим количеством вариантов разделяйте выбор на две группы вместо одного огромного списка. "Размер" плюс "Молоко" выглядит чище, чем "Размер с молоком".