Карта системы для Cursor
Рабочая карта для агента и разработки. Не заменяет пользовательские процессы и не является ТЗ.
Правило чтения:
- Эта страница — сжатый ориентир после изучения кода.
- Пользовательские docs дают термины и замысел, но местами отстают.
- Requirements (
80-agreements/requirements/) — ближе к ТЗ: замысел функционала до/во время реализации (см. ниже). - При расхождении смотреть код: бек = правила процесса, фронт = UX.
Обновлять этот файл при каждом новом проходе по домену (задачи, оплаты, склад, трекер).
Проекты: фронт OlMag.Manufacture, бек OlMag.Manufacture.Api, трекер OlMag.Tracking, документация documentation.
Документация: слои
| Слой | Где | Для кого | Суть |
|---|---|---|---|
| Requirements | 80-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.
Доступ = роль + связь с заказом/задачей + статус + не в корректировке.
Процессы
- Заказ покупателя — главный.
- Создание изделия / SKU — автор → согласование руководителем. Начальник продаж и главный конструктор создают сразу.
- Пользовательский — задача + контроль.
Ветка чертежа на согласование в 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.
Смена статуса:
- доступ на редактирование;
- статус в
GetAvailableStatuses(+ фильтры: нельзяNotRequiredу спецификации при условии «после подписания»; без предоплаты убираются invoicing / ожидание оплаты); - финал (
Completed/Agree/NotRequired/Deleted/Skipped/Rejected):CheckFinalData→SetFinalData→ закрыть fix илиTaskDone; - иначе:
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— только нач. продаж; APIPUT /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.
| Тип | Откуда создаётся (ориентир) | Примечание |
|---|---|---|
| Task | TaskServiceInternal — создание / новые участники custom / автосмена статуса | обычно TaskId; получатели — ниже |
| Fix | FixRequestService | корректировки |
| Process | завершение процесса; смена ответственного/сопровождающего заказа; смена плана оплат (отмена счетов / отвязка платежей) | завершение — авторы + исполнители + соисполнители + наблюдатели задач процесса; часто PageLink |
| Reminder | ReminderService — дедлайн задачи; next contact заказа; next contact контактного лица партнёра | дедлайн → ExecutorId + Assistants; трекер POST /Notification/Reminder/send-daily; дедлайн без push |
| Chat | MessageService при новом сообщении | всем активным участникам кроме автора; 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 уведомления):
- In-app — строка в БД; HTTP list / unread / read (включая тип Chat).
- SignalR — хаб
/hubs/notifications, событиеNotificationsUpdated{ unreadCount, notification }→ конкретномуUser(не broadcast).unreadCount— все непрочитанные уведомления сотрудника. - 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.
Google: системная авторизация и legal (ITR-2667 / ITR-2760)
Страница админа /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 change | Supplier | Операция: остаток + запись журнала в одном SaveChanges; quantityAfter < 0 → 400 «Недостаточно остатка»; затем GoogleExport (ошибка Google только логируется) |
PATCH required-minimum | Supplier | Upsert минимума (null = сброс, < 0 → валидация); журнал не пишется |
POST google | ChiefSalesManager, Supplier | Массовый импорт остатков Рязани из Google по имени SKU (минимум обновляется, только если заполнен в таблице) |
POST {skuQuantityId}/google-export | Supplier | Ручная выгрузка строки (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.md | XML обмена; превью + скачивание; v1 org-код — ПК ОлМаг |
| Импорт Excel из 1С | 1C.md; import-1c-audit.md | BuyerOrder/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-invalidation | NotificationService, MessageService, ChatService, NotificationHub; фронт entities/notification, widgets/chat |
| Процесс заказа | 70. Рабочий процесс/Процессы/processBuyerOrder.md | TaskService, TaskConditionHandler |
| Google: таблица заказа на производство / даты | 40. Синхронизация данных/googleTable.md; § «Google: таблица заказа на производство» | GoogleTableService, ShipmentDatesCalculator, BuyerOrderLaunchDateService |
| Google «Список изделий» | product-google-sheet-sync.md; § выше; product.md | ProductService.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.md | PaymentScheduleServiceInternal.SetPaymentSchedules |
| Счёт-договор | 80-agreements/requirements/invoice-contract.md | ContractService, 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.md | FixRequestService, entities/fix-request/ |
| Сопровождение / отгрузки | supportOrder.md | TaskConditionHandler 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; APIOur/SupplyBaseAddresses. Глазов (EXW и FCA ДЛ):г. Глазов, ул. МОПРа, д. 37, стр. 11. - Нормализация:
BuyerOrderService.NormalizeShipmentRequest— см. requirements; для не-EXW/FCA флаг всегда false.
Order (production):
AddOrder/ obsoleteCreateOrderберутBuyerOrder.LocationManufactureId.- Ответы
OrderResponse/OrderFullResponse/OrderTableResponse—locationManufacture(Mapster). - Google: запись колонки AI при создании строки; импорт читает AI и обновляет
LocationManufactureIdприHasValue.
Автосогласование КП: AutoCheckService — системные LocationManufactureMatch и SupplyBaseAddressOverridden (блок по флагу, не по тексту адреса). Пользовательский параметр «Постоплата, %» (ITR-3391) — 100 − Advance − BeforeShipment.