Урок 11. Диагностика: меню, товары, модификаторы и стоп-лист
Completion requirements:
- View
Модуль 11 · Блок C · ~2,5 часа
Диагностика: меню, товары, модификаторы и стоп-лист
Цель модуля: Отработать самый частый класс обращений — расхождения между тем, что настроено в iiko, и тем, что видит гость на фронте. Дать единый алгоритм и разбор всех типовых случаев.
Результаты обучения — после модуля специалист сможет:
- применять единый алгоритм диагностики отображения;
- разбирать проблемы товаров, категорий, цен и изображений;
- работать с модификаторами и стоп-листом;
- локализовать проблемную позицию при сбоях корзины и комбо.
Урок 11.1. Единый алгоритм диагностики отображения
Практически все проблемы отображения решаются одной последовательностью. Выучите её — она закрывает большинство обращений без эскалации.
- Проверить источник в iiko: активен ли товар; в нужной ли категории; участвует ли во внешнем меню; не стоит ли на стопе; корректна ли карточка.
- Проверить, что правился нужный объект — а не дубль товара.
- Выполнить синхронизацию (при необходимости — с деактивацией отсутствующих позиций).
- Перезапустить Киоск (iPad) / обновить фронт.
- Проверить конкретную категорию или товар вручную.
- Если данные всё ещё старые — искать кэш, дубли или изменение не в том объекте.
Почему шаги 3 и 4 всегда идут вместе: Синхронизация обновляет данные в системе, но фронт может продолжать показывать старое состояние. Без перезапуска устройства вы будете диагностировать «призрак» уже исправленной проблемы.
Урок 11.2. Меню, товары и категории
| Симптом | Что проверить |
|---|---|
| Новая позиция не появилась | Активен ли товар; привязан ли к нужной категории; не исключён ли из меню; готов ли к выгрузке; завершилась ли синхронизация |
| Товар есть в системе, но не виден | Активность; правильная категория; не исключён ли из меню; не на стопе ли; завершилась ли синхронизация |
| Удалённая позиция всё ещё видна | Действительно ли товар удалён или отключён; синхронизация с деактивацией отсутствующих; не осталась ли позиция в другой категории или в составе набора |
| Цена не обновилась | Сохранена ли новая цена; изменялась ли цена у нужного товара, а не у дубля; дошло ли обновление до фронта |
| Меню не обновилось после изменений | Сохранено ли изменение в основной системе; синхронизация; деактивация отсутствующих; перезапуск; кэш; дубли |
| Категория отображается не на своём месте | В какой родительской ветке находится категория; порядок отображения; конфликт с другими категориями; дубли |
| Товар отображается не в той категории | К какой категории привязан; не привязан ли сразу к нескольким; нет ли старой связи; была ли синхронизация после изменений |
| Блюдо не находится по артикулу | Правильно ли указан артикул; активен ли товар; не исключён ли из меню; не на стопе ли; нет ли ошибок в карточке |
| Изображение не отображается | Корректен ли файл; не было ли ошибки при загрузке; привязано ли к правильному товару; дошло ли обновление до фронта |
| Перевод или язык не отображается | Создан ли язык в системе; заполнены ли переводы у категорий и товаров; участвует ли язык в выгрузке; получил ли фронт обновления |
Когда эскалировать по изображениям: Если сервер отдаёт ошибку при загрузке или картинка есть в системе, но стабильно не попадает на фронт — это уже техническая проблема, а не данные.
Урок 11.3. Модификаторы, стоп-лист и сборка заказа
| Симптом | Что проверить |
|---|---|
| Модификатор не даёт завершить выбор блюда | Обязателен ли модификатор; есть ли допустимые варианты; не конфликтуют ли модификаторы между собой; корректна ли связка с блюдом |
| Модификатор отображается неправильно или со старым значением | Сохранено ли изменение; связан ли товар с правильным модификатором; прошла ли синхронизация; не показывает ли Киоск старый кэш |
| Обязательный модификатор отсутствует | Привязан ли модификатор к блюду; активен ли; доступен ли для внешнего меню; была ли синхронизация |
| Позиция или модификатор не встали на стоп | Правильно ли выбран объект для стопа (товар или модификатор); сохранено ли изменение; выполнялась ли синхронизация после установки стопа |
| Позиция снята со стопа, но всё ещё недоступна | Действительно ли стоп снят; нет ли второго стопа на связанном объекте; нет ли ограничений через набор или модификатор; была ли синхронизация |
Корзина и комбо
| Симптом | Метод |
|---|---|
| Заказ не собирается из-за проблемной позиции | Добавлять товары по одному, найти проблемную позицию, проверить её отдельно: обязательный модификатор, стоп-лист, ошибки карточки |
| Набор (комбо) не собирается | Проверить комбо поэлементно: все ли товары активны; не на стопе ли один из элементов; есть ли все обязательные модификаторы; нет ли исключённого товара внутри набора |
| Корзина ведёт себя некорректно | Повторить сборку поэтапно, найти конкретный шаг возникновения проблемы, проверить карточки соответствующих товаров |
Метод локализации: Не ищите ошибку «во всей системе». Собирайте заказ по одной позиции, пока не найдёте ту, на которой сценарий ломается. Это быстрее любой другой диагностики и даёт клиенту точный ответ, что именно исправить в iiko.
Практическое задание
- Выпишите единый алгоритм диагностики отображения по памяти (6 шагов) и держите его как рабочую шпаргалку.
- Кейс: гость не может добавить в корзину «Пиццу Маргарита», остальные позиции добавляются. Опишите порядок ваших действий и что именно вы попросите проверить клиента.
- Кейс: клиент поставил блюдо на стоп, но оно всё ещё доступно к заказу. Перечислите 4 проверки.
Критерий прохождения: Тест ≥ 80% + зачтены оба кейса.
Тест: вопросы этого модуля загружаются в Moodle отдельно, из банка вопросов (категория «Модуль 11»).