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.
Пользовательские сценарии
- Импорт комплектации из SolidWorks. Конструктор на заказе на производство загружает
.xlsxвыгрузки спецификации. В системе появляются строки комплектующих с количеством и единицей; несопоставленные с номенклатурой — в отчёте, без расхода до сопоставления. - Материалы вручную. Конструктор вносит/правит ведомость материалов отдельно (размеры, примечание при необходимости); автозаполнение материалов из выгрузки SolidWorks в MVP не делаем.
- Правка ведомости. Конструктор/технолог правит строки потребности вручную при необходимости.
- Свод снабженца. Снабженец видит по активным заказам позиции к сборке: нужно, собрано, не хватает, на складе, выдано.
- Сбор. Снабженец отмечает, сколько собрано (или отмечает позицию собранной). «Не хватает» = нужно − собрано.
- Готовность и расход. Когда позиции готовы к выдаче, снабженец подтверждает выдачу по заказу (или по выбранным строкам). Система проводит расход по складу, увеличивает «выдано»; остаток на складе уменьшается.
- Контроль по заказу. На ведомости заказа на производство видно актуальное нужно / собрано / не хватает / на складе / выдано.
- Стартовый импорт. При включении функционала один раз подтягиваются ведомости из 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. Фронт. Кеш ведомостей под SignalR | RTK-теги ведомости/свода под 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.