Перейти к основному содержимому

2026-10-22 — Комплектация склада (материалы и комплектующие)

Статус: Реализовано (v1) (карточка заказа на производство + ведомости + SolidWorks + «Сбор и выдача» + SignalR + уведомления технологу + ACL; разовый бэкофилл из Google — API есть, кнопки в UI нет → задача 17)

Источник / заказчик: Алексей; Олег

Эпик: ITR-3288

Связанные материалы:

  • ядро склада (реализовано): warehouse.md;
  • чат по заказу на производство (отдельный эпик): manufacture-order-chat.md (ITR-3378);
  • склад и продукция (user guide): warehouse-and-products.md;
  • права склада: warehouse.md;
  • черновик домена: резерв материалов — полноценный резерв вне этого эпика;
  • текущий контур: Google-файл заказа на производство + книга снабжения + ProductBalanceForm.

Цель​

Перенести в ИС рабочий контур ведомостей материалов и комплектующих по заказу на производство и сборки / выдачи со склада: конструктор вносит потребность, снабженец собирает и видит дефицит сбора, по готовности система проводит расход по заказу. Без синхронизации с Google после cutover — точка истины в ИС; для уже существующих заказов на производство — разовый импорт ведомостей.

Контекст​

Как сейчас​

Уже в ИС: карточка заказа на производство с вкладками «Общее» / «Комплектация» / «Материалы»; CRUD ведомостей потребностей; импорт комплектации из SolidWorks .xlsx; экран «Сбор и выдача» (/production-orders/summary) — свод, отметка собранного, выдача со склада; live-обновление ведомостей/свода; уведомления технологам при завершении сбора/выдачи по заказу.

Ещё не закрыто в эпике: разовый бэкофилл ведомостей из Google по старым заказам — на беке есть глобальный POST-импорт (идемпотентный по заказу + наименованию), в UI кнопки нет (задача 17, только Admin). Вне продукта по-прежнему листы заказать / заказано / реестр в Google.

Как должно быть​

  • Потребность (материалы + комплектующие) живёт в ИС у заказа на производство.
  • Конструктор импортирует комплектацию из выгрузки SolidWorks (.xlsx) и правит ведомости в системе; материалы вносит/считает вручную (из выгрузки спецификации материалы не строим).
  • Снабженец работает со сводом по заказам и с ведомостью заказа: сбор, остаток на складе, нехватка к сбору, выдача.
  • «Готово к выдаче» → пакетный расход по отмеченным позициям через уже существующие складские операции ядра (Рязань).
  • Google после cutover не зеркалим и не синхронизируем в обе стороны; разовый импорт ведомостей по заказам на производство, которые уже есть в ИС.

Выгрузка SolidWorks → комплектация (ITR-3436)​

Рабочий файл конструктора: .xlsx, имя вида 7410 Сквозн.xlsx (номер заказа + суффикс выгрузки). CSV может использоваться только для разбора/анализа — в продукт принимаем .xlsx.

Типичные колонки выгрузки спецификации (одна таблица):

КолонкаСмысл
ФорматФормат чертежа / тип строки (может быть многострочным)
ЗонаЗона (часто пусто)
Поз.Порядковый номер позиции
ОбозначениеОбозначение детали/узла; у покупных часто пусто
НаименованиеИмя позиции (ГОСТ/DIN у крепежа; краткое имя у изготавливаемых)
Кол.Количество на изделие / в спецификации
ПримечаниеСвободный текст; иногда единица («мм»), пометки вроде «лазер …»

В выгрузке смешаны покупные позиции (крепёж, магниты и т.п.) и изготавливаемые (с обозначением). Импорт в ИС заполняет ведомость комплектующих (потребность типа комплектация): нужно, наименование, единица при возможности, сопоставление с номенклатурой по имени.

Ориентир UX комплектации «как сейчас в Google» (комплектовочная ведомость заказа): наименование, кол., ед., скомплектовано / собрано / не хватает / выдано — в ИС те же смыслы через модель потребности (см. выше), без обязательной галочки «скомплектовано» как отдельной сущности.

Вне этого эпика (для понимания процесса, не делаем)​

  • Листы заказать / заказано (поставщики, счета, сроки).
  • Реестр (оплаты, согласование «оплатить / пояснить»).
  • Полноценный резерв материалов (бронь под заказ/строку, влияние на свободный остаток).
  • Обрезки, ОТК / входной контроль, Глазов.
  • Зеркало ИС ↔ Google по ведомостям после cutover.

