Пилот Кочарина: текущее состояние и маршрут просмотра

Обновлено: 16.05.2026 Статус: технический пилотный контур, не готовый production UI. Адресат: Андрей (концепция), интегратор пилота, технолог предприятия. Любой, кто открывает систему первым.

Документ описывает, что в пилоте уже работает технически, что выглядит как пилотная оболочка, и как за 10–20 минут самостоятельно посмотреть систему так, чтобы дать структурную обратную связь. Скриншоты ниже не доказывают, что интерфейс готов. Они фиксируют текущее состояние и показывают, какие места ещё нужно довести.

1. Назначение и контекст

Пилот идёт по предприятию Кочарина (5 юридических лиц, 7 производственных контуров: ВСП, ИКС, Альфа-Кинетика, Арлиз, Арлиз Курган, ИП-1, ИП-2). Цель пилота — пройти одно конкретное изделие через всю цепочку: справочники → технология → планирование → производство. Документ покрывает первую часть этого пути: справочники изделий, импорт реальных Excel-данных и проверку, что предприятие видит свои данные, а не чужие.

2. С чем заходить

Адрес системы и пароли передаёт Владимир отдельно — в публичную документацию они не идут.

Учётные записи под просмотр:

Юр.лицо	Пользователь	Что смотреть
ООО «Завод ВСП» (Тюмень)	koc-4505016987-admin	Основной список изделий и деталей, карточка изделия, маршрут с операциями, кооперационные передачи в ИКС
ООО «Инженерно-конструкторский сервис» (Тюмень)	koc-7203456955-admin	Свой меньший справочник, проверка изоляции от ВСП, термообработка как принимающее звено
ООО «Арлиз Курган» (Курган)	koc-4505017109-admin	Принимающее звено кооперации (видимость 1 изделия + маршрут передачи)

Если на просмотр всего 10 минут — достаточно зайти под koc-4505016987-admin (ВСП) и пройти Шаги 1–4 из §5. Полный проход включает сравнение двух организаций (Шаг 5).

Почему 7 учёток на 5 юр.лиц

ВСП и ИКС физически на одном адресе в Тюмени, Арлиз и Арлиз Курган — два разных юр.лица. ИП-1 и ИП-2 — индивидуальные предприниматели кооперации (шлифовка, узлы). В AntRoute каждый контур — отдельная организация (multi-tenancy): своё пространство справочников, свои пользователи, свои данные.

3. Что уже работает технически

За автономный цикл закрыта инфраструктурная основа. Видеть это можно буквально на экране и в данных:

• DSL-конфигурация предприятия. Одна сборка AntRoute принимает настройки конкретного предприятия (меню, экраны, вкладки карточек) из YAML-конфига, без отдельной сборки на клиента.
• Пилотный frontend runtime. Меню и маршруты строятся из DSL-конфига, есть защита raw-admin экранов от не-админских ролей, работают breadcrumbs.
• Экран списка изделий и деталей и карточка изделия через DSL. Открываются как обычные страницы, рисуются на основе конфигурации предприятия, а не жёсткого фронтового маршрута. Это пока доказывает архитектуру, а не качество UX.
• Импорт реальных Excel-данных Кочарина по 7 организациям. Backend-пайплайн B0–B9: разбор канонического файла, разрезка на 7 per-org файлов, перенос в БД с per-org изоляцией.
• Изоляция данных. Пользователь одной организации физически не видит данные другой. Перекрёстный доступ по UUID возвращает HTTP 404 (не «вы не имеете права», а «такого объекта не существует» — безопасный посылочный код).
• Идемпотентность импорта. Повторный запуск импорта на тех же файлах ничего не меняет в БД (Δ=0 по всем сущностям: техоб., рабочие места, материалы, операции, технологические операции, спецификации).
• Кооперационные маршруты. Передачи между предприятиями (ВСП → ИКС термообработка, ИП-1 → Арлиз Курган сборка, и т.д.) хранятся в параметрах конкретного изделия — видны и у отправителя, и у получателя.
• Глобальный словарь операций. Базовые операции (точение, фрезеровка, термообработка, шлифовка, сборка, контроль и т.д.) — общий справочник между предприятиями. Конкретные технологические операции изделия — отдельны для каждого предприятия.

Ожидаемые цифры пилота после импорта (на 16.05.2026):

