Раздел для интеграторов

Этот раздел — рабочее место для людей, которые внедряют AntRoute на предприятии: технологов заказчика, консультантов-интеграторов и владельцев пилотных проектов. Не маркетинговая страница, не общее руководство пользователя — рабочий контур текущего состояния системы и конкретных пилотных задач.

Статус раздела

Документация на docs.antroute.pro в основной части устарела. Этот раздел открывает новую актуальную ветку: только то, что есть в коде сегодня. Старые страницы /guide/ оставлены до пересборки, но могут расходиться с реальным интерфейсом.

Зачем нужен раздел

AntRoute строится как одна общая платформа: каждое предприятие подключается через настройки, справочники, роли и DSL-конфигурацию экранов, а не через свою отдельную сборку. Поэтому каждый пилот — одновременно и работа на конкретного заказчика, и материал для усиления общей платформы.

Раздел нужен, чтобы:

• интегратор или технолог мог сам открыть систему и посмотреть, что уже работает, без помощи разработчика;
• замечания приходили в одном формате: экран, что не так, как должно быть, приоритет;
• было ясно, что относится к финальному UI, а что пока работает как пилотная оболочка;
• любой шаг инструкции, который не сходится с интерфейсом, превращался в продуктовую задачу.

Принцип: инструкция как валидация продукта

Если шаг из инструкции «зайти, открыть, увидеть» не получается выполнить буквально — это не ошибка читателя, а сигнал, что в продукте неточный путь, неудачное название экрана, не хватает данных или сценарий рассыпается.

Поэтому к этому разделу есть требование: после каждого видимого пользователю изменения пилота инструкцию обновляют. Никаких «потом причешем». Дрифт между инструкцией и пилотом — отдельный тип бага.

Карта раздела

Материалы в порядке возрастания глубины:

Материал	Для кого	Что в нём
Пилот Кочарина: как смотреть	Андрей, интегратор, технолог заказчика	Полный обзор текущего состояния пилота: вход, маршрут просмотра 10–20 минут, ожидаемые цифры по импорту, чек-лист обратной связи, известные ограничения.
Интеграторская консоль: обзор	Интегратор (Андрей и аналоги), технолог-заказчик	Wave K-ADM1: Dashboard, Preview под ролью, Config Viewer, CodeMirror Editor для DSL-YAML. 18 скриншотов реального интерфейса.
Импорт Excel в UI	Интегратор, заливающий данные предприятия	Wave K-ADM1 A5: пошаговый flow upload → preflight → confirm → apply → history. 5 скриншотов Playwright-walkthrough'а с реальным каноническим Кочарин-файлом.
Передача партий между юр.лицами	Диспетчер отправляющего, диспетчер принимающего, интегратор	Wave K-O4: cooperators endpoint, transfer dialog, handover list/detail, receive/cancel, time-based alarms с SLA per тип кооперации.
Формулы маршрута (dual: операции + РМ)	Технолог, мастер, оператор	Wave K-P9: двойная формула маршрута, парсер + validate, виджет в карточке tech object + RouteCardDetail + OperatorStation.
Канал обратной связи (Feedback FAB + RUM)	Андрей, пилотный пользователь, админ-читатель	Wave K-FB1: глобальный FAB-виджет, text/voice/screenshot, RUM telemetry, как админ читает поток.

Раздел будет дополняться новыми материалами по мере выхода блоков: экраны планирования, экраны рабочих мест, мобильное приложение и т.д.

Как пользоваться разделом

1. Начните с пилотного обзора Кочарина.
2. Откройте систему по адресу, который передал Владимир, под указанным пользователем.
3. Пройдите маршрут просмотра по шагам, не пропуская.
4. Каждое расхождение между инструкцией и тем, что видно на экране, фиксируйте отдельно — это и есть обратная связь по продукту.
5. Используйте чек-лист в конце документа: он формирует структурную обратную связь, а не общее впечатление.

Как давать обратную связь

Просим смотреть пилот не как финальный продукт, а как рабочий контур текущей итерации. Ценная обратная связь — по четырём направлениям:

1. Сценарий. Похоже ли это на реальный процесс предприятия. Где логика данных или порядок шагов не сходится с тем, как работает технолог, мастер, диспетчер.
2. Термины. Какие названия экранов, вкладок, полей и статусов непонятны или отличаются от терминологии предприятия.
3. Данные. Каких полей, разделов, признаков критически не хватает в карточках и списках. Что лишнее.
4. Подход. В правильную ли сторону идёт линия: одна платформа + настройки конкретного предприятия. Или подход уводит не туда.

Формат замечания (по возможности):

Экран: Изделия и детали
Что не так: непонятно поле «object_type»
Как нужно: показывать «Изделие / Деталь / Сборочная единица» по-русски
Приоритет: высокий

Если замечание визуальное — достаточно скриншота и короткого комментария.

Протокол обновления раздела

• После каждого видимого изменения пилота (новый экран, переименование вкладки, новый сценарий, обновлённые ожидаемые цифры) ответственный за изменение правит соответствующую страницу здесь и ставит новую дату «Обновлено» в шапке документа.
• Если изменение временно (пилотная оболочка), это явно отражается в разделе «Что пока пилотная оболочка».
• Если инструкция перестала сходиться с интерфейсом и обновить её нельзя в том же релизе, документ помечается баннером «Дрифт» с ссылкой на задачу.
• Раздел не дублирует общее руководство пользователя. Сюда попадает только то, что нужно для интеграции и пилотных просмотров.