supersam/docs/scenarios.md

Сценарии работы приложения

1. Оператор входит в систему

1. Оператор (логист, водитель или админ) открывает /login и вводит email.
2. Система отправляет одноразовый код на почту. На экране подсказка: «Проверьте входящие и папку Спам».
3. Если email не найден в системе, показывается: «Email не найден в системе. Обратитесь к администратору.»
4. После ввода верного кода оператор попадает в дашборд согласно роли.

2. Логист открывает рабочее пространство доставки

1. Логист видит LogisticsReadinessBoard — доску с наборами доставки, сгруппированными по статусам:
   • На подходе: не все заказы набора прошли контроль качества.
   • Готово к запуску: все заказы приняты, можно запускать доставку.
   • Ожидает клиента: отправлено приглашение, ждём ответа.
   • Нужна ручная работа: передано логисту, платное хранение, проблема.
   • Согласовано: клиент подтвердил слот.
   • Завершено: все заказы доставлены.
2. Клик по набору открывает DeliverySetDetailPanel с:
   • Перечнем заказов набора, их 1С-номерами и шагами производства (раскрой, склейка, криволинейные, контроль качества, отгрузка).
   • Телефоном и email клиента, городом, связанными счетами.
   • Текущим статусом слота.

3. Согласование доставки с клиентом

1. Когда набор доставки готов, логист запускает отправку приглашения клиенту.
2. Клиент получает ссылку на /delivery/:token.
3. На странице клиент видит вкладки 🚚 Доставка и 🏪 Самовывоз.
4. На вкладке «Доставка» — DeliverySlotsPicker с доступными датами и половинами дня.
5. На вкладке «Самовывоз» — PickupSlotsPicker с датами (сегодня до 12:00, завтра, послезавтра, без выходных) и половинами дня, а также информационный блок: «Бесплатное хранение — 2 рабочих дня. С 3-го рабочего дня — 300₽/день.»
6. Клиент выбирает тип получения, слот и подтверждает. Статус набора переходит в «Ожидает клиента» → «Согласовано» или «Самовывоз».
7. Если клиент не отвечает, система или логист переводит набор в «Нужна ручная работа».

4. Перенос доставки

1. Клиент нажимает «Запросить новую ссылку», логист получает уведомление.
2. Логист может переназначить слот или отправить новое приглашение.
3. Выбранный слот сохраняется в delivery_slots.

5. Исключение

1. Если клиент не отвечает в течение SLA, система создаёт исключение.
2. Набор переходит в «Нужна ручная работа».
3. Логист может снова отправить приглашение, перевести в платное хранение или отменить.
4. Администратор видит инцидент в панели аудита.

6. Водитель выполняет доставку

1. Водитель видит назначенные доставки с адресом, городом, интервалом и составом заказа.
2. Переводит статус: Загружен → В пути → Доставлен.
3. При проблеме переводит в «Проблема доставки».

7. Завершение доставки

1. Статус «Доставлен» подтверждает физическую передачу заказа клиенту.
2. После закрытия всех заказов набора он переходит в «Завершено».
3. В истории появляется финальная запись, а чат закрывается для активных действий.

8. Самовывоз

Клиентский сценарий

1. Клиент открывает ссылку /delivery/:token.
2. Выбирает вкладку 🏪 Самовывоз.
3. Видит доступные даты: сегодня (если до 12:00 текущего дня готовности), завтра, послезавтра (выходные пропускаются).
4. Выбирает дату и половину дня: «До обеда» или «После обеда».
5. Видит информационный блок: «Бесплатное хранение — 2 рабочих дня. С 3-го рабочего дня — 300₽/день.»
6. Подтверждает выбор.
7. В БД устанавливаются: delivery_type = 'pickup', delivery_status = 'pickup', pickup_date, pickup_time_slot.

Сценарий менеджера/логиста

1. В карточке заказа (OrderDetailPanel) менеджер видит вкладки Доставка/Самовывоз.
2. При выборе «Самовывоз» — поля даты и половины дня для самовывоза.
3. Кнопка статуса «Самовывоз» доступна для менеджера, логиста и администратора.
4. Менеджер может переключить тип доставки в любой момент до передачи водителю.

Статусы самовывоза

• pickup — заказ ожидает самовывоза клиентом.
• Переходы: pending_confirmation → pickup, manual_confirmation_required → pickup, pickup → assigned_to_driver, pickup → delivered, pickup → cancelled.

Сценарий показа заказчику

1. Зайти под логистом.
2. На дашборде увидеть LogisticsReadinessBoard с наборами:
   • Волкова М.А. — «На подходе» (кухня готова, столешница ещё в производстве).
   • Савин А.П. — «Готово к запуску» (все заказы прошли контроль качества).
   • Тарасова Е.И. — «Ожидает клиента» (приглашение отправлено).
   • Фролова И.Д. — «Нужна ручная работа» (платное хранение).
   • Орлова Н.С. — «Завершено».
3. Кликнуть по набору Савина — увидеть source-поля, production-шаги, готовность к запуску.
4. Перейти на публичную страницу приглашения — увидеть вкладки «Доставка» и «Самовывоз» с выбором даты и половины дня.
5. Зайти под водителем — увидеть назначенные доставки с адресами и быстрыми действиями.
6. Зайти под несуществующим email — увидеть «Email не найден в системе. Обратитесь к администратору.»