Юр.лицо	Изделия и детали	Рабочие места	Материалы	Технологические операции	Спецификации
ВСП (KOC-4505016987)	24	9	68	71	39
ИКС (KOC-7203456955)	12	7	68	14	15
Альфа-Кинетика (KOC-7203367864)	4	16	68	2	4
ИП-1 (KOC-1)	4	1	68	2	4
Арлиз Курган (KOC-4505017109)	1	4	68	0	0
Арлиз (KOC-7453230090)	0	2	68	0	0
ИП-2 (KOC-2)	0	1	68	0	0

Почему «Материалы» одинаковые

Справочник материалов в исходном файле один общий на всё предприятие Кочарина: 68 валидных позиций после удаления строк без единиц измерения. Он спроецирован одинаково в каждую организацию. Это осознанное решение пилота: разделять материалы по контурам пока нет необходимости.

Почему «Технологических операций» нет у трёх организаций

У Арлиз, Арлиз Курган и ИП-2 в исходном файле нет своего листа «Маршруты» — они либо принимающее звено кооперации (Арлиз Курган получает 1 изделие), либо пока без маршрутов в данных пилота. Это факт исходных данных, а не баг импорта.

4. Что пока пилотная оболочка

Чтобы не завысить ожидания — что сейчас сознательно работает в «пилотном» режиме:

• Загрузка Excel из UI пока не реализована. Импорт делается командой python manage.py split_kocharin_excel --apply на сервере. UI-кнопка «Загрузить файл» — отдельная задача.
• Не все экраны переведены на DSL. Карточка продукта, список изделий и базовая навигация — да. Планирование, рабочие места, склад, финансы — пока через прежние страницы или ещё не настроены.
• Карточка изделия — техническая оболочка. Вкладки и роутинг работают, но внутри видны технические поля (system_code, object_type, status) и почти нет пользовательских действий. Для технолога это пока не полноценная карточка изделия.
• Вкладка «Технология» — заглушка. Сейчас там отображается технический текст вида route_formula, а не понятный маршрут операций. Это нужно считать неготовым UX.
• Кооперационные маршруты хранятся в данных, но отдельной вкладки «Кооперация» в UI пока нет. Их видно в параметрах изделия через API; UI-визуализация — следующая итерация.
• Не проверены все роли. Подробно прогнан только админ организации. Технолог, мастер, оператор, диспетчер — отдельный проход.
• Мобильный интерфейс и публичный лендинг в этот раздел не входят — это другие проекты, у них своя ветка работ.

5. Маршрут просмотра на 10–20 минут

Если что-то из шагов не открывается или открывается иначе — это само по себе обратная связь по продукту (см. §7).

Шаг 1. Войти в систему (1–2 мин)

1. Откройте адрес системы, который передал Владимир.
2. Войдите под пользователем koc-4505016987-admin (ВСП).
3. Убедитесь, что главный экран открывается без ошибок: видно боковое меню, верхняя панель, имя пользователя.

Что проверить:

• меню в левой части — есть раздел «Технология»;
• не должно быть видимых упоминаний других организаций (ИКС, Арлиз и т.п.) — их данных у этого пользователя быть не должно;
• хлебные крошки сверху корректные.

Шаг 2. Открыть список изделий и деталей (2–3 мин)

Откройте в левом меню Технология → Изделия и детали.

Что должно быть видно:

• 24 строки изделий и деталей предприятия ВСП;
• столбцы: системный код, артикул, наименование, тип объекта (изделие / деталь / сборочная единица), участок, статус, метка «своё / заёмное», метка «изготавливается / закупается»;
• сверху — счётчики (карточки-тайлы) по типам объектов и статусам;
• поиск по коду, артикулу, наименованию;
• в списке не должно быть ни одной строки чужой организации (артикулы должны начинаться с KOC-4505016987.).

Откуда 24, если ожидалось 25

Перед фиксацией ожидаемых цифр из БД был удалён один служебный демо-объект из предыдущей DSL-валидации (он не относился к Кочарину). Реальное число изделий ВСП в пилоте — 24.

Шаг 3. Открыть карточку изделия (3–5 мин)

Откройте любую строку из списка. Карточка изделия имеет восемь вкладок (порядок и названия фиксированы DSL-конфигом предприятия):

1. Основные — основные поля изделия.
2. Спецификация — состав изделия (BOM-дерево).
3. Технология — маршрут операций (пилотный виджет, см. Шаг 4).
4. Чертежи — галерея чертежей.
5. Документация — галерея документов.
6. Комментарии — обсуждение карточки.
7. Make-or-Buy — решение «производить / закупать».
8. История — журнал изменений изделия.

Что проверить на вкладке «Основные»:

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