Пользовательские сценарии​

  1. Импорт комплектации из SolidWorks. Конструктор на заказе на производство загружает .xlsx выгрузки спецификации. В системе появляются строки комплектующих с количеством и единицей; несопоставленные с номенклатурой — в отчёте, без расхода до сопоставления.
  2. Материалы вручную. Конструктор вносит/правит ведомость материалов отдельно (размеры, примечание при необходимости); автозаполнение материалов из выгрузки SolidWorks в MVP не делаем.
  3. Правка ведомости. Конструктор/технолог правит строки потребности вручную при необходимости.
  4. Свод снабженца. Снабженец видит по активным заказам позиции к сборке: нужно, собрано, не хватает, на складе, выдано.
  5. Сбор. Снабженец отмечает, сколько собрано (или отмечает позицию собранной). «Не хватает» = нужно − собрано.
  6. Готовность и расход. Когда позиции готовы к выдаче, снабженец подтверждает выдачу по заказу (или по выбранным строкам). Система проводит расход по складу, увеличивает «выдано»; остаток на складе уменьшается.
  7. Контроль по заказу. На ведомости заказа на производство видно актуальное нужно / собрано / не хватает / на складе / выдано.
  8. Стартовый импорт. При включении функционала один раз подтягиваются ведомости из Google по существующим в ИС заказам на производство (насколько данные сопоставимы с номенклатурой).

Модель для пользователя (MVP)​

Одинаковая логика статусов для материалов и комплектующих (без резерва):

ПолеСмысл
НужноПотребность по строке ведомости
СобраноСколько физически собрали под заказ
Не хватаетнужно − собрано
На складеТекущий остаток номенклатуры в целом (не бронь под заказ)
ВыданоСколько списано со склада / выдано в производство по этой строке

Дополнительно у материалов в ведомости: размер1, размер2, примечание (как в текущей выгрузке) — для идентификации раскроя, без семантики резерва.

«Скомплектовано» в Sheets (галочка) в MVP можно заменить явным состоянием строки или достаточностью «собрано ≥ нужно» — без отдельной сложной машины состояний.

Принятые решения​

ТемаРешение
Scope MVPМатериалы и комплектующие сразу
Импорт SolidWorksФайл .xlsx (пример имени: 7410 Сквозн.xlsx); заполняет только комплектацию
МатериалыКонструктор считает и вносит вручную; из выгрузки спецификации не выводим
Импорт Excel в модель/API v1Вынесен в отдельную задачу ITR-3436, не блокирует модель/сбор/выдачу
Точка истиныИС; Google-синк ведомостей не делаем
МиграцияРазовый импорт ведомостей по существующим заказам на производство в ИС
Закупки и реестрНе в этом релизе
Резерв материаловНе в этом релизе; только отображение нужно / собрано / не хватает / на складе / выдано
«На складе»Общий остаток по складской единице, без привязки брони к строке
РасходЧерез операции ядра склада; нельзя списать больше остатка
ВыдачаЧастичная в пределах «собрано − уже выдано» и остатка на складе
ПлощадкаРязань (как ядро)
Чат заказа на производствоОтдельный эпик ITR-3378
Обрезки / ОТК / ГлазовПоследующие эпики

Критерии приёмки​

  • На заказе на производство есть ведомости материалов и комплектующих; строки можно править вручную.
  • Конструктор может импортировать комплектацию из .xlsx выгрузки SolidWorks (ITR-3436); материалы из этой выгрузки не создаются.
  • Снабженец видит свод по заказам и прогресс сбора (нужно / собрано / не хватает / на складе / выдано) — экран «Сбор и выдача».
  • Подтверждение выдачи проводит расход по складу и обновляет «выдано».
  • Расход больше остатка отклоняется; нельзя выдать больше, чем собрано за вычетом уже выданного.
  • Нет модели резерва и нет влияния «брони» на свободный остаток.
  • Нет экранов «заказать» / «заказано» / «реестр» в этом релизе.
  • Выполнен разовый импорт ведомостей по существующим заказам на производство (с отчётом о несопоставленных строках) — API готов; UI для Admin — задача 17; после прогона cutover отметить выполненным.
  • Права: конструктор/технолог — ведомость потребности и импорт .xlsx; снабженец — сбор и выдача; технолог — просмотр свода и остатков; КБ/технолог/снаб — просмотр списка заказов на производство и СЕ.
  • Обновлены user docs и права склада (по выкладке свода/выдачи).

Вне scope​

  • «Заказать» / «заказано» / реестр оплат.
  • Полноценный резерв (бронь под заказ/строку).
  • Обрезки, ОТК, Глазов.
  • Зеркало в Google после cutover.
  • Чат по заказу на производство (ITR-3378).
  • Автозаполнение материалов из выгрузки SolidWorks.
  • Восстановление иерархии узлов и отдельная страница «Спецификация» заказа на производство — до продуктового решения (см. открытые вопросы).

Открытые вопросы​

