2026-10-07 — Подгрузка согласованного чертежа в задаче «Запуск»
Статус: Реализовано
Источник: Максим
Эпик: ITR-3239
Объём эпика: только согласованный (подписанный покупателем) чертёж у товара заказа. Опросный лист, ТЗ от покупателя, фото — соседний эпик.
Две разные сущности (не путать)
| Чертёж на согласование | Согласованный чертёж | |
|---|---|---|
| Что это | Чертёж из справочника номенклатур, без отметки покупателя | Файл уже подписанный покупателем (часто PDF, формат не ограничиваем) |
| Куда относится | К номенклатуре (изделие) | К конкретному заказу и товару (строка заказа покупателя) |
| Кто кладёт | Конструктор (своя папка / контур изделия) | Менеджер продаж (основной путь) или менеджер производства (дозаполнение / корректировка) |
| Где файл | Папка/место изделия (не этот эпик) | Папка заказа покупателя |
| Данные | Ссылка на изделии; при создании документа чертежа не инициализировать флаги «Отправлен» / «Подписан …» (см. решение ниже) | Ссылка + дата подписания у товара (без отдельного булева «согласован») |
| В таблице товаров | Колонка «Чертёж на согласование» — ссылка с изделия | Колонка «Согласованный чертёж» (+ дата) — с товара |
| Этот эпик | Ссылку конструктора не трогаем; правка Create для Drawing; колонки в UI разводим | Делаем загрузку и привязку |
Цель
Дать возможность привязать к товару подписанный покупателем файл согласованного чертежа (ссылка + дата), сохранить его в папке заказа покупателя и использовать эти данные в таблице заказа на производство и в расчёте даты запуска.
Основной путь: задача «Заказ покупателя. Запуск» (условие старта «… и согласования чертежа»), исполнитель — менеджер по продажам.
Дозаполнение и корректировка: менеджер производства — в форме заказа покупателя, пока заказ ещё не завершён: заполняет пустую графу «Согласованный чертёж» (типично после входа в производство без чертежа) или заменяет уже загруженный файл / дату — для корректировки или при ошибке.
После загрузки / дозаполнения система:
- сохраняет файл в папке заказа покупателя (если загружен файл);
- выставляет / обновляет у товара ссылку и дату подписания (по умолчанию — день загрузки, можно поправить);
- при создании таблицы заказа на производство заполняет ячейки листа заказа с товара (см. ниже; создание таблицы допускается и с пустой графой);
- при дозаполнении или замене после создания таблицы — обновляет те же ячейки и дату для расчёта даты запуска;
- чертёж на согласование на изделии и Google «Список изделий» этим действием не меняются.
Ячейки Google-таблицы заказа на производство (лист из шаблона)
| Ячейка | Смысл | Откуда при записи из ИС |
|---|---|---|
| B3 | Ссылка на согласованный чертёж | Ссылка у товара |
| E3 | Стадия: не требуется / требуется / согласован | Условие запуска + есть ли дата у товара |
| G3 | Флаг «чертёж согласован» | Производное: есть дата у товара |
| I3 | Дата согласования чертежа | Дата подписания у товара |
Уже существующий контур: трекер → синхронизация заказов
Трекер периодически вызывает синхронизацию заказов на производство с Google. В ней уже есть чтение даты согласования из таблицы заказа (ячейка I3).
Было: при синхронизации дата (и признак) ошибочно могли уходить в чертёж на согласование изделия (номенклатура).
Сделано: контур чтения I3 (и B3) сохранён; место записи в ИС:
- дата и ссылка → у товара (согласованный чертёж) и в данные заказа на производство, которые участвуют в расчёте даты запуска;
- в изделие / чертёж на согласование номенклатуры из этого контура не пишем.
Контекст
Как сейчас
- У изделия есть чертёж на согласование — ссылка из справочника номенклатур (без подписи покупателя).
- В таблице товаров колонка часто показывает эту же ссылку; отдельного согласованного чертежа у товара нет.
- Процессная ветка «чертёж на согласование» в runtime не активна.
- Таблица заказа на производство при создании берёт ссылку/дату из данных изделия — смешение с согласованным чертежом заказа.
Как должно быть
- Конструктор готовит чертёж на согласование на изделии (не этот эпик).
- Менеджер отправляет его покупателю; покупатель возвращает подписанный файл (часто PDF, возможен другой формат).
- В «Запуске» (при «… и согласования чертежа») менеджер продаж цепляет файл к товару (можно не заполнить и уйти дальше).
- Файл — в папке заказа; у товара — ссылка и дата согласованного чертежа.
- Если в производство ушли с пустой графой — менеджер производства дозаполняет согласованный чертёж в форме заказа покупателя (пока заказ не завершён). Там же он может заменить уже загруженный чертёж — для корректировки или при ошибке.
- В таблице товаров заказа две разные колонки: «Чертёж на согласование» показывает ссылку на чертёж из карточки изделия в справочнике (без подписи покупателя); «Согласованный чертёж» — ссылку (и дату) подписанного файла, привязанного к этой строке товара.
Изделие (номенклатура) Товар в заказе покупателя
───────────────────────── ─────────────────────────
Чертёж на согласование Согласованный чертёж (этот эпик)
← конструктор ← продажи (Запуск) или
← без подписи покупателя производство (дозаполнение
← колонка в таблице товаров или корректировка)
← папка заказа покупателя
← ссылка + дата подписания
Пользовательские сценарии
- Основной — продажи в «Запуске». Покупатель прислал подписанный файл; исполнитель «Запуска» для товара загружает его; дата = день загрузки (можно поправить). Файл в папке заказа; у товара — ссылка и дата. Чертёж на согласование у изделия не меняется.
- Ушли в производство без чертежа. Графа «Согласованный чертёж» пустая; создание таблицы заказа на производство допускается. Пока заказ покупателя не завершён, менеджер производства в форме заказа покупателя заполняет ссылку и дату; обновляются Google-таблица заказа на производство и расчёт даты запуска.
- Несколько товаров. По каждому товару-изделию — своя ссылка и дата.
- Условие запуска без согласования чертежа. UI загрузки согласованного чертежа в «Запуске» не показываем.
- Корректировка. Можно перезаписать ссылку и/или дату у товара: продажи — в «Запуске», менеджер производства — в форме заказа покупателя (заменить файл при ошибке или после корректировки), пока заказ не завершён.
- Просмотр таблицы товаров. Колонка «Чертёж на согласование» — ссылка из справочника (без подписи покупателя); подписанный файл — только в «Согласованный чертёж».
Принятые решения
| Тема | Решение |
|---|---|
| Объём эпика | Только согласованный чертёж у товара; опросный лист / ТЗ / фото — отдельно |
| Не путать с | Чертёж на согласование на изделии — ссылка конструктора остаётся |
| Флаги документа Drawing при создании | В DocumentTypeExt.Create для Drawing: Sent / SignedByManagement / SignedByClient = null (как у Design / Model3D), Approved = false. Сейчас Sent и SignedByClient = false — из‑за этого на чертеже изделия светится «Подписан …». Факт согласования покупателем — только у согласованного чертежа товара |
| Колонка «Чертёж на согласование» в таблице товаров | Ссылка из справочника номенклатур (изделие), без отметки покупателя |
| Колонка «Согласованный чертёж» | Ссылка (+ дата) с товара |
| Основной путь | Задача «Запуск», менеджер продаж (исполнитель), после подписанного файла от покупателя |
| Дозаполнение / корректировка | Менеджер производства в форме заказа покупателя, пока заказ не завершён: заполнить пустую графу или заменить загруженный чертёж (корректировка, ошибка) |
| Когда UI в «Запуске» | Только при условии запуска «… и согласования чертежа» |
| Обязательность до создания таблицы | Не обязательна — можно создать таблицу / зайти в производство с пустой графой |
| Формат файла | PDF в сценариях — пример; чертёж может прийти в другом формате. На беке не ограничивать расширение/MIME (проверку «только PDF» не делаем) |
| Привязка | К товару заказа |
| Хранение файла | Папка заказа покупателя |
| Что пишем у товара | Ссылка + дата подписания; булев «согласован» не нужен |
| Дата подписания | По умолчанию = день загрузки, можно поправить |
| Перезапись | Разрешена |
| Google «Список изделий» | Не обновляем этим действием |
| Таблица заказа на производство | B3 ссылка, E3 стадия, G3 флаг, I3 дата — из данных товара / условия запуска; при дозаполнении — обновить ячейки |
| Синхронизация Google ← трекер | Контур чтения I3 (и связанных полей) оставляем; писать в ИС в товар + заказ на производство, не в чертёж изделия |
| Расчёт даты запуска | Участвует дата подписания с товара / заказа на производство |
| Полная ветка «чертёж на согласование» | Не включаем |
Отложено (не этот эпик)
- После включения полной ветки задач «чертёж на согласование»: загрузку из «Запуска» убрать или оставить — решить при реализации той ветки.
Контракт данных для UI (респонсы)
Общие поля согласованного чертежа на товаре (везде одинаковый смысл):
| Поле | Смысл |
|---|---|
agreedDrawingFileLink | Ссылка на подписанный файл (согласованный чертёж заказа) |
agreedDrawingSignDate | Дата подписания (unix / как остальные даты в API) |
Чертёж на согласование из номенклатуры не подменять этими полями: в таблице товаров по-прежнему отдельное поле drawing / ссылка с изделия.
Признак «нужен UI согласованного чертежа» — условие запуска «… и согласования чертежа» (AfterPrepaymentAndApproval / AfterSigningSpecificationAndApproval). Удобно отдать явно: requiresDrawingApproval: bool или conditionStartingWorkId там, где фронт ещё не видит полный заказ.
Задача «Запуск» (TaskData / SigningSpecification)
Сейчас: buyerOrderForTask без условия запуска; список orderGoods только в статусе CreatingOrders и без полей чертежа.
Добавить в данные задачи (когда требуется согласование чертежа):
| Куда | Что |
|---|---|
buyerOrderForTask | conditionStartingWorkId и/или requiresDrawingApproval |
| Список товаров для блока загрузки (не только CreatingOrders) | По товарам-изделиям: id, name, productId, agreedDrawingFileLink, agreedDrawingSignDate; опционально read-only ссылка чертежа на согласование с изделия для подсказки |
| Уже есть | filesFolder — папка заказа для загрузки файла |
Практически: расширить GoodForCreateOrderTaskResponse полями согласованного чертежа и отдавать этот список на статусах, где менеджер продаж цепляет файл (как минимум на подписании у покупателя / в работе и в CreatingOrders — уточнить при фронте; минимум — везде, где показывается блок загрузки).
Форма подписания (если требуется согласование чертежа):
- флаг/условие запуска → показать блок;
- по каждому изделию: текущие
agreedDrawingFileLink+agreedDrawingSignDate; filesFolderдля upload;- после upload — ответ API с обновлёнными link/date (или refetch
TaskData).
Форма заказов на производство / CreatingOrders (если требуется согласование чертежа):
- те же поля в
orderGoods:agreedDrawingFileLink,agreedDrawingSignDate(просмотр / правка по согласованным правам); - создание таблицы не блокировать при пустых полях;
productIdуже есть — для фильтра «только изделия».
Форма / таблица заказа покупателя (дозаполнение производством)
Источник товаров — обычный список товаров заказа (GoodTableResponse).
| Куда | Что |
|---|---|
GoodTableResponse | agreedDrawingFileLink, agreedDrawingSignDate |
GoodTableResponse.drawing | как сейчас — чертёж на согласование с изделия (без подписи покупателя) |
| Карточка заказа | conditionStartingWork уже есть — для показа колонок/блока; state — заказ не завершён |
Прочее
| Респонс | Нужно |
|---|---|
| Ответ upload / PATCH согласованного чертежа | agreedDrawingFileLink, agreedDrawingSignDate (и id товара) |
| Google / трекер | не респонс UI; пишут в те же поля товара + даты заказа на производство |
Задачи эпика
| # | Задача | Содержание |
|---|---|---|
| 1 | Задача 1. Бек. Поля у товара, Create(Drawing), API загрузки | Ссылка + дата на товаре; миграция; Create для Drawing; API; поля в GoodTableResponse / GoodForCreateOrderTaskResponse; requiresDrawingApproval или conditionStartingWorkId в данных «Запуска» |
| 2 | Задача 2. Бек. Google-таблица и синхронизация трекера | B3/E3/G3/I3 с товара; sync I3→товар/Order.Dates; дата запуска |
| 3 | Задача 3. Фронт. «Запуск» и таблица товаров | Блок загрузки по данным TaskData; колонки в таблице товаров |
| 4 | Задача 4. Фронт. Дозаполнение в форме заказа покупателя | По GoodTableResponse + состояние заказа |
| 5 | Задача 5. Документация. User docs и карта | signingSpecification, good/product, googleTable, cursor-architecture |
Критерии приёмки
- В задаче «Запуск» при условии «… и согласования чертежа» менеджер продаж может подгрузить файл согласованного чертежа к товару и задать дату подписания (формат не только PDF).
- При условии без согласования чертежа блок в «Запуске» не показывается.
- Загрузка в «Запуске» не обязательна для создания таблицы заказа на производство.
- В форме заказа покупателя, пока заказ не завершён, менеджер производства может дозаполнить ссылку и дату согласованного чертежа или заменить уже загруженные; Google-таблица и расчёт даты запуска учитывают данные.
- Файл в папке заказа покупателя; у товара — ссылка и дата (без булева).
- Дата по умолчанию = день загрузки; можно изменить.
- Ссылка чертежа на согласование у изделия загрузкой согласованного файла не меняется.
- Новый чертёж на согласование изделия создаётся без флагов «Отправлен» / «Подписан клиентом» / «Подписан руководством» (
Createдля Drawing — как у Design). - В таблице товаров колонка «Чертёж на согласование» показывает ссылку из номенклатуры (без подписи покупателя).
- Подписанный файл виден как согласованный чертёж товара (отдельная колонка / поле).
- Google «Список изделий» из этого действия не обновляется.
- В Google-таблице заказа на производство: B3 — ссылка, E3 — стадия, G3 — флаг, I3 — дата (из товара / условия запуска).
- Синхронизация через трекер: дата из I3 → у товара / заказа на производство, не в чертёж изделия.
- Дата участвует в расчёте даты запуска заказа на производство.
- Повторная загрузка / смена даты перезаписывает данные у товара (продажи в «Запуске»; производство — в форме заказа покупателя, в т. ч. при уже заполненной графе).
- User docs и карта обновлены.
Вне scope
- Опросный лист, ТЗ от покупателя, фото от покупателя.
- Загрузка / смена чертежа на согласование на изделии (конструктор).
- Автообновление Google «Список изделий».
- Включение полной ветки задач «чертёж на согласование».
- Автозаполнение признака/даты согласования на чертеже изделия (номенклатура) из Google / трекера.
- Массовая загрузка сразу на все товары заказа.