Шаг 4. Открыть вкладку «Технология» (2–3 мин)

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

Что проверить:

• открывается ли вкладка без ошибок;
• видна ли последовательность операций маршрута (если у изделия они есть);
• правильно ли подписаны шаги;
• что просится здесь увидеть в финальном виде: таблица операций, граф передач, что-то ещё.

Шаг 5. Сравнить с другой организацией (3–5 мин)

Выйдите из системы и войдите под koc-7203456955-admin (ИКС).

Что проверить:

• список изделий другой (12 строк, артикулы с префиксом KOC-7203456955.);
• данных ВСП больше не видно — это и есть проверка изоляции организаций;
• логика входа и навигации идентична: те же экраны, та же структура карточки, только данные свои.

Если есть ещё пара минут — войдите под koc-4505017109-admin (Арлиз Курган). Этой организации в пилоте принадлежит 1 изделие — оно принимающее звено в кооперации, и у него своя метка передачи в параметрах изделия (видно через API, в UI пока нет отдельной вкладки).

6. Визуальный снимок текущего интерфейса

Скриншоты ниже — не дизайн-макеты, а результат реального walkthrough текущей сборки. Их можно смотреть без входа в систему, чтобы быстро понять, как пилот выглядит сейчас. Важно: эти картинки нужны не для того, чтобы сказать «готово», а чтобы увидеть, что именно сейчас непонятно и требует следующей итерации.

Как читать эти скриншоты

Если на скриншоте видны технические названия полей, пустые области, мало действий или непонятно, что делать дальше — это не проблема читателя. Это честный сигнал, что UI ещё нужно доводить.

6.1. Список изделий и деталей

Основной DSL-экран /v/engineering/products: заголовок, счётчики, поиск, таблица изделий и деталей.

Что на нём уже понятно:

• есть список из 24 объектов ВСП;
• видны счётчики по типам;
• можно понять, что это справочник изделий и деталей.

Что пока плохо:

• артикулы слишком длинные и занимают большую часть строки;
• типы assembly, detail, статус draft показаны техническими словами, а не русскими терминами;
• нет явных действий в строке: открыть, редактировать, показать маршрут, показать состав;
• не видно, какие изделия являются ключевыми для пилота.

6.2. Карточка изделия

Карточка с восемью вкладками. Это ключевой экран для проверки логики: понятно ли, где основные поля, спецификация, технология, чертежи, документация, комментарии, Make-or-Buy и история.

Что на ней уже работает:

• карточка открывается из строки списка;
• вкладки берутся из DSL-конфигурации;
• основные данные подтягиваются из API.

Что пока плохо:

• выглядит как техническая форма, а не карточка изделия;
• поля называются system_code, name, artikul, object_type, status;
• нет кнопок и действий: редактировать, открыть маршрут, открыть спецификацию, показать кооперацию;
• слишком много пустого пространства;
• нет бизнес-контекста: что это за изделие, где производится, какие операции/состав/кооперация есть.

6.3. Вкладка «Технология»

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

Что должно быть в следующей итерации:

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

6.4. Служебный raw-admin маршрут скрыт для обычного пользователя

Это состояние важно скорее интегратору, чем Андрею: обычный пользователь не должен попадать в служебные raw-admin экраны.

6.5. Служебный raw-admin маршрут доступен superuser

Superuser видит служебный placeholder. Это не пользовательский сценарий предприятия, а проверка контроля доступа для интеграторов.

7. Чек-лист обратной связи

Чтобы обратная связь была не общей, а действенной — ответьте по пунктам. Можно прямо в этой структуре, можно отдельным сообщением.

7.1. Подход

• Понятна ли идея «одна система + настройки предприятия»?
• В правильную ли сторону идёт линия пилота, или подход уводит не туда?

7.2. Терминология

• Какие названия экранов непонятны или не совпадают с терминологией предприятия?
• Какие названия вкладок карточки изделия требуют переименования?
• Какие названия полей нужно показывать по-русски, а не как технические идентификаторы?

7.3. Данные

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

7.4. Сценарии

• Какие шаги маршрута просмотра рассыпались (что не получилось сделать буквально)?
• Какие сценарии критично отсутствуют в пилотной выборке (например, закупаемая деталь без маршрута, сборочная единица с глубоким деревом, изделие с альтернативным маршрутом)?
• Какие данные предприятия не легли в импорт (если что-то узнаваемое отсутствует — пометьте конкретно, что именно)?

7.5. Приоритет следующего шага

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

