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

Карта системы для Cursor

Рабочая карта для агента и разработки. Не заменяет пользовательские процессы и не является ТЗ.

Правило чтения:

  1. Эта страница — сжатый ориентир после изучения кода.
  2. Пользовательские docs дают термины и замысел, но местами отстают.
  3. Requirements (80-agreements/requirements/) — ближе к ТЗ: замысел функционала до/во время реализации (см. ниже).
  4. При расхождении смотреть код: бек = правила процесса, фронт = UX.

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

Проекты: фронт OlMag.Manufacture, бек OlMag.Manufacture.Api, трекер OlMag.Tracking, документация documentation.

Документация: слои​

СлойГдеДля когоСуть
Requirements80-agreements/requirements/*.mdзаказчик, аналитик, разработчикБлизко к ТЗ для согласования: поведение, решения, критерии приёмки; без имён кода и API. Детали реализации — в коде и cursor-architecture.md.
Журнал требованийrequirements-log.mdзаказчик, аналитикОтдельные договорённости вне эпиков; не журнал для requirements/.
Карта системыэтот файлагент, разработчикСжатая выжимка по факту кода; не ТЗ.
Пользовательские страницы2.Заказы/, 70. Рабочий процесс/, …пользователь, поддержкаКак работает система в UI; местами отстают от кода.
Архитектура / аудит10-architecture/разработчикМодель, сверка docs↔код; аудит может устаревать.

Новые requirements: имя файла по функции (document-facsimile.md), пункт в documentation/sidebars.ts (категория «Эпики» → «В работе» или «Реализовано» по статусу; внутри — по дате, новые сверху). Пути файлов не менять. Правило: .cursor/rules/documentation.mdc.

Система​

1С (выгрузка в бухгалтерию, эпик ITR-3083 — реализовано v1): ИС → XML (ФайлОбмена) → загрузка в Бухгалтерию; месяц + номенклатура; бухгалтер (превью + скачать); авто вне эпика. v1: код org в 1С полноценно для ПК ОлМаг; остальные наши org — после теста на боевой 1С. В табличных частях счетов на оплату и услуг ЕдиницаИзмерения не пишется (withUnit: false) — 1С берёт единицу из номенклатуры. Валюта в XML — код 643 (не литерал RUB); на договоре обязательно ВалютаВзаиморасчетов. В СФ не писать СчетФактураВыданныйВЭлектронномВиде (иначе загрузка СФ падает). ТЗ: export-1c.md. Карта: export-1c-field-map.md. Импорт Excel из 1С → ИС — отдельно (1C.md, import-1c-audit.md).

Контексты бека: LogicContext (workflow), OrderContext, WarehouseContext, ProductContext, TaskManagerContext, Identity, Employee, Notification.

Auth: Identity login → accessToken + refresh cookie → GET /User/fromToken. Фронт: RequireAuthRoute по ролям меню.

Логи и клиентские ошибки (ITR-3097)​

На stage (бек #756 / ITR-3099+3100, фронт #789 / ITR-3100).

  • Бек: Serilog → файлы / S3; middleware отдаёт X-Request-Id (= RequestId в логах); приём POST …/ClientDiagnostics/error.
  • Фронт шлёт сбои (axios interceptor, Error Boundary, window / unhandledrejection), кроме HTTP 4xx и 500 → в лог строка UX error:; корреляция исходного API — свойство FrontendRequestId.
  • Искать: фильтр UX error: → FrontendRequestId → тот же id как RequestId у бизнес-запроса. Памятка: integrations.md. ТЗ: client-error-logging.md.

Домен​

Пользователь не двигает заказ по состояниям вручную: выполняет задачу → система создаёт следующий этап и меняет state заказа.

СущностьСмысл
PartnerПокупатель/поставщик, группа доступа, DaData (РФ / Беларусь УНП / Казахстан БИН; при 12 цифрах — выбор РФ или КЗ). Foreign-режим: форма «Иностранная организация» / foreign-реквизиты / страна ≠ Россия; конфликт с явной Россией; налоговый номер в ИНН до 20 цифр; НДС 0% в заказе. Заказ через контактное лицо.
BuyerOrderКоммерция, товары, КП, спецификация, договор, условие запуска, оплаты, отгрузки. Ответственный = менеджер продаж. Сопровождающий = менеджер производства.
GoodВсегда на SKU. Категория «изделие» → производство/КД.
SKU / ProductНоменклатура склада (json-параметры). Изделие = SKU категории «Изделие» + КД.
OrderЗаказ на производство. Создаётся на запуске на каждое изделие. Процесс в docs почти пустой.
План оплат% в заказе → PaymentSchedule → PaymentInvoice → InvoicePayment (выписка).
Счёт-договорEnContractType.Invoice + документ InvoiceContract: один договор на один BuyerOrder; путь без обязательной спецификации; предоплата авто при плане. ТЗ: invoice-contract.md (ITR-3252; остатки UI — ITR-3372).
Задача / процессИсполнитель, статусы, состояние. Корректировка — отдельная машина.

Роли ядра: менеджер продаж, помощник, начальник продаж, бухгалтер, снабженец, главный конструктор, конструктор, начальник производства, менеджер производства. Несколько ролей разных направлений вместе не предполагаются; исключения: начальник продаж + менеджер продаж; менеджер продаж + помощник. При SM+Assistant: создание заказа как менеджер (isAssistantOnly / Add без ManagerRelation на себя); доступ к заказам — union (свои + связанные менеджеры), не else if поверх помощника.

Admin: только просмотр («видит всё» по маршрутам и полям). Создание/редактирование/удаление — только если у пользователя есть другая роль с правом edit на этой странице. На фронте: canEdit = userRoles.some(r => editRoles.includes(r)), не !includes(ADMIN). Правило: .cursor/rules/admin-role.mdc.

Доступ = роль + связь с заказом/задачей + статус + не в корректировке.

Процессы​

  1. Заказ покупателя — главный.
  2. Создание изделия / SKU — автор → согласование руководителем. Начальник продаж и главный конструктор создают сразу.
  3. Пользовательский — задача + контроль.

Ветка чертежа на согласование в processBuyerOrder.md есть, в runtime не активна (создание задач после запуска закомментировано).

Согласованный чертёж (ITR-3239, реализовано): не путать чертёж на согласование (номенклатура / Product.Drawing; колонка в таблице товаров; Create(Drawing) — Sent/SignedBy* = null) и согласованный чертёж (Good.AgreedDrawingLink + AgreedDrawingSignDate, папка заказа; формат не только PDF). Основной путь — продажи в «Запуске» при *AndApproval; дозаполнение / замена — производство в форме заказа покупателя (заказ не завершён; кнопка загрузки видна и при уже заполненной графе — корректировка, ошибка; бек перезапись не ограничивает). Google B3/E3/G3/I3 и sync трекера → Good/Order.Dates, не изделие. ТЗ: specification-agreed-drawing.md.

Заказ покупателя (живой путь)​

Сбор → расчёт (пропуск по актуальному РРЦ) → КП (NotRequired пропускает согласования КП) → спецификация (NotRequired пропускает согласование спецификации) → запуск → сопровождение.

При завершении согласования КП с покупателем (SigningCommercialProposal) обязательна дата отправления КП клиенту (CommercialProposal.SentDate, ITR-3212).

Условие запуска: после подписания спецификации / после предоплаты; варианты «и согласования чертежа» не крутят полную ветку задач чертежа; для них — UI согласованного чертежа у товара в «Запуске» + дозаполнение производством (ITR-3239, реализовано).

Сопровождение: есть изделия → менеджер производства + заказы на производство; нет изделий → менеджер продаж.

Пауза/отмена — кнопки в карточке заказа, не статусы задачи.

Карты в docs: processBuyerOrder.md (замысел), processBuyerOrderBackendRules.md и paymentPlanMap.md (ближе к коду), process-audit.md (сверка, тоже может отставать).

Бек: движок задач​

Точка входа: TaskController → TaskService.ChangeStatus.

Граф в enum: EnTaskProcessType → EnTaskType → EnTaskStatus → EnTaskState.

Смена статуса:

  1. доступ на редактирование;
  2. статус в GetAvailableStatuses (+ фильтры: нельзя NotRequired у спецификации при условии «после подписания»; без предоплаты убираются invoicing / ожидание оплаты);
  3. финал (Completed / Agree / NotRequired / Deleted / Skipped / Rejected): CheckFinalData → SetFinalData → закрыть fix или TaskDone;
  4. иначе: CheckInterimData → SetInterimData → записать статус.

Проверки: TaskConditionHandler. Промежуточные — КП, подписание КП, спецификация, запуск, сопровождение. Финальные — сбор, расчёт, КП, подписание КП, спецификация, запуск, часть чертежей, сопровождение. Согласования начальником часто без полей.

TaskDone не реализован для CreateDesign и AssignPerformerDrawing. CreateBuyerOrder и AssignMaintainer — Obsolete. Процессы изменения изделия/SKU в enum пустые.

Цепочка задач в процессе всегда полная по пройденному пути. Отсутствующих «ещё не созданных» этапов позади текущей задачи нет: если этап не нужен, задача всё равно создаётся со статусом Skipped («Пропущена»), иногда после NotRequired на предыдущем шаге (типовой пример: КП не требуется → согласование и подписание КП создаются как Skipped, дальше спецификация). Искать задачу типа X в процессе «до» текущей — нормально; «не нашли = этапа не было» для уже пройденного хвоста неверно — чаще она есть и Skipped/NotRequired/Completed. Имеет смысл при auto-fix / split / откатах.

Код: Services/UserTask/Services/TaskService.cs, TaskConditionHandler.cs, Data/Enums/EnTask*.cs.

Корректировки (FixRequest / Fix)​

Отдельная машина поверх статусов задачи. Docs: 70. Рабочий процесс/FixTask.md.

Сущности: FixRequest (источник → приёмник, закрывается через Continue) + цепочка Fix по задачам (Awaiting → InProgress / Completed / NotRequired / Canceled).

Статусы задачи: ReadyForFix, CheckingForFix, FixInProgress, FixIsCompleted, FixIsRejected. Прямая смена через ChangeStatus запрещена (allowCorrectionStatuses).

Вложенные корректировки (новая из задачи, которая сама в цепочке другой) — нормальный сценарий. FixRequest.CompleteDate ставится только на Continue у источника, поэтому несколько незакрытых FixRequest в процессе возможны.

GetActive(taskId): FixRequest с активным Fix на эту задачу (CompleteDate == null, статус Awaiting/InProgress), последний по Created. Нельзя брать любой FixRequest, у которого когда-то был Fix на задачу — иначе после повторного возврата на тот же этап Accept/Reject бьют в старый Completed Fix.

Accept / Reject / Skip: искать Fix с CompleteDate == null для пары FixRequest+Task.

Фронт: getActiveFixRequestId — по статусу: FixIsCompleted/FixIsRejected → createdFixRequestId (Continue); ReadyForFix/CheckingForFix → fixRequestIdIsProgress (Accept/Reject/Skip); иначе входящий, затем исходящий. Один общий OR ломает либо приёмку, либо Continue при вложенных (оба id сразу). GET FixRequest/{id}; формы не опираются на GetActive для действий.

Код: FixRequestService.cs, entities/fix-request/, task-header-conrols.tsx. Тесты: BuyerOrderFixRequestTests. Следующий контур тестов — карточка / товары / документы заказа, см. integration-tests-approach.md.

Бек: заказ и оплаты​

BuyerOrderService.Add: покупатель, ответственный, пустые оплата/отгрузка, state BeginBuyerOrder, чат, задача сбора, папка Drive (ошибка Drive не откатывает заказ).

Разделение заказа (split) — реализовано​

ТЗ: 80-agreements/requirements/buyer-order-split.md (ITR-2948). User: 00-user-guide/orders.md.

Бек: POST .../BuyerOrder/{id}/split; SplitBlockedReason считается в GetForEditing (/custom), не в Task/.../data. Проверки: роли SalesManager / AssistantSalesManager; пауза/отмена; сумма Count активных goods < 2; есть задача CreateSpecification; активный FixRequest; нет активной задачи процесса. После split: копия коммерции в новый заказ + чат + папка Drive; комментарий нового Выделен из заказа №…; типовое КП — удалить файл/ссылку и сбросить флаги, нетиповое — только флаги. Workflow: на Agree/Signing КП — FixRequest на Create CP сразу InProgress/ReadyForWork; иначе исходный остаётся на активной задаче; новый процесс до целевого типа (тот же этап или Create CP), пройденные — Skipped.

Фронт: кнопка в блоке «Товары» (BuyerOrderGoodsSection + SplitOrderWizard); карточка (state Begin / Create CP / Signing CP); форма сбора; вкладка просмотра заказа на Create/Signing CP. Права поля splitOrder. Не в TaskStatusSelector.

Доставка в цене — режимы ввода (ITR-3251, реализовано; бек ITR-3263, фронт ITR-3264): на OrderPayment — PriceInputModeId (default 1) + словарь BuyerOrderPriceInputModes. При «за наш счёт» + «включена в стоимость»: (1) цена + доставка → FinalPrice; (2) итоговая + доставка → Price; (3) цена + итоговая → ShippingCost = Σ((Final−Price)×Count). Пересчёт: GoodService.RecalculateGoodPrices / CheckGoodsPrices (CRUD товаров, Update/UpdateAmount, split, импорт Order/Good/1C). В 1–2 после округления ShippingCost может сдвинуться на копейки. UI: сбор / КП — edit режима; расчёт — view режима; матрица edit цены/итоговой/доставки по режиму. ТЗ: delivery-in-price-modes.md.

Update (полная карточка и КП): Adapt заказа. % предоплаты + % перед отгрузкой > 100 режется в CheckPaymentPercents уже на первой задаче.

SetPaymentSchedules — единственный живой путь плана. PaymentSchedule.Add бросает NotImplementedException. План не создаётся, пока нет задачи SigningSpecification. Предоплата — в момент появления запуска, если % > 0. Перед отгрузкой и окончательная — при завершении запуска. Суммы = FinalPrice * Count только по неархивным товарам (DateArchived == null). Смена товаров/%/дат после запуска пересчитывает этапы, отменяет ненужные счета, отвязывает платежи, шлёт уведомление. Даты этапов «перед отгрузкой» / окончательной пересчитываются при смене фактической даты запуска и срока изготовления (ITR-3384).

Счёт-договор (ITR-3252, реализовано; UI ITR-3372, суммы ITR-3381, файл ITR-3400/3399; синхрон суммы ITR-3434; реквизиты ITR-3427): тип EnContractType.Invoice, документ EnDocumentType.InvoiceContract. Создание только с BuyerOrderId (продажи); при создании проставляется BuyerOrder.ContractId и при необходимости OurOrganizationId. Нумерация общая с обычными договорами. Отсрочка и чужая привязка запрещены; для пути — Advance + BeforeShipment == 100%. Список Contract/list?buyerOrderId= — обычные WithBuyer + счёт-договор только этого заказа. GenerateContractDocument: тот же эндпоинт; для Invoice — Resources/ContractInvoice.docx + товары/цены/условия (ContractForGenerator); после генерации файл в Drive + ссылка на договоре, фронт автоскачивает docx. При первом плане с предоплатой — авто PaymentInvoice с ContractId на этап предоплаты; ручной Init/Add предоплаты и генерация обычного docx предоплаты на беке отклоняются; отмена такого автосчёта запрещена. При пересчёте плана (SetPaymentSchedules) сумма автосчёта предоплаты синхронизируется с суммой этапа; если по счёту уже есть платежи и суммы расходятся — отказ с понятной ошибкой. При создании/изменении счёт-договора ContractId и OurBankingDetailId проставляются на существующий счёт предоплаты; смена банковских реквизитов при уже привязанных платежах запрещена. Признак UI: LinkedToInvoiceContract (заказ, payment-summary, таблица счетов, schedule) — create/download предоплаты скрыты. В задачах спецификации/запуска файл спеки не обязателен. Код: ContractService, PaymentScheduleService, PaymentInvoiceService, TaskConditionHandler, DocumentService; фронт — задачи спецификации/КП/начало заказа, вкладка договоров, план оплат.

Счёт: лимит = сумма заказа − уже оплаченное. На статусе запуска «у покупателя» последний счёт предоплаты Created → Sent.

Доплата (нет отдельной сущности): на этап плана можно выставить несколько счетов. recommendedAmount = сумма этапа − сумма неотменённых счетов этапа (≥ 0). Типичный путь после роста суммы заказа (корректировка → SetPaymentSchedules обновляет суммы этапов): вкладка Финансы заказа / Счета на оплату → Создать счёт по этапу с остатком; форма подставляет недовыставленное. На пути счёт-договор второй ручной счёт на предоплату запрещён (бек CheckInvoiceContract); доплата — на «перед отгрузкой» / «окончательную» или через обычный путь без счёт-договора.

Ручная смена статуса счёта (PaymentInvoice Add/Update): только Created / Sent / Cancelled. При создании всегда Created. Paid / PartiallyPaid / Overpaid / NotPaid выставляет только система по сумме связей платежей (InvoicePaymentService / BankStatementService).

GET .../BuyerOrder/{id}/payment-summary — сводка вкладки Финансы и блока в форме счёта: KPI заказа + этапы с paymentScheduleId, датой, %, isEditable и счетами (total, paid, статус). Роли: продажи, производство, бухгалтер, admin. Отменённые счета в списке есть, в суммах этапа/заказа — нет. Платежи в этот ответ не входят (GET /PaymentInvoice/{id}/InvoicePayment/table).

GET .../Partner/{id}/BuyerOrder/financials — { summary, orders }. Агрегаты по активным (не Completed/Cancelled, Suspend входит): сумма, оплачено, остаток, число активных; плюс totalPaidAllAmount по всем заказам. В заказах — created, state, payment-summary; этапы без Other, с remainingAmount.

Если все счета предоплаты Paid/Overpaid, HandleSigningSpecificationTaskDone ставит запуск в CreatingOrders и при отсутствии сопровождения вызывает TaskDone минуя ChangeStatus / CheckFinalData.

Сопровождающий при CreatingOrders (ITR-3539): в SetSigningSpecificationInterimData при входе в CreatingOrders — EnsureMaintainerForProductGoods: если есть неархивные товары с изделием и MaintainerId пустой → least-loaded + SetMaintainer (сразу в БД). Нужно до ручного/авто создания Google-таблицы: в ячейке «ответственный» = Maintainer. При Done повторно не назначают, если уже заполнен.

GET Order/InvoicePayment/need-review — платежи к разбору (Error, без связей или сумма связей ≠ сумме платежа). Контракт как у платежей выписки: PaymentForBankStatementResponse[] с linkedInvoices (счёт, заказ, покупатель).

При автопривязке и перепривязке сверка реквизитов получателя в выписке с OurBankingDetail счёта: ПолучательРасчСчет (fallback ПолучательСчет) ↔ AccountNumber, при наличии в платёжке — ПолучательБИК ↔ BIC (InvoicePaymentBankDetailsHelper).

После Completed / Cancelled платежи нельзя перепривязать. Отвязка — бухгалтер и начальник продаж.

Отмена заказа (ITR-3374): BuyerOrderService.Cancel — если у неотменённых счетов есть связи с платежами выписки, отмена запрещена (сначала отвязать). Иначе неотменённые счета → Cancelled, активные PaymentSchedule → DateArchived (пропадают из фин.плана / payment-summary). Миграция ArchiveCancelledPaymentSchedules — то же для уже отменённых заказов (счета с привязанными платежами не трогает, этапы архивирует).

Договор (ITR-3387 / 3388): Contract.IsMultilateral; дубль номера среди неархивных допустим только если все такие договоры многосторонние и с одной нашей org. Жёсткая проверка формата ручного номера снята. UI: флажок на форме обычного договора (не счёт-договор). Таблица задач: колонка hasActiveFix (фронт ITR-3365).

Эпик ITR-2964 (реализовано): архивация лишних платежей выгрузки — 80-agreements/requirements/archive-extraneous-payments.md.
DateArchived / ArchiveComment на платеже; PATCH .../InvoicePayment/batch-archive (paymentIds + comment) → 200 { paymentIds, warning? } или 400 если некого архивировать; CanArchive / isArchived в GET .../BankStatement/{id}/payments. Архивные исключены из реестра, need-review, платежей счёта; дубли при импорте не учитывают архивные. UI: /bank-statements/{id}/payments — чекбоксы, массовая/одиночная архивация, колонка «Активный» (причина архивации в tooltip). Бек ITR-2976, фронт ITR-2978.

Код: BuyerOrderService.cs, PaymentScheduleService.cs (SetPaymentSchedules), PaymentInvoiceService.cs, InvoicePaymentService.cs.

Фронт: меню и маршруты (v1)​

Группа Финансы (parentKey: finance): /payment-schedules (compact), /invoices (детальный план), /invoice-payments, /invoices-registry, /invoice-payments/need-review, /export-1c (бухгалтер, admin). Банк: /bank-statements, /bank-statements/{id}/payments.

Заказ: только ?sideTab=finance (buyer-order-finance.tsx). Контрагент-покупатель: finance + paymentSchedule (partner-finance.tsx, partner-payment-schedule.tsx).

Redirect sideTab=paymentSchedule|invoices → finance в заказе — есть (useSideTabUrl с mapping, replace в URL). Financial indicator в шапке заказа — нет.

Права фронта на финансы расходятся по контекстам (field-permissions.config.ts):

  • вкладка «Финансы» заказа (BUYER_ORDERS.finance) — без бухгалтера; маршрут /buyer-orders/:id бухгалтеру тоже закрыт;
  • вкладка «Финансы» контрагента (PARTNER.finance) — с бухгалтером, но вкладки рендерятся только в PartnerEdit (/partners/:id/edit), куда бухгалтер не допущен; PartnerView вкладок не имеет. Итог: бухгалтер финансовые вкладки не видит;
  • редактирование этапа: PAYMENT_SCHEDULE.paymentSchedule.edit — нач. продаж, менеджер, помощник; BUYER_ORDERS.paymentSchedule.edit — только нач. продаж; API PUT /PaymentSchedule/{id} — плюс менеджер производства.

CSV: CsvExportButton (shared/ui/csv-export-toolbar.tsx, MUI ExportCsv, ;, BOM, allColumns) — в compact и детальной таблице плана (план-оплат) и во вкладке счетов-фактур /export-1c (счета-фактуры-выданные).

Задача сопровождения (support-order.tsx): при AwaitingBeforeShipmentPayment / AwaitingFinalPayment и далее показывает BuyerOrderPaymentSchedule, если в данных задачи есть paymentsSchedules.

Якорь эпика и карта задач: 80-agreements/requirements/finance-redesign.md.

Фронт: задачи​

FSD: app / pages / widgets / features / entities / shared. Vite, React 19, MUI, RTK Query (axios), RHF, zod. Вкладки: dynamic-tab.

Подписи модалок справочников (отрасли, типы СКУ, шаблоны, группы доступа, теги и т.п.): кнопка открытия и заголовок create — «Добавить {сущность}» (вин. п.); edit — «Редактировать {сущность}»; submit create/edit — «Сохранить». Не «Отправить» (это для заявок/согласований) и не «Создать» для простой строки списка. Сложные сущности (заказ, чат, счёт) — по-прежнему «Создать …».

Справочники с системными записями (правовые формы ITR-3247/3248, единицы, причины отмены; базисы поставки на фронте пока грузятся через all без флага): общий DictionaryPage, путь страницы = ключ в fieldPermissions (DICTIONARY, editBy). При purpose: 'table' бек отдаёт DictionaryTableResponse с isEditable; false = id из Ext.GetList() (seed-enum) — без кнопок в UI, бек отклоняет PUT/DELETE. Выпадающие списки — GET …/list (все роли), таблица и CRUD — узкие роли. Правовая форма: /legal-forms, просмотр Chief + Admin, edit Chief; GET /all устарел. Дыра: FK DetailsOfPartners → LegalForms с Cascade (а Partner → DetailsOfPartner тоже Cascade), проверки использования перед DELETE нет — удаление пользовательской формы снесёт реквизиты и контрагентов с ней.

/tasks — только ожидает / в работе / ждёт другую. Клик → TASK_ROUTE_MAP. Маршрутов нет у чертежей и КД.

Карточка: GET .../data → transformTaskData → форма. Шапка TaskHeaderControls → TaskStatusSelector. Статусы с бека. Смена: если не ReadyForWork, сначала mapToTaskUpdate + PATCH /data, потом PATCH /status. Из ожидания данные не шлются.

КП и спецификация — одна page, разные формы по типу и статусу. Поля: usePermission + fieldPermissionsByContext.

UI-долг: подписи «подписание КП/спецификации» vs uniqName «согласование с покупателем»; страница assign-maintainer при Obsolete на беке; часть TASK_TYPE_INFO ведёт на чужие статьи.

Код: entities/task/, pages/tasks/, shared/config/app-routes.config.tsx.

Скрытие задачи до даты (ITR-2749 / ITR-3061): личная настройка TaskUserSetting.HiddenUntil; только личная таблица /tasks; в процессе и на карточке видна. Reminder «пора вернуться». UI — иконка в TaskStatusSelector. ТЗ: hide-task-until-date.md.

Смена исполнителя / выход (ITR-3241 / ITR-3392) — реализовано: PATCH …/Task/{id}/custom/executor (ChangeCustomTaskExecutor) — автор или текущий исполнитель; кандидат с UserId; статус → ReadyForWork («Ожидает»); при передаче исполнителем (и если он не автор) прежний → CustomWatchers; при смене автором авто-наблюдателя нет; новый убирается из assistants/watchers; IsControlNotRequired не трогаем; чат — UpdateCustomTaskChatParticipants (добавить, не удалять прежнего); уведомление CreateCustomTaskNewParticipantNotification. Автор также может сменить исполнителя через UpdateCustomTask (тот же статус «Ожидает», без авто-наблюдателя). POST …/custom/leave (LeaveCustomTask) — только соисполнитель/наблюдатель; снятие с роли + LeaveChat. UI: у исполнителя кнопка у поля «Исполнитель» → модалка; у соисполнителя/наблюдателя — «Выйти из задачи». Добавление в чат поручения вручную → наблюдатель задачи (ITR-3422). ТЗ: custom-task-change-executor.md.

Сопровождение и отгрузки​

Исполнитель: есть изделия → наименее загруженный менеджер производства (начальник может сменить); нет изделий → ответственный менеджер продаж.

Номер документов на отправку (УПД, ТОРГ-12, 1-Т, счёт-фактура, акт) — из TaxInvoice.Number (int в БД, последовательность по организации). В API, UI и именах/теле файлов показывается с префиксом С- (ShipmentDocumentHelper.FormatNumber → С-1).

Разбиение таблицы товаров по страницам (FileGenerator.SetGoodsFields, УПД / ТОРГ-12 / 1-Т / акт и аналоги):

  • Строки товаров пишутся подряд; высота страницы ограничена (шапка + таблица + подвал с «Итого» / «Всего» / подписями).
  • Если очередная строка не влезает (или последняя строка не влезает вместе с подвалом) — вставляется разрыв: «Итого» по уже набранным строкам страницы → заголовок следующего листа → копия шапки таблицы → продолжение товаров.
  • Товар, из‑за которого сработал разрыв, оказывается на новой странице. Поэтому при разбиении на последнем листе всегда одна строка товара (при двух позициях в отгрузке и нехватке места — две таблицы по одной строке).
  • Одинаковые наименования / коды SKU на разных листах — это разные строки отгрузки (цены/количества могут отличаться), а не дубль одной позиции генератором.

Статусы (код, не mermaid в docs):

ReadyForWork → PreparingDocumentation → AwaitingProduction → ReadyToShip → (AwaitingBeforeShipmentPayment если % перед отгрузкой > 0) → Finalizing → AwaitingResponse → (AwaitingFinalPayment если заполнена отсрочка DelayInDays) → Completed.

Динамика GetAvailableStatuses для SupportOrder:

  • % перед отгрузкой null/0 → статус AwaitingBeforeShipmentPayment убирается; из ReadyToShip доступен прямой Finalizing.
  • % перед отгрузкой > 0 → из ReadyToShip убирается Finalizing (только через AwaitingBeforeShipmentPayment); из Finalizing убирается возврат в ReadyToShip (возврат через ожидание оплаты перед отгрузкой).
  • без DelayInDays → убирается AwaitingFinalPayment.
  • прямого AwaitingProduction → Finalizing в графе статусов нет.

Из Finalizing дальше только AwaitingResponse (нет прямого Completed / AwaitingFinalPayment). Из AwaitingResponse назад в Finalizing нельзя.

Побочные эффекты:

  • PreparingDocumentation → SetShipmentsFolder (найти/создать папку Drive по номеру заказа).
  • Переход в Finalizing → при % перед отгрузкой > 0 проверка: сумма связей платежей по активным счетам плана ≥ сумма активных этапов предоплаты + перед отгрузкой; затем AddShipmentDocuments: если нет активной отгрузки — создать на все активные товары и поставить FullyShipped; догенерировать недостающие документы в папку.
  • AwaitingResponse требует ShipmentStatus = FullyShipped.
  • Финал: полная оплата всей суммы товаров (переплата тоже ошибка), FullyShipped, фактическая дата отгрузки, дата доставки только если DeliveryOurExpense, по каждому активному товару отгружено ≥ количества. Закрывает заказ, процесс и чат.

Авто ReadyToShip: OrderService при смене статуса заказа на производство на «Склад» вызывает HandleCheckSupportOrderTaskIsReadyToShip. Если все активные ЗнП в Warehouse/Received/Completed — сопровождение прыгает в ReadyToShip (минуя ChangeStatus). Docs раньше писали, что автопереход «пока не активен» — уже есть, но только с триггера Warehouse.

Отгрузка (Shipment): несколько на заказ, строки ShipmentGood. Редактирование: активная задача сопровождения + роль по составу (изделия → только менеджер производства; без изделий → менеджер/помощник продаж). POST .../shipment/documents?taskId= — рабочий; POST .../{id}/shipment/documents — только Tester.

Фронт support-order.tsx: сохраняет только фактические даты. Кнопка массовых документов бьёт в taskId. Таблица отгрузок и даты не показываются в ReadyToShip (есть в производстве / финале / ожидании ответа / оплатах). В AwaitingBeforeShipmentPayment форма как в AwaitingFinalPayment: отгрузки + план оплат. SHIPMENT.edit и маршрут /shipments/:id уже открыты менеджеру продаж — кусок process-audit.md про это устарел. Кнопка документов в AwaitingProduction дублирует то, что бек делает на Finalizing.

Код: TaskConditionHandler SupportOrder*, BuyerOrderService.SetShipmentsFolder / AddShipmentDocuments, ShipmentService, entities/task/ui/support-order/support-order.tsx.

Эпик ITR-2826 (задачи ITR-2842 бек / ITR-2843 фронт): статус AwaitingBeforeShipmentPayment — реализован.

Уведомления​

Схема Notification (тот же EF-контекст, что и чаты): запись in-app + доставка. UI: колокольчик в хедере → drawer (entities/notification/*); WebPush — подписка в профиле.

Типы (EnNotificationType): Task, Fix, Partner, Process, Reminder, Chat.

ТипОткуда создаётся (ориентир)Примечание
TaskTaskServiceInternal — создание / новые участники custom / автосмена статусаобычно TaskId; получатели — ниже
FixFixRequestServiceкорректировки
Processзавершение процесса; смена ответственного/сопровождающего заказа; смена плана оплат (отмена счетов / отвязка платежей)завершение — авторы + исполнители + соисполнители + наблюдатели задач процесса; часто PageLink
ReminderReminderService — дедлайн задачи; next contact заказа; next contact контактного лица партнёрадедлайн → ExecutorId + Assistants; трекер POST /Notification/Reminder/send-daily; дедлайн без push
ChatMessageService при новом сообщениивсем активным участникам кроме автора; ChatId; в колокольчике и в push «из чатов»
Partnerзадуман под приближение даты контакта с контрагентом (карточка партнёра / контактное лицо)в справочнике и фильтре UI есть; сейчас эти сценарии создают Reminder, не Partner

Получатели Task / Process (задачи и процессы): инициатор (user.EmployeeId) исключается. Методы в TaskServiceInternal:

  • CreateTaskCreateNotification — ExecutorId + Assistants + WatcherId + CustomWatchers (создание / CreateNextTask / custom).
  • CreateCustomTaskNewParticipantNotification — только новые Assistants и CustomWatchers (UpdateCustomTask). Ветка UpdateData для custom меняет наблюдателей без этого уведомления.
  • CreateTaskAutoStatusChangeNotification — исполнитель + соисполнители.
  • CreateProcessCompleteNotification — по всем задачам процесса: AuthorId, ExecutorId, Assistants, WatcherId, CustomWatchers.
  • Дедлайн: ReminderService.SendTaskDeadlineReminders — ExecutorId + Assistants.

Доменные роли: соисполнитель = TaskAssistantEntity; наблюдатели списка = TaskWatcherEntity; одиночный наблюдатель = TaskEntity.WatcherId.

Колокольчик и чаты: запись «По чату» входит в список и счётчик колокольчика (GetByEmployee / GetUnreadCount / SetAllRead). Параллельно есть счётчик непрочитанных сообщений в панели чатов (Chat/…/unread/count). SignalR NotificationsUpdated обновляет колокольчик и UI чатов; Web Push по типу Chat идёт в подписку «из чатов».

Каналы доставки (при Add уведомления):

  1. In-app — строка в БД; HTTP list / unread / read (включая тип Chat).
  2. SignalR — хаб /hubs/notifications, событие NotificationsUpdated { unreadCount, notification } → конкретному User (не broadcast). unreadCount — все непрочитанные уведомления сотрудника.
  3. Web Push — опционально (SendPush, по умолчанию true). Тип подписки: Chat → EnPushSubscriptionType.Message, остальное → Notification. Ключи / подписки — Employee (PushSubscriptionService). Один origin/профиль браузера → один endpoint; при подписке другого пользователя запись перепривязывается (ограничение браузера + уникальность (Endpoint, TypeId)).

Интерфейс (фронт):

  • Пресеты таблиц (1.16.0): features/table-presets/*, хранение shared/lib/table-preset-storage.ts — localStorage по email; список пресетов по tableId, активный — по stateTableId. В пресет пишется полный GridInitialState. Ручное изменение грида снимает active (пресет не меняется). Сброс в профиле (pages/profile/lib/table-settings.ts) чистит tableState и active, сами пресеты не трогает.
  • Черновики форм (ITR-3297): useFormDraft + redux-слайсы (partner / product / sku и др.; без persist — до перезагрузки). Расширено на модалки создания: сотрудник, контакт, подписант, договор, банковские реквизиты, взаимодействие, пользовательская задача, параметр SKU и т.п. Подсветка отличий от источника — FormSourceContext / draftFieldSx. Маркер ✏️ в заголовке вкладки — useTabDraftMarker. При закрытии вкладки useDraftManager чистит черновики *:new и partner:{id}. Если dateOfLastEdit записи изменилась, черновик считается устаревшим и отбрасывается.
  • Экран ошибки: widgets/error-boundary — текст ошибки + component stack, кнопки «Скопировать» / «Перезагрузить», reportUxError в логи бека.
  • Пользователь без ролей: use-accessible-routes подставляет Roles.GUEST → доступны маршруты с Object.values(Roles) (главная, профиль, задачи, процессы, теги чатов) и чаты.
  • Admin: includes(Roles.ADMIN)-антипаттерн во фронте больше не встречается (ITR-3012, 1.10.1); DictionaryPage — isPermission(path,'edit').

Не путать с UX-уведомлениями: событие SignalR InvalidateCache (CacheInvalidationService) — инвалидация клиентского кеша сущностей, не колокольчик. Эпик: signalr-cache-invalidation.md.

Доменная страница: 10-architecture/notifications.md. User-guide: 00-user-guide/notifications-and-chats.md. UI-прототип (исторический): 60. Интерфейс/notification.md. Чаты: 10-architecture/chats.md.

Код: NotificationService, NotificationHub, ReminderService, PushSubscriptionService; фронт — entities/notification, shared/lib/signalr, profile-subscribe-card. Трекер: TrackingService → send-daily (напоминания) + Google sync.

Чат​

Схема Notification: Chat / ChatParticipant / Message / MessageAttachment / ChatTag / ChatTagChat / read-status. Типы (EnChatType): заказ покупателя / групповой / личный (приватный) / по пользовательской задаче (CustomTask, в UI «Поручение») / по заказу на производство (Order, UI «По ЗНП»).

Чат поручения (ITR-2935): создаётся по кнопке на пользовательской задаче или контроле (для контроля — привязка к исходной задаче, CustomTaskId); создать могут автор / исполнитель / соисполнители. Owner — автор; исполнитель и соисполнители — RequiredByProcess; наблюдатели — участники. UpdateCustomTaskChatParticipants при правке задачи: добавлять новых, снятых не удалять. Ручное добавление в чат → CustomWatchers (ITR-3422). Автозакрытия нет.

Чат заказа на производство (ITR-3378): при создании заказа на производство (OrderService.SetOrderChat) — тип Order, короткое имя, участники по ролям/должностям (в т.ч. главный конструктор — ITR-3537) + ответственный/сопровождающий заказа покупателя; список «Заказы» группируется по заказу покупателя. Автозакрытие при завершении/отмене заказа покупателя. В шапке окна и в «Информации о чате» — переход к карточке связанного заказа на производство (ITR-3464). ТЗ: manufacture-order-chat.md.

Карточка заказа на производство + ведомости + сбор/выдача (ITR-3413 / 3416 / 3417 / 3436 / 3454 / 3458 / 3456 / 3508 / 3511): маршрут /production-orders/\{id\} — вкладки «Общее» / «Комплектация» / «Материалы»; CRUD OrderSupplyRequirement; импорт комплектации из SolidWorks .xlsx. Экран «Сбор и выдача» /production-orders/summary — свод по заказам, отметка собранного, пакетная и построчная выдача (расход ядра); edit — снабженец, просмотр свода/остатков — также технолог; список заказов на производство и СЕ — КБ/технолог/снаб. SignalR OrderSupplyRequirement инвалидирует ведомость и свод. Уведомление о завершении сбора/выдачи по заказу — роли технолог. Разовый бэкофилл ведомостей из Google: API POST …/OrderSupplyRequirement/google (идемпотентно по заказу + имени; без кнопки в UI) — задача 17 эпика warehouse-kitting.md (кнопка только Admin + роль на POST).

Google-ресурсы заказа (ITR-3474, реализовано): у сотрудника поле GoogleEmail (правка — администратор пользователей, в профиле — просмотр). При создании ЗнП — share чтения папки заказа покупателя сопровождающему по Google-email; при создании таблицы ЗнП — reader ответственному; при смене Responsible / Maintainer — докидывание доступа. Служебный бэкофилл — Swagger. ТЗ: google-resource-permissions.md.

Комментарий к заказу покупателя (ITR-3471, реализовано): PATCH …/BuyerOrder/\{id\}/note; право — ответственный SM или его помощник; в ответе карточки — canEditNote. UI: карандаш на карточке и вкладке «Просмотр заказа». ТЗ: buyer-order-note-edit.md.

Описание чата: UI правит описание по canEditChat (Owner группового / чата поручения; ITR-3337). Системные участники описание из UI не правят.

Жизненный цикл с заказом покупателя: при BuyerOrderService.Add (и split) создаётся чат типа BuyerOrder + участники (ответственный — Owner). При завершении/отмене — закрытие чата заказа покупателя и чатов связанных заказов на производство. Смена ответственного/сопровождающего → участники чата заказа покупателя и чатов заказов на производство. Ручные close/reopen для типов заказа запрещены.

Участники (ITR-3034 / ITR-3105 / ITR-3106): права разделены — CanAddParticipants (любой активный участник, не private/closed) и CanDeleteParticipants (Owner или RequiredByProcess). Удаление себя, владельца и RequiredByProcess запрещено. Смена владельца группового — CanChangeOwner (ITR-3377). UI («Информация о чате») берёт флаги из permissions.

Сообщения: текст в Message.Text; правка / soft-delete; read-mark; кто прочитал — GetReadByUsers (ITR-3223); ответ — ReplyToMessageId (в ленте цитата replyToMessage). История видна целиком, без фильтра по дате входа участника. Черновик ввода — localStorage фронта (chat_draft_{email}_{chatId}). При отправке — уведомление EnNotificationType.Chat (SignalR + WebPush) активным участникам кроме автора; заголовок — «{автор} · {имя чата}» (личный — «личный чат»). Mentions и вложения не дают отдельный тип уведомления: превью чистится до @Имя / «Фото» / имя файла (MessageMentionHelper.ToDisplayText / BuildNotificationPreview).

Отметить непрочитанным (ITR-3170): личная отметка участника (IsMarkedUnread); меню карточки → пустой кружок в списке + учёт в счётчике непрочитанных чатов; курсор прочтения и «кто прочитал» не откатываются; сброс при обычном прочтении / своей отправке. ТЗ: chat-mark-unread.md.

Mentions (ITR-2912). Typed-токены в Text (@{e:guid:Display}; тип r зарезервирован под роли); отдельной таблицы нет; упомянутый должен быть участником. UI: message-input.tsx + entities/chat/lib/token-parser.ts. ТЗ: chat-mentions.md.

Автоссылки https (ITR-3116, реализовано). Только голый https://… при рендере; same origin → текущая вкладка, иначе _blank + noopener. Чат: Linkify на text-сегментах после mentions. Описание задачи / комментарий к заказу: ExpandableTextfield (у комментария заказа — ещё canEditOnDemand по canEditNote, ITR-3471). Бек и формат Text не менялись. ТЗ: clickable-https-links.md.

Вложения (ITR-2993 + ITR-2999; политика типов — ITR-3111): MessageAttachment + S3; multipart POST .../Message/with-attachments. Лимит до 10 файлов; ограничения по типу и размеру основного файла сняты (проверки obsolete). Для растровых jpeg/png/webp/gif/bmp — thumb обязателен (фронт ≤ 800 JPEG 0.8). Скачивание через бек участникам. Превью list/push — «Фото» / имя / «N файлов». ТЗ: chat-attachments.md, chat-attachment-thumbs.md.

Производительность (ITR-3197, основная часть реализована): fan-out уведомлений не блокирует ответ отправителю (ITR-3202); дешёвая активность чата вместо Max(Messages) (ITR-3203); точечные обновления на фронте (ITR-3204); параллельный S3 при отправке (ITR-3205); индикатор загрузки (ITR-3222). Отложены: облегчение list (ITR-3206), lazy thumbs (ITR-3207), ITR-3277. ТЗ: chat-performance.md.

Теги списка (ITR-2741, реализовано): ChatTag (личный) + ChatTagChat (M:N); ChatGroup убран. CRUD Notification/ChatTag; assign …/Chat/\{id\}/tags/\{tagId\}; в list — Tags + фильтры TagIds / NoTags. Фронт: справочник /chat-tags, блок «Мои теги» (с созданием нового тега по введённому имени) / меню «Теги» (только существующие) / выделение текста в ленте → «Создать тег», фильтр в сайдбаре, чипы на карточке из chat.tags. ТЗ: chat-tags.md. Не путать с типом «Групповой».

Фронт после рефакторинга (ITR-3439 / ITR-3445–3449): один источник навигации — entities/chat/model/chat.slice (isOpen, activeChatId, настройки панели) + chat-listener (persist последнего чата по email). Deep-link ?openChat=\{id\} и toast/колокольчик открывают чат через openChatDrawer, без pendingOpenChatId и без служебных window-событий. Фильтры списка и якоря общих оверлеев (detailModalChatId / tagsModalChatId / menuChatId) — в том же slice (сессия вкладки). Лента: use-chat-message-list-scroll / use-chat-reply-jump / use-chat-unread; переход к ответу — через ref списка, не inline-style DOM. Детали — секции в entities/chat/ui/chat-detail/*; ввод — ChatComposerProvider + hooks (use-submit-chat-message, use-chat-mentions, use-message-draft, use-chat-files). Правила «куда класть новое» — в ТЗ chat-refactoring.md.

Список: тип + поиск + теги. Копирование ссылки — меню карточки / шапка окна. В окне чата для сообщений/детали брать currentData (не data): при смене chatId RTKQ ещё отдаёт кэш предыдущего чата — иначе markAsRead уходит с чужим messageId → тост «Сообщение не найдено».

Realtime списка/окна чата — через тот же NotificationsUpdated (не отдельный ChatHub). Трекер в чатах не участвует.

Известный хвост уведомлений (ITR-3466, не из рефакторинга): бек не шлёт Chat-notify автору; in-app toast на фронте (use-chat-list-real-time) не фильтрует sender.id — в Chrome/Win иногда видно «уведомление себе»; зависание toast — вероятный дубль SignalR + SW APP_FOCUSED_NOTIFICATION / snackbar без key. Связано с отложенным ITR-3277 в chat-performance.md.

Доменная страница: 10-architecture/chats.md.

Страница админа /profile/google-auth: статус системного OAuth, service account, таблица обязательных ресурсов (Picker / расшаривание на SA), сброс токена. ТЗ: ITR-2667.md (Реализовано). User: profile-and-appearance.md.

Опросный лист на «Сборе первоначальной информации» — выбор файла через Google Picker из папки заказа (ControllerFileLink / questionnaireLink), не ручная ссылка. User: documents.md.

Legal для верификации Google: /privacy-policy, /terms-of-use (docs legal/*); отдельного /google-oauth нет — текст про Drive на экране входа (main.tsx).

Google: таблица заказа на производство​

GoogleTableService.CreateOrderTable / CreateEmptyOrderTable: копирование шаблона в папку заказов → заполнение ячеек (только у полного create).
Копирование через Drive не сохраняет список редакторов защит листов/диапазонов (защиты диапазонов часто пропадают). После копирования: удалить защиты на копии и заново создать из шаблона (CopyProtectedRangesFromTemplate), листы сопоставляются по названию.
Учётные данные OAuth client: создание таблицы заказа (ExecuteGoogleApiByClient), добавление строки в сводную таблицу заказов на производство (SetOrderRow → ExecuteSheetsApiByClient).
В сводной таблице и в отдельной таблице заказа на производство поле «ответственный» = BuyerOrder.Maintainer (сопровождающий / менеджер производства), не Responsible.
Чтение/синхронизация сводной таблицы и справочников — service account (ExecuteSheetsApiByService).

Даты в Google (гибрид код / формула листа) — user-facing: 40. Синхронизация данных/googleTable.md:

  • L1 (дата заказа) — всегда из ActualLaunchDate (код).
  • L2 (дата отгрузки) — пишем PlannedShipmentDate только если условие старта без согласования чертежа (AfterPrepayment / AfterSigningSpecification); для *AndApproval ячейку не трогаем (формула листа).
  • Сводная колонка D «Финиш» — то же правило: без чертежа считаем через ShipmentDatesCalculator.CalculatePlannedFinishDate (РАБДЕНЬ от отгрузки назад на запас по сроку изготовления, как B12); с чертежом не пишем.
  • ActualLaunchDate + RecalculatePlannedDates + назначение Maintainer (если нужен) должны быть до CreateOrderTable (в т.ч. SetInterimData(CreatingOrders) после предоплаты / ручного входа в статус).

Google: «Список изделий» (ITR-3049 — реализовано)​

ТЗ: product-google-sheet-sync.md. Подзадачи: ITR-3051/3052 (бек), ITR-3053 (фронт).

Массовая синхронизация (как раньше): POST Product/Product/google → ProductService.GoogleTableSynchronize / GetProductsFromGoogleDoc — начальник менеджеров.

По одному изделию (ручной вызов):

  • POST …/{id}/google-export → GoogleExport → AddOrUpdateProductRow: обновить или создать строку по номенклатуре; дубли → ошибка. Пустое Description → текст из GetFormattedParameters() (нужны Include параметров).
  • POST …/{id}/google-import → GoogleImport → GetProductFromGoogle: нет строки / дубли / messages парсера → ошибка; иначе обновить SKU/продукт/магниты/документы.
  • Роли API: Designer, ChiefDesigner, ChiefSalesManager. UI: кнопки на карточке и в модалке (googleActions); вход конструкторов в /products — отдельный анализ прав, в эпике не меняли.

Полный набор колонок как у массового импорта (в т.ч. ТЗ заказчика, чертёж от клиента, модель, сложность). Автовыгрузка и закрытие записи в Google — следующие эпики.

Факсимиле в docx (эпик ITR-2930, реализовано)​

Требование: 80-agreements/requirements/document-facsimile.md.

Два PNG на нашей организации (Partner): подпись (DirectorFacsimileLink → {OurOrganization.DirectorFacsimile}) и печать с подписью (FacsimileLink → {OurOrganization.Facsimile}), папка Drive FacsimilesFolderId, доступ через системный OAuth (Picker). Upload/delete: PATCH|DELETE Order/Partner/{id}/facsimile и .../director-facsimile (только IsOur).

Генерация: FacsimileHelper + FileGenerator.ReplaceTextWithImage — якорь убирается всегда; картинка только при успешном чтении PNG. Ошибка Drive при чтении не ломает генерацию. Во встроенном счёте — якорь {OurOrganization.Facsimile} (PaymentInvoiceService); из спецификации подстановка убрана в 1.14.0 (SpecificationForGenerator без факсимиле); в КП — только якоря, найденные в выбранном шаблоне (лишние PNG не качаются). UI: accordion «Факсимиле» на редактировании нашей организации (PartnerFacsimile); на просмотре блока нет.

Телефоны и email контрагента (не контактных лиц) сохраняются вместе с карточкой в PartnerService.UpdateContactData: дубли телефона по паре номер + пометка и дубли email схлопываются через DistinctBy (1.13.1, ITR-2961; раньше ToDictionary падал на дубле). Убранные из запроса записи получают DateArchived. В changelog формулировка «у контактных лиц» неточна.

Якоря правовой информации (ModelsForGenerator): ContractForGenerator — BuyerLegalForm, BuyerShortName, OurLegalForm; CommercialProposalForGenerator — те же плюс OurShortName и ContactPersonFullName. В SpecificationForGenerator правовой формы и краткого наименования нет (в changelog 1.7.0 написано «в КП и спецификации» — по коду договор и КП).

Код: PartnerService.SetFacsimile / DeleteFacsimile, GoogleTableService.GetFacsimileFileBytes, BuyerOrderService (КП/спецификация), PaymentInvoiceService (счёт); фронт — entities/partner/ui/partner-facsimile/*.

Иностранный контрагент (ITR-3119)​

Foreign-режим: форма «Иностранная организация», foreign-реквизиты или страна ≠ Россия; явная Россия + foreign-маркеры → конфликт. Налоговый номер в поле ИНН (цифры до 20). КПП/ОГРН/ОКПО в foreign не требуются. Автозаполнение (DaData): РФ, Беларусь (УНП), Казахстан (БИН); при 12 цифрах — радио «РФ / Казахстан». НДС в заказе по тому же признаку (0% по умолчанию).

Код: PartnerForeignHelper, DetailsOfPartnerBodyRequest.Validate; фронт — partner-foreign.helper.ts, form-partner.tsx. ТЗ: foreign-partner-requisites.md. User docs: partner.md, partners.md.

Чертежи на согласование в КП (ITR-3033)​

При генерации КП (BuyerOrderService.SetCommercialProposal → PrepareGoodsWithDrawings → FileGenerator.FillSkuTypeDrawingsBlock): для товаров с Product.Drawing.FileLink скачивается PDF (GetFileBytesByLink), страницы конвертируются в изображения (FileConvertHelper / FreeSpire.PDF) и вставляются вместо якоря {Product.Drawing} внутри ParametersBlock (разворот по изделиям в блоке типа SKU). Нет чертежа / не PDF / ошибка Drive — warning, якорь убирается, генерация не падает. Якорь в справочнике: DocumentTemplateAnchorExt. User docs: createCommercialProposal.md, contractTemplates.md.

Подгрузка согласованного чертежа в «Запуске» (ITR-3239 — реализовано)​

ТЗ: specification-agreed-drawing.md. Подзадачи: ITR-3278 (поля/API), ITR-3279 / ветка ITR-2379 (Google + sync), ITR-3280/3281 (фронт).

Два разных объекта:

Чертёж на согласованиеСогласованный чертёж
СущностьProduct.Drawing (номенклатура, без подписи покупателя)У товара (Good.AgreedDrawingLink + AgreedDrawingSignDate, без булева)
ФайлКонструктор / контур изделияПапка заказа покупателя
Таблица товаровКолонка «Чертёж на согласование» = ссылка с изделияКолонка «Согласованный чертёж» (+ дата) = с товара
КтоКонструкторПродажи в «Запуске»; производство — дозаполнение или замена (корректировка, ошибка) в форме заказа покупателя
Create(Drawing)Sent / SignedBy* = null (как Design)—

Пока процессная ветка чертежа не активна:

  • Основной путь: SigningSpecification («Запуск»), менеджер продаж; только *AndApproval. Не обязательно до CreateOrderTable. API: POST …/Good/{goodId}/agreed-drawing → GoodService.SetAgreedDrawing (файл в Drive, Google-ячейки при наличии таблицы, Order.Dates, SetActualLaunchDate).
  • Дозаполнение / замена: менеджер производства (ProductionManager) в форме заказа покупателя, заказ не Completed/Cancelled; графа может быть уже заполнена (корректировка, ошибка) — в goods-table.tsx проверки !agreedDrawingLink нет.
  • TaskData: buyerOrderConditionStartingWork; на SigningWithBuyer при RequiresDrawingApproval — orderGoods с полями согласованного чертежа.
  • Ячейки листа заказа: B3/E3/G3/I3 из Good / условия запуска (UpdateOrderAgreedDrawingCells, CreateOrderTable / OrderForOrderDataTable).
  • Трекер: sync → SetAgreedDrawingsData читает B3+I3 → Good + Order.Dates (не Product.Drawing).
  • Дата запуска: BuyerOrderLaunchDateService смотрит AgreedDrawingSignDate по товарам-изделиям.
  • Фронт: колонки разведены; модалка файл + дата; на CreatingOrders без дубля общей таблицы товаров.

Вне scope: опросный лист / ТЗ / фото; полная ветка CreateDrawingForApproval / …. Судьбу UI в «Запуске» после включения той ветки — решить тогда. Не путать с КП (ITR-3033).

Склад: ядро (ITR-3158 — реализовано)​

ТЗ: warehouse.md. User guide: warehouse-and-products.md. Ветки бека: ITR-3183 (операции остатков), ITR-3188 (зеркало Google), ITR-3237 (минимум), ITR-3256 (эндпоинты для Supplier), ITR-3259 (таблица остатков), ITR-3285 (Supplier — основная карточка контрагента), ITR-2392 / ITR-3292 (имя в списке заказов на производство). Фронт: ITR-3189 (экран остатков) + ITR-3190 (форма складской операции) + ITR-3258 (доступ Supplier к таблице SKU) — одним PR под ITR-3189; ITR-3191 (журнал); ITR-3238 + ITR-3287 (минимум, просмотр SKU с остатков); ITR-3285.

Модель: SkuQuantity — уникальная пара StockKeepingUnitId + LocationManufactureId, поля StockQuantity, RequiredMinimum (nullable). SkuQuantityChange — журнал: OperationTypeId (Receipt / Expense / Inventory), ChangeQuantity, QuantityAfter, Reason (nullable), AuthorId, OrderId? (заказ на производство), PartnerId?, GroupToken? (задел под групповые операции).

API Warehouse/SkuQuantity (SkuQuantityController → SkuQuantityService):

МетодРолиСуть
GET table/{locationId}Supplier, AdminВсе неархивные SKU + остаток площадки (нет записи → 0, id = null)
GET changes/{locationId}Supplier, AdminЖурнал, новые сверху; фильтры query: SKU, тип, заказ, контрагент, автор, groupToken, dateFrom/dateTo (фронт пока фильтрует на клиенте)
POST changeSupplierОперация: остаток + запись журнала в одном SaveChanges; quantityAfter < 0 → 400 «Недостаточно остатка»; затем GoogleExport (ошибка Google только логируется)
PATCH required-minimumSupplierUpsert минимума (null = сброс, < 0 → валидация); журнал не пишется
POST googleChiefSalesManager, SupplierМассовый импорт остатков Рязани из Google по имени SKU (минимум обновляется, только если заполнен в таблице)
POST {skuQuantityId}/google-exportSupplierРучная выгрузка строки (UI нет)

Google: GoogleTableService.AddOrUpdateQuantityRow (service account) — лист из SkuQuantitySheets[locationId] в appsettings (QuantitiesSheetName = «Остатки.», QuantityChangesSheetName = пр/расход). Строка остатка ищется по имени SKU (дубли → отказ), иначе первая пустая; в пр/расход — append (дата dd.MM.yy, операция, SKU, кол-во, ед., номер заказа на производство, примечание, контрагент, остаток после), один BatchUpdate. Минимум не выгружается.

Списки для формы: GET Order/Order/list (Supplier, Admin) — Name = "{Number} ({SKU.Name})" через Mapster OrderEntity → ShortResponse (глобальный маппинг для этой пары); GET Order/Partner/Supplier/list (Supplier, Admin) — IsSupplier && Active.

Supplier и контрагенты (ITR-3285): таблица/карточка — все контрагенты; создание/правка/архив/тип — только IsSupplier || IsOther, не IsOur, без Buyer/Customer; AccessGroup и Tags не меняет; вложенные сущности (реквизиты, договоры, подписанты и т.п.) — 403. Фронт: на edit для Supplier не грузит вложенные вкладки.

Фронт: меню «Склад» (stockGroup): /sku-quantities (SkuQuantitiesPage), /sku-quantity-changes (SkuQuantityChangesPage), /stock-keeping-units. Права: RouteRoles.skuQuantityView = Supplier + Admin, skuQuantityEdit = Supplier; PermissionContext.SKU_QUANTITIES (view / edit). Модалки: SkuQuantityChangeForm (zod: приход/расход > 0, инвентаризация ≥ 0, расход ≤ остатка), SkuRequiredMinimumModal (клик по ячейке «Минимум»), просмотр SKU (StockKeepingUnitForm disabled; для категории «Изделие» кнопки нет). Подсветка ниже минимума — overdue-cell-custom из stylesTable. Глазов в селекторе disabled.

Синхронизация остатков (ITR-3334): фронт бьёт в POST Warehouse/SkuQuantity/google (раньше ошибочный путь Warehouse/StockKeepingUnit/google/quantity). Не закрыто организационно: защита листов Google склада от ручной правки.

Известные дыры​

  • Docs сущностей: YouGile, пустые секции. processCreateSku.md ссылается на страницы изделия. Пример процесса путает заказ покупателя и заказ на производство.
  • Эпики / ТЗ: 80-agreements/requirements/ (+ sidebar). Журнал requirements-log.md — отдельно, эпики туда не дублировать.
  • Уведомления / чаты: user-guide notifications-and-chats.md; domain notifications.md, chats.md; Интерфейс/notification.md — исторический прототип (с баннером). Вложения + thumbs — Реализовано (chat-attachments.md, chat-attachment-thumbs.md). Теги списка — Реализовано (chat-tags.md). Mentions — Реализовано (chat-mentions.md). Автоссылки https — Реализовано (clickable-https-links.md). Производительность чатов — Реализовано (основная часть; chat-performance.md, ITR-3197). Чат поручения, описание чата, наблюдатели / вложения / «Результат» пользовательской задачи — Реализовано (bitrix24-migration.md, ITR-2935; переезд отменён). Тип Partner заложен под next contact контрагента/контактного лица, но создатели пока шлют Reminder.
  • Конструкторский блок в product.md — «не утверждён».
  • process-audit.md по сопровождению частично устарел: дата доставки уже зависит от DeliveryOurExpense; товары/отгрузки в финале и GetDataById фильтруют DateArchived; права продаж на отгрузки в UI расширены; статус AwaitingBeforeShipmentPayment (ITR-2826) в аудите ещё не отражён. Аудит всё ещё полезен как журнал, не как истина.
  • User docs сопровождения (supportOrder.md, paymentPlanMap.md, processBuyerOrderBackendRules.md) сверены с кодом по статусу ожидания оплаты перед отгрузкой и переходам вокруг Finalizing / AwaitingResponse.
  • UI ReadyToShip беднее бека: нет таблицы отгрузок и дат.
  • Трекер в этой карте ещё не разобран. Склад — ядро разобрано (§ «Склад: ядро»); SKU / изделие / резервы / заявки — поверхностно.

Куда смотреть дальше​

ТемаСначалаПотом код
Выгрузка в 1Сexport-1c.md (ITR-3083, реализовано v1); export-1c-field-map.mdXML обмена; превью + скачивание; v1 org-код — ПК ОлМаг
Импорт Excel из 1С1C.md; import-1c-audit.mdBuyerOrder/Good/PaymentInvoice …/1C; UI import-1C (другой контур)
Интеграционные тесты бекаintegration-tests-approach.md (ITR-2944)эталон — задачи (BuyerOrderProcess/) и корректировки (BuyerOrderFixRequestTests); следующий — карточка / товары / документы заказа, не оплаты и не изделия
Уведомления / чатыUser-guide notifications-and-chats.md; notifications.md, chats.md; эта страница (§ «Уведомления», § «Чат»); эпики chat-*, signalr-cache-invalidationNotificationService, MessageService, ChatService, NotificationHub; фронт entities/notification, widgets/chat
Процесс заказа70. Рабочий процесс/Процессы/processBuyerOrder.mdTaskService, TaskConditionHandler
Google: таблица заказа на производство / даты40. Синхронизация данных/googleTable.md; § «Google: таблица заказа на производство»GoogleTableService, ShipmentDatesCalculator, BuyerOrderLaunchDateService
Google «Список изделий»product-google-sheet-sync.md; § выше; product.mdProductService.GoogleExport / GoogleImport, AddOrUpdateProductRow, GetProductFromGoogle; фронт product-google-actions
Согласованный чертёж в «Запуске»specification-agreed-drawing.md (ITR-3239, реализовано)Good.AgreedDrawing*; B3/E3/G3/I3; SetAgreedDrawingsData; продажи + дозаполнение производством
Режимы ввода цен при доставке в стоимостиdelivery-in-price-modes.md (ITR-3251, реализовано)PriceInputModeId; RecalculateGoodPrices (3 ветки); фронт сбор / расчёт / КП
Склад (остатки, операции, журнал)warehouse.md (ITR-3158, реализовано — ядро); § «Склад: ядро»SkuQuantityService, GoogleTableService.AddOrUpdateQuantityRow; фронт entities/sku-quantity, pages/sku-quantity
Оплаты80-agreements/requirements/finance-redesign.md, paymentPlanMap.mdPaymentScheduleServiceInternal.SetPaymentSchedules
Счёт-договор80-agreements/requirements/invoice-contract.mdContractService, PaymentScheduleService, PaymentInvoiceService, TaskConditionHandler
Сверка docs/код10-architecture/process-audit.mdактуальный код важнее аудита
Фронт задачиэта страница; эпик hide-task-until-date.md (ITR-2749)task-status-selector.tsx, TASK_ROUTE_MAP, выдача /tasks
КорректировкиFixTask.mdFixRequestService, entities/fix-request/
Сопровождение / отгрузкиsupportOrder.mdTaskConditionHandler SupportOrder, ShipmentService

Место производства (ITR-2949 — реализовано)​

Requirements: production-location.md (статус Реализовано). Подзадачи: ITR-2952 (BuyerOrder / адрес / автопроверка), ITR-2954 (наследование на Order + Google).

Справочник: LocationManufacture (Рязань / Глазов / Стороннее) — сотрудники, Order, SKU; API Employee/LocationManufacture. На заказе покупателя в UI — только Рязань / Глазов.

BuyerOrder:

  • LocationManufactureId (nullable) — пишется с save «Создание КП»; на Custom («Сбор данных») бек восстанавливает прежнее значение (фронт поле не шлёт / не затирает). Завершение КП без места → ошибка в TaskConditionHandler.
  • OrderShipment.IsSupplyBaseAddressOverridden — флаг ручного адреса для EXW / FCA ДЛ.
  • Дефолт org: PartnerExt.GetDefaultLocationManufacture — ЗМС → Glazov, иначе Ryazan; GET /Order/Partner/Our/short/all → defaultLocationManufacture.
  • Матрица адресов: SupplyBaseExt.GetAddresses() — базис × locationManufactureId; API Our/SupplyBaseAddresses. Глазов (EXW и FCA ДЛ): г. Глазов, ул. МОПРа, д. 37, стр. 11.
  • Нормализация: BuyerOrderService.NormalizeShipmentRequest — см. requirements; для не-EXW/FCA флаг всегда false.

Order (production):

  • AddOrder / obsolete CreateOrder берут BuyerOrder.LocationManufactureId.
  • Ответы OrderResponse / OrderFullResponse / OrderTableResponse — locationManufacture (Mapster).
  • Google: запись колонки AI при создании строки; импорт читает AI и обновляет LocationManufactureId при HasValue.

Автосогласование КП: AutoCheckService — системные LocationManufactureMatch и SupplyBaseAddressOverridden (блок по флагу, не по тексту адреса). Пользовательский параметр «Постоплата, %» (ITR-3391) — 100 − Advance − BeforeShipment.