ВопросДефолт / статус
Формат выгрузки SolidWorks для импорта комплектацииЗафиксировано: .xlsx (пример 7410 Сквозн.xlsx), колонки формат / зона / поз. / обозначение / наименование / кол. / примечание
Выдача только полностью собранных строк или частичнаяПринято: частичная в пределах «собрано» и остатка
Сопоставление импорта с номенклатурой ИСПо наименованию складской единицы; несопоставленные — в отчёт, строка без расхода до сопоставления
Можно ли и нужно ли определять узлы по выгрузке спецификации SolidWorks?Открыто — в ITR-3436 не делаем
Нужна ли сразу страница спецификации заказа на производство (детали / узлы / кол-во на ед., как отдельный Google-лист «Спецификация»)?Открыто — не блокер комплектации; при «да» — отдельная задача/эпик

Задачи эпика​

#ЗадачаСодержаниеСтатус
1Задача 1. Бек. Модель ведомостей и API потребностиХранение строк материалов и комплектующих у заказа на производство; CRUD; поля нужно / размеры / примечание (без Excel-импорта)Сделано
2Задача 2. Бек. Сбор, выдача и пакетный расходУчёт собрано / выдано; расчёт не хватает; выдача → складские расходы ядра; праваСделано
3Задача 3. Бек. Разовый импорт из GoogleИмпорт ведомостей существующих заказов на производство; отчёт несопоставленных (глобальный POST; матч заказ + наименование, без дублей при повторном вызове)Сделано (API)
4Задача 4. Бек. Импорт потребностей из SolidWorksПарсинг .xlsx выгрузки; заполнение комплектации заказа; отчёт несопоставленных (ITR-3436)Сделано
5Задача 5. Фронт. Карточка заказа на производствоВкладка/маршрут заказа; шапка; боковые вкладки; открытие из таблицыСделано
6Задача 6. Фронт. Ведомости на карточке заказа на производствоПросмотр/правка материалов и комплектующих на карточке (YouGile ITR-3417)Сделано
7Задача 7. Фронт. Импорт комплектации из .xlsxЗагрузка выгрузки SolidWorks на вкладке «Комплектация»; отчёт несопоставленныхСделано
8Задача 8. Фронт. Свод снабженца и выдачаСвод по заказам; отметка сбора; подтверждение выдачи / расхода; ссылка на карточкуСделано
9Задача 9. Бек. SignalR-инвалидация ведомостейРассылка InvalidateCache при изменении потребностей; свод и карточка без F5Сделано
10Задача 10. Фронт. Кеш ведомостей под SignalRRTK-теги ведомости/свода под InvalidateCache; без уведомлений в колокольчикСделано
11Задача 11. Бек. Уведомление о готовности комплектацииСобытие «собрано / выдано» → уведомление пользователям с ролью технолог (триггер зафиксировать)Сделано
12Задача 12. Документация. User docs и праваСклад / комплектация; связь с ядром; что не входит (резерв, закупки, узлы/спецификация до решения)Сделано (по своду/выдаче; бэкофилл Google — отдельно)
13Задача 13. Фронт. Свод: галка полного сбора и валидация «Собрано»Узкая колонка-галка (иконка+tooltip в шапке); вкл → собрано=нужно; выкл → прежнее (< нужно) иначе 0; невалидный ввод — красная ячейка + tooltipСделано (в составе свода)
14Задача 14. Фронт. Выдача по заказу со сводаМодалка пакетной выдачи; прогноз «закроются полностью»; построчная выдача остаётся; без резерваСделано
15Задача 15. Фронт (+ бек роли GET). Доступы КБ / технолог / снабСписок заказов на производство = карточка; технолог — изделия + V свод/остатки; КБ/технолог — V СЕ; расширить AuthorizeRoles на GETСделано
16Задача 16. Бек + фронт. Edit ведомостей только назначенному конструкторуОтложено: пока edit любому Designer и ChiefDesigner (и Technologist как сейчас); привязку к Product.Designer не вводимОтложено
17Задача 17. Фронт. Кнопка разового импорта ведомостей из Google (Admin)Кнопка только для Admin; вызов глобального POST; отчёт add/update/warnings; на беке добавить Admin в AuthorizeRoles; подтверждение перед запускомДальше

Порядок: 1 → 2; 3 и 4 можно параллельно после модели; фронт: 5 → 6; 7 после задачи 4 (+ контракт импорта); 8 после задачи 2 (можно параллельно с 6); 9 → 10 после появления мутаций (после 1–2 и желательно 6/8); 11 после фиксации триггера (после 2); 12 к приёмке; 13–14 после задачи 8; 15 можно параллельно с 8 (ACL); 16 — позже; 17 — cutover после задачи 3 (API), можно после закрытия MVP 1–15.