8. Инструкция как валидация продукта

Этот документ — не справочник «как пользоваться», а валидационный артефакт пилота. Каждое расхождение между инструкцией и поведением системы считается продуктовой задачей, не «опечаткой в доке». Конкретные правила:

• Шаг 2 не находит «Технология → Изделия и детали» — это блокер: либо неправильное название раздела в инструкции, либо раздел переименован/убран в коде. Заводим задачу на меню/DSL-конфигурацию или на инструкцию.
• Список содержит < 24 или ≠ 24 изделий ВСП — задача на импорт или на demo-чистку дев-БД (вне ВСП).
• В списке ВСП виден чужой артикул (без префикса KOC-4505016987.) — критический блокер изоляции организаций.
• Карточка изделия открывается, но видны не 8 вкладок — задача на DSL-конфиг или на UI-роутинг.
• Вкладка «Технология» пуста у изделия, у которого должны быть операции — задача на пилотный виджет или на данные.
• Перекрёстный заход через koc-7203456955-admin показывает данные ВСП — критический блокер multi-tenancy.

Любое из этих отклонений → отдельная запись в обратной связи с скриншотом, идентификатором пользователя и временем. Любую такую ошибку считаем продуктовой, а не текстовой.

9. Что отложено

Сознательно не делаем сейчас:

• UI-загрузка Excel. Backend-импорт готов, UI-кнопка отдельной задачей.
• Полный перевод всех экранов на DSL. Планирование, рабочие места, склад, финансы пока через прежние страницы или не настроены в DSL-конфиге предприятия.
• Финальные промышленные виджеты карточки. Вкладки «Технология», «Спецификация», «Чертежи», «Make-or-Buy» работают как пилотные оболочки или базовые виджеты.
• Импорт данных персонала и планирования. Excel-шаблон по персоналу и планированию готов, но в этом пилотном цикле не загружается.
• Полный визуальный полишинг UI. Цветовая палитра, типографика, плотность, иконки — после доводки структурной обратной связи.
• Мобильный интерфейс. Отдельный проект.
• Публичный лендинг и маркетплейс. В этом разделе не рассматриваются.
• Доступ роли «технолог» / «мастер» / «оператор» / «диспетчер» — отдельный проход после прохода админа.

10. Дисциплина обновления документа

• После каждого видимого пользователю изменения пилота (новый экран, переименование вкладки, новый сценарий просмотра, изменение ожидаемых цифр) этот документ правится в том же релизе.
• В шапке ставится новая дата «Обновлено» и явная пометка статуса.
• Если изменение временно — оно отражается в §4 «Что пока пилотная оболочка».
• Если расхождение между инструкцией и интерфейсом нельзя устранить в текущем релизе — документ помечается баннером и ссылается на открытую задачу.
• Любое обновление инструкции — сигнал перепроверить актуальность скриншотов в /public/integrators/kocharin-pilot/.

11. Что будет после первого прохода

После того, как Андрей и интегратор прошли документ:

1. Замечания разбираются на пять групп:

Группа	Что туда попадает
Термины	Названия полей, вкладок, статусов, экранов
Данные	Не хватает полей / неверно разложены Excel-данные
UI	Неудобно читать, не хватает действий, плохая структура
Архитектура	Нужно менять модель данных или DSL-настройки
Отложено	Важно, но не блокирует пилот

2. Каждый блок становится отдельной волной: backend-фикс, новая DSL-конфигурация экрана, новый импорт и т.д. По каждой волне идёт та же дисциплина codex-ревью и evidence, что и по уже закрытому K-O2.
3. Этот документ обновляется после каждой волны.

Приложение. Данные пилота (ссылки на evidence)

Все ключевые показатели пилота закреплены evidence-файлами в рабочей ветке репозитория (раздел документации спринта мая):

• docs/sprint_2026_may/closed/2026-05/K-O2-split/phaseB10/README.md — обзор B10-evidence (cleanup-after-K-DSL2-демо, идемпотентность, изоляция организаций, маршрут одного изделия, кооперация).
• docs/sprint_2026_may/closed/2026-05/K-O2-split/phaseB10/checks.json — машинно-проверяемый снимок: счётчики, prefix-assertions, статусы cross-org GET, route-card, cooperation_routes.
• docs/sprint_2026_may/closed/2026-05/K-O2-split/phaseB10/idempotency_smoke_preflight.json — preflight второго --apply (Δ=0 по всем сущностям).

Эти ссылки — для интегратора-разработчика. Андрею достаточно цифр из §3.