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

2026-10-07 — Подгрузка согласованного чертежа в задаче «Запуск»

Статус: Реализовано

Источник: Максим

Эпик: ITR-3239

Объём эпика: только согласованный (подписанный покупателем) чертёж у товара заказа. Опросный лист, ТЗ от покупателя, фото — соседний эпик.

Две разные сущности (не путать)​

Чертёж на согласованиеСогласованный чертёж
Что этоЧертёж из справочника номенклатур, без отметки покупателяФайл уже подписанный покупателем (часто PDF, формат не ограничиваем)
Куда относитсяК номенклатуре (изделие)К конкретному заказу и товару (строка заказа покупателя)
Кто кладётКонструктор (своя папка / контур изделия)Менеджер продаж (основной путь) или менеджер производства (дозаполнение / корректировка)
Где файлПапка/место изделия (не этот эпик)Папка заказа покупателя
ДанныеСсылка на изделии; при создании документа чертежа не инициализировать флаги «Отправлен» / «Подписан …» (см. решение ниже)Ссылка + дата подписания у товара (без отдельного булева «согласован»)
В таблице товаровКолонка «Чертёж на согласование» — ссылка с изделияКолонка «Согласованный чертёж» (+ дата) — с товара
Этот эпикСсылку конструктора не трогаем; правка Create для Drawing; колонки в UI разводимДелаем загрузку и привязку

Цель​

Дать возможность привязать к товару подписанный покупателем файл согласованного чертежа (ссылка + дата), сохранить его в папке заказа покупателя и использовать эти данные в таблице заказа на производство и в расчёте даты запуска.

Основной путь: задача «Заказ покупателя. Запуск» (условие старта «… и согласования чертежа»), исполнитель — менеджер по продажам.

Дозаполнение и корректировка: менеджер производства — в форме заказа покупателя, пока заказ ещё не завершён: заполняет пустую графу «Согласованный чертёж» (типично после входа в производство без чертежа) или заменяет уже загруженный файл / дату — для корректировки или при ошибке.

После загрузки / дозаполнения система:

  1. сохраняет файл в папке заказа покупателя (если загружен файл);
  2. выставляет / обновляет у товара ссылку и дату подписания (по умолчанию — день загрузки, можно поправить);
  3. при создании таблицы заказа на производство заполняет ячейки листа заказа с товара (см. ниже; создание таблицы допускается и с пустой графой);
  4. при дозаполнении или замене после создания таблицы — обновляет те же ячейки и дату для расчёта даты запуска;
  5. чертёж на согласование на изделии и Google «Список изделий» этим действием не меняются.

Ячейки Google-таблицы заказа на производство (лист из шаблона)​

ЯчейкаСмыслОткуда при записи из ИС
B3Ссылка на согласованный чертёжСсылка у товара
E3Стадия: не требуется / требуется / согласованУсловие запуска + есть ли дата у товара
G3Флаг «чертёж согласован»Производное: есть дата у товара
I3Дата согласования чертежаДата подписания у товара

Уже существующий контур: трекер → синхронизация заказов​

Трекер периодически вызывает синхронизацию заказов на производство с Google. В ней уже есть чтение даты согласования из таблицы заказа (ячейка I3).

Было: при синхронизации дата (и признак) ошибочно могли уходить в чертёж на согласование изделия (номенклатура).

Сделано: контур чтения I3 (и B3) сохранён; место записи в ИС:

  • дата и ссылка → у товара (согласованный чертёж) и в данные заказа на производство, которые участвуют в расчёте даты запуска;
  • в изделие / чертёж на согласование номенклатуры из этого контура не пишем.

Контекст​

Как сейчас​

  • У изделия есть чертёж на согласование — ссылка из справочника номенклатур (без подписи покупателя).
  • В таблице товаров колонка часто показывает эту же ссылку; отдельного согласованного чертежа у товара нет.
  • Процессная ветка «чертёж на согласование» в runtime не активна.
  • Таблица заказа на производство при создании берёт ссылку/дату из данных изделия — смешение с согласованным чертежом заказа.

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

  1. Конструктор готовит чертёж на согласование на изделии (не этот эпик).
  2. Менеджер отправляет его покупателю; покупатель возвращает подписанный файл (часто PDF, возможен другой формат).
  3. В «Запуске» (при «… и согласования чертежа») менеджер продаж цепляет файл к товару (можно не заполнить и уйти дальше).
  4. Файл — в папке заказа; у товара — ссылка и дата согласованного чертежа.
  5. Если в производство ушли с пустой графой — менеджер производства дозаполняет согласованный чертёж в форме заказа покупателя (пока заказ не завершён). Там же он может заменить уже загруженный чертёж — для корректировки или при ошибке.
  6. В таблице товаров заказа две разные колонки: «Чертёж на согласование» показывает ссылку на чертёж из карточки изделия в справочнике (без подписи покупателя); «Согласованный чертёж» — ссылку (и дату) подписанного файла, привязанного к этой строке товара.
Изделие (номенклатура)              Товар в заказе покупателя
───────────────────────── ─────────────────────────
Чертёж на согласование Согласованный чертёж (этот эпик)
← конструктор ← продажи (Запуск) или
← без подписи покупателя производство (дозаполнение
← колонка в таблице товаров или корректировка)
← папка заказа покупателя
← ссылка + дата подписания

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

  1. Основной — продажи в «Запуске». Покупатель прислал подписанный файл; исполнитель «Запуска» для товара загружает его; дата = день загрузки (можно поправить). Файл в папке заказа; у товара — ссылка и дата. Чертёж на согласование у изделия не меняется.
  2. Ушли в производство без чертежа. Графа «Согласованный чертёж» пустая; создание таблицы заказа на производство допускается. Пока заказ покупателя не завершён, менеджер производства в форме заказа покупателя заполняет ссылку и дату; обновляются Google-таблица заказа на производство и расчёт даты запуска.
  3. Несколько товаров. По каждому товару-изделию — своя ссылка и дата.
  4. Условие запуска без согласования чертежа. UI загрузки согласованного чертежа в «Запуске» не показываем.
  5. Корректировка. Можно перезаписать ссылку и/или дату у товара: продажи — в «Запуске», менеджер производства — в форме заказа покупателя (заменить файл при ошибке или после корректировки), пока заказ не завершён.
  6. Просмотр таблицы товаров. Колонка «Чертёж на согласование» — ссылка из справочника (без подписи покупателя); подписанный файл — только в «Согласованный чертёж».

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

ТемаРешение
Объём эпикаТолько согласованный чертёж у товара; опросный лист / ТЗ / фото — отдельно
Не путать сЧертёж на согласование на изделии — ссылка конструктора остаётся
Флаги документа 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 и без полей чертежа.

Добавить в данные задачи (когда требуется согласование чертежа):

КудаЧто
buyerOrderForTaskconditionStartingWorkId и/или 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).

КудаЧто
GoodTableResponseagreedDrawingFileLink, 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 / трекера.
  • Массовая загрузка сразу на все товары заказа.

Связанные документы​