Product guide

Інструкція по роботі з системою

Окремий довідник по цілі продукту, сутностях, статусах та щоденному користуванню tablet UI і адмін-панеллю.

Відкрити адмін-панельВідкрити tablet UI

Ціль продукту

Платформа автоматично створює задачі на виробництво кулінарних товарів для мережі магазинів.

Дві ролі

Кухня працює у tablet UI, а адміністратор керує довідниками, прогнозом і ручними задачами.

Що всередині

Система знає сутності, статуси, пріоритети та правила переходів, тому UI показує тільки допустимі дії.

Ключові правила продукту

Коротко про бізнес-логіку, яку повинен розуміти кожен користувач.

Ціль продукту: автоматично планувати виробництво кулінарії на 4 години вперед без ручних таблиць.
Алгоритм враховує поточний залишок, активні задачі, прогноз продажів, цільовий запас та час приготування.
Для одного branchId + productId може існувати лише одне active task у статусі NEW або IN_PROGRESS.
Назва задачі формується автоматично у форматі product.name — quantity шт.
Пріоритети впливають на візуальне кодування: Critical червоний, Medium жовтий, Low зелений.

Tablet UI для кухні

Покроковий сценарій використання інтерфейсу.

  1. 1
    Відкрийте board, виберіть філію у фільтрі та працюйте тільки з її задачами.
  2. 2
    Картка задачі показує назву, кількість, пріоритет, час, дедлайн та причину пріоритету.
  3. 3
    Основна кнопка залежить від статусу: для NEW це Почати приготування, для IN_PROGRESS це Готово.
  4. 4
    Дія Неможливо виготовити схована в меню з трьома крапками і доступна для NEW та IN_PROGRESS.
  5. 5
    Екран деталей показує фото товару, технологічну карту, інгредієнти, кроки, обладнання та ті самі статусні дії.

Адмін-панель

Покроковий сценарій використання інтерфейсу.

  1. 1
    Dashboard показує стан мережі: філії, товари, активні задачі, прострочення та критичні позиції.
  2. 2
    Філії, асортимент, товари, техкарти та прогнози керують вхідними даними для алгоритму.
  3. 3
    Завдання показують усі автоматичні та ручні записи по мережі.
  4. 4
    Ручне створення завдання дозволяє створити або оновити active task для конкретного товару у філії.
  5. 5
    Налаштування задають горизонт планування, інтервал генерації та параметри kitchen board.

Сутності системи

Що зберігається в моделі даних і для чого це потрібно.

Branch

id, name, address

Окремий магазин, для якого ведеться асортимент, прогноз та виробничі задачі.

Assortment

id, branchId, items[]

Набір товарів конкретної філії. На рівні item зберігаються currentStock та hourlyTargetStock.

Product

id, name, photoUrl, unitWeight, technologicalCardId

Товар кулінарії. Один товар може входити в асортимент кількох філій.

Technological Card

id, name, ingredients, steps, requiredEquipment, typicalCookingTimeMinutes

Описує як готувати товар: склад, процес та обладнання.

Forecast

id, branchId, productId, hour, forecastedSalesQty

Погодинний прогноз продажів, який використовується алгоритмом генерації задач.

Task

id, branchId, productId, quantity, title, status, timelinessStatus, priority, expectedReadyAt, manual

Виробниче завдання. Важливе правило: одна задача містить тільки один товар.

Статуси задач

Які стани бачить користувач і які переходи дозволені.

Основні статуси

NEW: нове завдання, ще не взяте в роботу.
IN_PROGRESS: кухар почав виконання.
DONE: завдання завершене.
CANCELLED: виготовити неможливо.

Timeliness статуси

ON_TIME: дедлайн ще не порушений.
OVERDUE: очікувана готовність уже в минулому.

Дозволені переходи

NEW -> IN_PROGRESS через кнопку Почати приготування.
NEW -> CANCELLED через дію Неможливо виготовити в меню.
IN_PROGRESS -> DONE через кнопку Готово.
IN_PROGRESS -> CANCELLED через дію Неможливо виготовити в меню.

Практична схема роботи

Як зазвичай виглядає операційний цикл у системі.

Крок 1

Адміністратор підтримує філії, асортимент, товари, техкарти і прогнози.

Крок 2

Система генерує задачі на основі запасу, прогнозу та цільового рівня залишку.

Крок 3

Кухня бере задачу в роботу через tablet UI і доводить її до DONE або CANCELLED.

Крок 4

Після завершення запас оновлюється, а генератор перераховує наступні задачі.