2026-08-25 - Real-time инвалидация кеша через SignalR
Статус: Реализовано
Источник: технический анализ (обсуждение Event-Driven Cache Invalidation для фронта на RTK Query).
Эпик закрыт в объёме задач и заказа покупателя (релизы 1.9.0 и 1.10.1). Подключение других сущностей (финансы, процессы, заказы на производство и др.) — отдельными задачами, вне этого эпика. Ниже исходный анализ сохранён как есть; фактическая реализация — в разделе «Итог реализации».
Итог реализации
Что сделано:
- Бек после сохранения изменений сам собирает изменённые сущности и рассылает всем подключённым клиентам компактное событие SignalR
InvalidateCache(тип + id + инициатор). Отдельный канал, не push-уведомления. - Какие сущности порождают событие, задаётся списком разрешённых (allowlist): новые сущности добавляются одной строкой.
- Сейчас в списке:
- задачи — сама задача, корректировки, запросы на корректировку, помощники;
- заказ покупателя — сам заказ, товары, отгрузки, условия оплаты и доставки, документы, необходимая документация, причины остановки.
- Фронт обновляет только открытые экраны с этими данными: карточку и список. Инициатор изменения событие игнорирует — его экран обновляется собственным запросом.
- На iPhone и iPad при возврате приложения из фона данные перезапрашиваются.
Отличия от исходного плана: событие называется InvalidateCache, а не EntityChanged. Публикация идёт автоматически из сохранения изменений через реестр правил, а не через ручные вызовы notifier.
Не вошло, пойдёт отдельными задачами:
- финансы: платежи, счета, банковские выписки, план оплат;
- процессы и заказы на производство;
- увеличенное время жизни кеша для совместно редактируемых данных;
- общая подтяжка данных после переподключения SignalR (кроме iOS).
Задачи: ITR-2794 (задачи через SignalR), ITR-2924 (автоматический сбор изменений и реестр), ITR-2951 (заказ покупателя), ITR-2982 (обновление на iOS после фона).
Цель
Сделать так, чтобы пользователь видел актуальные данные, когда их меняет другой пользователь или система (автопереходы статусов, склад → сопровождение), без ручного обновления страницы.
Основная идея: бэк при изменении общих сущностей шлёт компактное событие через SignalR; фронт по событию инвалидирует соответствующие теги RTK Query и перезапрашивает только активные подписки.
Контекст
Сейчас SignalR используется как канал уведомлений пользователю, а не как канал синхронизации данных:
- хаб
/hubs/notifications, событиеNotificationsUpdated; - бэк шлёт
{ unreadCount, notification }конкретному пользователю; - фронт уже реагирует точечно: колокольчик, чат, списки задач/процессов через
useNotificationRefetch.
RTK Query на фронте уже покрывает большую часть API и использует providesTags / invalidatesTags. Собственные mutation текущего пользователя кеш обновляют сами. Проблема — чужие и фоновые изменения: два человека на одном заказе; бухгалтер загружает банковскую выписку или привязывает/перепривязывает платёж к счёту (с побочными эффектами на задачи); склад двигает заказ на производство.
Привязывать кеш к существующим push-уведомлениям нельзя: если уведомление не создано — события нет, кеш устаревает.
Текущее поведение
- SignalR: только
NotificationsUpdatedс объектом уведомления. - Чат:
invalidateTagsдляChat,ChatMessageпо типу уведомленияChat. - Задачи/процессы:
useNotificationRefetchна страницах/tasks,/processes, таблице задач процесса. - Остальные сущности (заказ, оплаты, отгрузки, финансы) при чужом изменении не обновляются автоматически.
- Динамические вкладки размонтируют страницу; кеш RTK по умолчанию живёт 60 с (
keepUnusedDataFor; у чата — 300), при возврате на вкладку данные часто уже выкинуты и грузятся заново. - Реконнект SignalR включён (
automaticReconnect), но после восстановления связи кеш не пересинхронизируется.
Желаемое поведение
Отдельное событие для кеша
Не расширять NotificationsUpdated. Ввести отдельное событие, например EntityChanged:
{
"entity": "BuyerOrder",
"id": "guid",
"initiatedByUserId": "guid-or-null",
"related": {
"buyerOrderId": "guid",
"taskId": "guid",
"partnerId": "guid",
"paymentInvoiceId": "guid",
"paymentScheduleId": "guid",
"bankStatementId": "guid",
"invoicePaymentId": "guid",
"buyerOrderIds": ["guid"],
"partnerIds": ["guid"],
"paymentInvoiceIds": ["guid"],
"invoicePaymentIds": ["guid"],
"taskIds": ["guid"],
"invalidatePaymentLists": true,
"taskAutoAdvanced": false
}
}
entity— тип сущности (согласованный enum на беке и фронте).id— идентификатор изменённой сущности (для финансов чащеBankStatementилиInvoicePayment).initiatedByUserId— id пользователя, инициировавшего изменение;nullдля системных/фоновых вызовов (склад,UserShort.System()).related— опционально, для каскадной инвалидации. Скаляры — один объект; массивы — когда выписка/перепривязка затронула несколько заказов/счетов. Поля финансов и маппинг — в финансовом хелпере.
Стратегия на фронте: Cache Invalidation, не Cache Patching
Основной путь: бэк шлёт имя сущности + id → фронт вызывает rtkApi.util.invalidateTags(...).
Не делать по умолчанию: передачу полного payload в сокете для крупных агрегатов (задача, заказ, payment-summary). Причины:
- дублирование REST-контрактов и трансформеров (
transformTaskDataи т.п.); - риск рассинхрона прав (GET сам проверит доступ);
- конфликт с открытыми формами RHF (patch может затереть несохранённый ввод).
Patching допустим только для маленьких, частых кусков (как сейчас в чате: unread, последнее сообщение).
Глобальный listener
Один обработчик на уровне приложения (не подписка «на компонент»):
- RTK и так рефетчит только активные query;
- меньше дублирования
useSignalREffect, чем в каждом виджете; - вкладки и layout-списки тоже получают обновление.
Маппинг entity → RTK tags — в одном модуле на фронте.
Инициатор изменения: если initiatedByUserId === currentUserId — не инвалидировать кеш. У инициатора данные уже обновит mutation (invalidatesTags / ответ PATCH). Иначе возможен двойной refetch: SignalR приходит почти одновременно с HTTP-ответом и оба триггерят одни и те же теги.
Реконнект
После потери и восстановления связи SignalR — инвалидация ограниченного набора collaborative-тегов:
Task, BuyerOrders, Payment, InvoicePayment, BankStatement, Shipment, Process, Chat, Notification, ProductionOrders.
Не инвалидировать все tagTypes из rtk-api.ts (справочники, шаблоны, настройки).
refetchOnFocus / visibilitychange — дополнительная страховка, не замена сокета.
Открытые формы
При событии EntityChanged для сущности, которую пользователь редактирует:
- не патчить поля формы автоматически;
- обновлять списки, шапку, read-only блоки;
- опционально: баннер «данные на сервере изменились» + ручной refetch (отдельная UX-задача).
Время жизни кеша (keepUnusedDataFor)
Сейчас почти везде дефолт RTK Query — 60 секунд. Исключение: чат — keepUnusedDataFor: 300. Динамические вкладки размонтируют страницу → через минуту кеш выкидывается → при возврате всегда полный GET. SignalR на уже удалённый кеш почти ничего не даёт: invalidateTags без подписки только помечает stale, а данных уже нет.
После появления EntityChanged (+ фильтр инициатора + инвалидация на реконнект) имеет смысл умеренно увеличить TTL для collaborative-сущностей.
Зачем:
- Быстрый возврат на вкладку — данные ещё в store, без спиннера.
- События «пока вкладка неактивна» попадают в ещё живой кеш → при remount сразу refetch, а не случайный снимок без инвалидации.
- Меньше лишних GET при частом переключении вкладок в течение сессии.
Без канала SignalR длинный TTL только ухудшает актуальность. С каналом — наоборот: кеш можно держать дольше и опираться на события.
| Сущности | Рекомендация |
|---|---|
Collaborative: Task, BuyerOrders, Payment, InvoicePayment, BankStatement, Shipment, Process, ProductionOrders | 5–15 мин (300–900 с); ориентир как у чата (300) или чуть больше |
| Справочники / шаблоны | не трогать ради SignalR |
| Бесконечно / сутки | нет: память, пропущенные события, вкладки копятся |
Глобально на весь rtkApi поднимать не стоит — только целевые query (или default 60 + override на collaborative endpoints).
Условие: удлинять после (или вместе с) EntityChanged, не вместо него. На открытой форме по-прежнему не патчить поля — TTL и SignalR про списки/карточки в кеше, не про RHF.
Где нужна инвалидация (приоритет)
| Сценарий | Польза |
|---|---|
| Два пользователя на одном заказе (продажи + бухгалтер + производство) | Высокая |
| Бухгалтер: загрузка банковской выписки (привязка к счетам + автодействия с задачами) | Высокая |
| Бухгалтер: привязка / перепривязка платежа к счёту | Высокая |
Автопереходы бека (склад → ReadyToShip, предоплата → запуск) | Высокая |
| Импорт 1C (счета, план оплат, заказы) | Не делать — выполняется один раз, на доработку EntityChanged не тратить |
| Новая задача исполнителю | Уже частично через уведомления; дублировать не обязательно |
| Справочники, SKU-параметры, шаблоны | Низкая; не включать в первую очередь |
| Изменения текущим пользователем на той же форме | Нет пользы; RTK mutation уже инвалидирует |
Точки публикации на беке (черновик)
Событие EntityChanged отправлять из мест, где меняется общее состояние, а не из каждого мелкого PATCH справочника:
TaskService.ChangeStatus,TaskDone, создание следующей задачи;BuyerOrderService— изменения заказа, товаров, пауза/отмена;PaymentScheduleService,PaymentInvoiceService,InvoicePaymentService(в т.ч. привязка/перепривязка платежа);- банковские выгрузки (
BankStatementи связанная обработка платежей → счета → задачи); ShipmentService;- автопереходы склада / производства (
HandleCheckSupportOrderTaskIsReadyToShipи аналоги).
Импорт 1C не включать в точки публикации: операция разовая, отдельная доработка под EntityChanged не нужна.
Получатели: все подключённые клиенты (broadcast компактного события). Клиент игнорирует, если соответствующего тега нет в кеше. Группы SignalR по BuyerOrder:{id} — опциональная оптимизация на потом.
Карта каскадов EntityChanged
Статический граф: операция → что слать в SignalR → какие RTK tags должны устареть → какие экраны это затрагивает.
Не анализировать в рантайме «какая задача открыта у пользователя». RTK рефетчит только активные подписки; задача маппинга — правильно пометить теги.
Ориентир для каскада — уже существующие invalidatesTags у mutation + побочные эффекты бека. У «чужих» изменений каскад должен быть не уже, чем у своих (сейчас у финансов на фронте каскад дырявый — SignalR как раз закрывает это для других клиентов).
Формат строки
| Источник (бек) | EntityChanged | RTK tags (фронт) | Экраны / query |
|---|---|---|---|
| сервис / метод | entity, id, related, initiatedByUserId | теги после маппинга | что должно обновиться |
Хелперы на беке (черновик): NotifyTaskChanged, NotifyBuyerOrderChanged, NotifyGoodsChanged, NotifyShipmentChanged, NotifyPaymentLinksChanged — внутри собирают набор сообщений или одно сообщение с богатым related.
1. Общая труба задач (база)
Ворота: TaskService.ChangeStatus → при финале TaskDone / иначе interim → SaveChanges → (часто) CreateNextTask внутри TaskDone.
Базовый каскад для любой смены статуса задачи процесса заказа покупателя:
| Источник | EntityChanged | RTK tags | Экраны |
|---|---|---|---|
ChangeStatus (после SaveChanges) | Task + id текущей; related.buyerOrderId; если создана следующая — ещё Task + id новой (или один event с related.taskId = новая) | { Task, id }, { Task, LIST }, { BuyerOrders, buyerOrderId }, { BuyerOrders, LIST }, при завершении процесса — { Process, id } / { Process, LIST } | /tasks, карточка задачи, процесс, карточка/список заказа |
Замечания:
- Сейчас фронтовый
editTaskStatusинвалидирует толькоTask+LIST— безBuyerOrders. Для инициатора state заказа может отставать; для SignalR базу сразу делать шире (сBuyerOrder). CreateNextTaskуже шлёт UX-уведомление исполнителю;EntityChangedнужен всем, у кого в кеше список задач / заказ / процесс — не только адресату нотификации.- Типы «только база» (КП, согласования КП/спецификации, подписание, запуск без отдельных побочных экранов на том же PATCH): доп. сущности не нужны, если побочные эффекты только статус задачи + state заказа + следующая задача.
Группа base (BuyerOrder process) включает типичный путь:
BeginBuyerOrder (финал без товаров-эндпоинта), CalcBuyerOrderAmount, Create/Agree/SigningCommercialProposal, Create/Agree/SigningSpecification (ручной ChangeStatus), промежуточные статусы сопровождения без правки отгрузок.
2. Группа «задача + товары» (Goods)
Проверка UI (2026-08-25): таблица товаров на сборе и расчёте идёт из RTK Goods, не из task/data.
| Экран | Источник строк таблицы | Вывод для SignalR |
|---|---|---|
Сбор (BeginBuyerOrderForm → Goods) | useFetchGoodsByBuyerOrderIdQuery(buyerOrderId) в форме + в GoodsTable (skip только если передан goodData) | достаточно { Goods, buyerOrderId } (+ BuyerOrders при цене/итогах) |
Расчёт (FormTaskCalculateGoodsCost → Goods) | goodData не передаётся со страницы → тот же useFetchGoodsByBuyerOrderIdQuery | то же |
| Вкладка «Просмотр заказа» на расчёте | тот же Goods без goodData | то же |
Сопровождение (SupportOrder) | goodData={currentTaskData?.buyerOrderShipments?.notProductGoods} → query пропущен | смена состава через Good-* всё равно бьёт в Goods tag; блок notProduct на сопровождении обновится только при инвалидации { Task, taskId } / refetch task/data |
| CreatingOrders (подписание спецификации) | orderGoods из task/data | не Good-эндпоинты; база задачи / BuyerOrder |
Код: goods-table.tsx — skip: !buyerOrderId \|\| !!goodData, строки = goodData ?? fetchedGoods. Tag: providesTags: [{ type: 'Goods', id: buyerOrderId }].
| Источник | EntityChanged | RTK tags | Экраны |
|---|---|---|---|
GoodService Add / Update / Delete (после SaveChanges; часто ещё SetPaymentSchedules) | primary BuyerOrder или отдельный entity Goods по соглашению; related.buyerOrderId обязательно | { Goods, buyerOrderId }, { BuyerOrders, id }, { BuyerOrders, LIST }; при пересчёте плана — Payment lists (invalidatePaymentLists); taskId для сбора/расчёта не обязателен | сбор, расчёт, просмотр заказа, план оплат |
| Смена статуса, если товары уже в БД | база (п.1) | база | таблица товаров подтянется с кеша Goods |
Для сопровождения / CreatingOrders при изменении только через Good-API чужой клиент на блоке из task/data может не обновиться без { Task, id } — это другой путь (отгрузки / финал спецификации), не основной сценарий сбора.
Фронт сейчас: createGood / editGood / deleteGood → Goods + BuyerOrders + весь 'Task' (шире, чем нужно для сбора/расчёта). SignalR может быть уже: Goods + BuyerOrders (+ Payment при schedule).
3. Группа «задача + отгрузки» (Shipment)
| Источник | EntityChanged | RTK tags | Экраны |
|---|---|---|---|
ShipmentService create / update / delete | Shipment + id; related.buyerOrderId, related.taskId (SupportOrder, если есть) | как фронт: Shipment LIST/id, BuyerOrders id+LIST, Task LIST + taskId | сопровождение, карточка заказа, список задач |
createShipmentDocuments / AddShipmentDocuments на беке | то же + BuyerOrders | BuyerOrders, Shipment, Task | сопровождение, документы |
SetSupportOrderTaskDone (закрытие заказа) | база + BuyerOrder (state Completed) + Process + при закрытии чата — Chat | Task, BuyerOrders, Process, Chat | заказ, процесс, чат |
| Interim-статусы SupportOrder без правки отгрузки | база (п.1) | база | шапка/статус задачи |
4. Группа «финансы» (выписка + привязка платежа)
Самый широкий каскад. Фронтовые mutation сейчас узкие (дыра для инициатора и для других):
createBankStatement→ толькоBankStatement;changeInvoicePayment(привязка/перепривязка) →InvoicePayment+ Payment LIST/SUMMARY, безBuyerOrders/Task/ Partner.
Бек при оплате предоплаты вызывает HandleSigningSpecificationTaskDone → может сменить статус задачи и state заказа минуя ChangeStatus.
Кратко по источникам:
| Источник | Primary entity / id | Когда звать хелпер |
|---|---|---|
BankStatementService.Add | BankStatement / statementId | после SaveChanges и после цикла HandleSigningSpecificationTaskDone (чтобы в taskIds попали авто-смены) |
InvoicePaymentService.ChangePaymentInvoice | InvoicePayment / paymentId | после SaveChanges и опционального HandleSigningSpecificationTaskDone |
| Комментарий к платежу | InvoicePayment / paymentId | без полного финансового хелпера — только узкий tag |
payment-summary сейчас providesTags: [{ Payment, FINANCIAL_SUMMARY }] без buyerOrderId — грубый тег; хелпер всегда ставит invalidatePaymentLists: true. Улучшение id-уровня — отдельный фронтовый долг.
Финансовый хелпер NotifyPaymentFinanceChanged
Один входной контекст → одно (или пакет) EntityChanged с заполненным related. Не ходить в SignalR из середины BindToInvoices — собрать id в контексте и вызвать хелпер в конце операции.
Контекст (бек собирает из уже загруженных сущностей)
public sealed class PaymentFinanceChangeContext
{
public Guid? InitiatedByUserId { get; init; }
/// <summary>Загрузка выписки; null при ручной привязке.</summary>
public Guid? BankStatementId { get; init; }
/// <summary>Платежи, которые созданы или чьи связи менялись.</summary>
public IReadOnlyList<Guid> InvoicePaymentIds { get; init; } = [];
/// <summary>
/// Счета, затронутые пересчётом статуса (новые связи, старые при отвязке/перепривязке, Paid/Overpaid).
/// </summary>
public IReadOnlyList<AffectedPaymentInvoice> AffectedInvoices { get; init; } = [];
/// <summary>
/// Задачи, которые реально сменились после HandleSigningSpecificationTaskDone
/// (SigningSpecification → CreatingOrders / Completed, созданная следующая задача).
/// </summary>
public IReadOnlyList<Guid> TaskIds { get; init; } = [];
/// <summary>true, если хотя бы один вызов HandleSigningSpecificationTaskDone что-то изменил.</summary>
public bool TaskAutoAdvanced { get; init; }
}
public sealed class AffectedPaymentInvoice
{
public Guid PaymentInvoiceId { get; init; }
public Guid BuyerOrderId { get; init; }
public Guid? PartnerId { get; init; }
public Guid? PaymentScheduleId { get; init; }
}
Откуда брать поля в текущем коде:
| Поле | BankStatementService.Add | ChangePaymentInvoice |
|---|---|---|
BankStatementId | id после AddAsync / SaveChanges | null |
InvoicePaymentIds | id созданных paymentsToCreate | [invoicePaymentId] |
AffectedInvoices | по links после BindToInvoices (+ счета из paidInvoiceIds); через PaymentSchedule.BuyerOrderId, Buyer → Partner | старые счета из currentInvoices + новый request.PaymentInvoiceId (если не unlink); BuyerOrder/Partner/Schedule с инвойса |
TaskIds / TaskAutoAdvanced | после foreach HandleSigningSpecificationTaskDone — вернуть/накопить id изменённых задач (сейчас метод не возвращает id: доработать return или out-список) | то же, если invoicePaid != null |
Сборка related внутри хелпера
public record EntityChangedRelated(
Guid? BuyerOrderId = null,
Guid? TaskId = null,
Guid? PartnerId = null,
Guid? PaymentInvoiceId = null,
Guid? PaymentScheduleId = null,
Guid? BankStatementId = null,
Guid? InvoicePaymentId = null,
Guid[]? BuyerOrderIds = null,
Guid[]? PartnerIds = null,
Guid[]? PaymentInvoiceIds = null,
Guid[]? InvoicePaymentIds = null,
Guid[]? TaskIds = null,
bool InvalidatePaymentLists = false,
bool TaskAutoAdvanced = false
);
Правила заполнения из PaymentFinanceChangeContext:
Поле related | Как заполнять |
|---|---|
bankStatementId | ctx.BankStatementId |
invoicePaymentIds | ctx.InvoicePaymentIds (distinct) |
invoicePaymentId | единственный id, если массив длины 1 (удобство фронта) |
paymentInvoiceIds | distinct из AffectedInvoices |
paymentInvoiceId | если ровно один счёт |
buyerOrderIds | distinct AffectedInvoices.BuyerOrderId |
buyerOrderId | если ровно один заказ |
partnerIds | distinct ненулевых PartnerId |
partnerId | если ровно один партнёр |
paymentScheduleId | только если ровно один schedule; иначе не слать скаляр (списки планов и так сбросит invalidatePaymentLists) |
taskIds | ctx.TaskIds |
taskId | если ровно одна задача |
invalidatePaymentLists | всегда true для выписки и смены привязки (сбрасывает грубые Payment LIST / FINANCIAL_SUMMARY / UNLINKED / UNPAID) |
taskAutoAdvanced | ctx.TaskAutoAdvanced — фронт может дополнительно инвалидировать Task LIST / Process, даже если taskIds пуст из‑за ошибки сбора |
Primary message:
// Выписка
entity = EnChangedEntity.BankStatement, id = BankStatementId
// Привязка / перепривязка / отвязка
entity = EnChangedEntity.InvoicePayment, id = InvoicePaymentIds[0]
Хелпер шлёт одно EntityChanged с полным related (не N сообщений на каждый счёт) — проще и один invalidate на клиенте. Исключение: если когда‑нибудь понадобится разнести права/группы — тогда пакет; на старте не нужно.
Маппинг на фронте (related → RTK tags)
function tagsFromPaymentFinance(msg: EntityChangedMessage): TagDescription[] {
const r = msg.related ?? {};
const tags: TagDescription[] = [];
if (msg.entity === 'BankStatement' && msg.id) {
tags.push({ type: 'BankStatement', id: msg.id }, 'BankStatement');
}
for (const id of unique([r.invoicePaymentId, ...(r.invoicePaymentIds ?? [])])) {
tags.push({ type: 'InvoicePayment', id });
}
tags.push('InvoicePayment');
if (r.invalidatePaymentLists) {
tags.push(
{ type: 'Payment', id: 'INVOICE_LIST' },
{ type: 'Payment', id: 'SCHEDULE_LIST' },
{ type: 'Payment', id: 'FINANCIAL_SUMMARY' },
{ type: 'Payment', id: 'UNLINKED_INVOICES' },
{ type: 'Payment', id: 'UNPAID_INVOICES' }
);
}
for (const id of unique([r.paymentInvoiceId, ...(r.paymentInvoiceIds ?? [])])) {
tags.push({ type: 'Payment', id });
}
for (const id of unique([r.buyerOrderId, ...(r.buyerOrderIds ?? [])])) {
tags.push({ type: 'BuyerOrders', id });
}
tags.push({ type: 'BuyerOrders', id: 'LIST' });
// partnerIds в related копить на беке; в tags не маппить, пока нет Partner financials query
for (const id of unique([r.taskId, ...(r.taskIds ?? [])])) {
tags.push({ type: 'Task', id });
}
if (r.taskAutoAdvanced || (r.taskIds?.length ?? 0) > 0) {
tags.push({ type: 'Task', id: 'LIST' });
}
return tags;
}
Partner financials — проверка кеша (2026-08-25)
| Слой | Статус |
|---|---|
| Бек | Есть: GET /Order/Partner/:partnerId/BuyerOrder/financials (PartnerService.GetBuyerOrderFinancials) |
| Фронт RTK | Нет endpoint в partner.api.ts / payment.api.ts; по репозиторию вызовов BuyerOrder/financials нет |
| Вкладка «Финансы» контрагента | В finance-redesign — планируется, ещё не как живой RTK query |
Что уже кешируется и обновляется финансовым хелпером через invalidatePaymentLists: true:
| Query | Tag | Связь с контрагентом |
|---|---|---|
getBuyerOrderPaymentSummary | { Payment, FINANCIAL_SUMMARY } (без buyerOrderId) | финансы заказа, не агрегат по партнёру |
getPaymentStageFinancials | { Payment, SCHEDULE_LIST } | фильтр может включать BuyerId |
getPaymentSchedulesByPartner | { Payment, SCHEDULE_LIST } | план оплат по партнёру |
getPaymentSchedules / by buyer order | { Payment, SCHEDULE_LIST } | списки планов |
Partner tag сейчас на фронте — широкая 'Partner' на почти все partner-query (карточка, контакты, договоры), не financials. Инвалидировать весь 'Partner' из финансового SignalR не стоит (лишние refetch справочников/карточки).
Что писать в маппинг сейчас
- Бек: по-прежнему заполнять
partnerId/partnerIdsвrelated(данные есть с инвойса/Buyer) — пригодится, когда появится вкладка. - Фронт
tagsFromPaymentFinance: не маппитьpartnerIds→Partnerдо появления отдельного query. - Актуальные экраны после выписки/привязки закрываются тегами Payment LIST +
BuyerOrders+ при необходимостиTask— без Partner. - Когда добавят
fetchPartnerBuyerOrderFinancials:providesTagsпо id партнёра: отдельный Payment-тег видаPARTNER_FINANCIALS_+ id (предпочтительнее), либо id-уровень у Partner — но не широкий tag без id, чтобы не смешивать с карточкой/контактами;- в маппинге: для каждого id из
partnerIdsпушить этот tag; - не полагаться на широкую инвалидацию всех Partner-query.
Вызов из сервисов (псевдокод)
// BankStatementService.Add — после SaveChanges
var paidInvoiceIds = ...; // уже есть
var affected = await BuildAffectedInvoicesFromPayments(paymentsToCreate);
var taskIds = new List<Guid>();
var advanced = false;
foreach (var paidInvoiceId in paidInvoiceIds)
{
var result = await taskService.HandleSigningSpecificationTaskDone(paidInvoiceId, user);
// доработать: при успешной смене статуса добавлять taskId (+ nextTaskId) в taskIds, advanced = true
}
await entityChangeNotifier.NotifyPaymentFinanceChanged(new PaymentFinanceChangeContext
{
InitiatedByUserId = user.Id,
BankStatementId = bankStatementEntity.Entity.Id,
InvoicePaymentIds = paymentsToCreate.Select(p => p.Id).ToArray(),
AffectedInvoices = affected,
TaskIds = taskIds,
TaskAutoAdvanced = advanced
});
// InvoicePaymentService.ChangePaymentInvoice — после SaveChanges
var affected = /* old invoices + new invoice, with BuyerOrderId/PartnerId/ScheduleId */;
var taskIds = new List<Guid>();
var advanced = false;
if (invoicePaid != null)
{
await taskService.HandleSigningSpecificationTaskDone(invoicePaid.Id, user);
// накопить taskIds
}
await entityChangeNotifier.NotifyPaymentFinanceChanged(new PaymentFinanceChangeContext
{
InitiatedByUserId = user.Id,
InvoicePaymentIds = [invoicePaymentId],
AffectedInvoices = affected,
TaskIds = taskIds,
TaskAutoAdvanced = advanced
});
Связь с HandleSigningSpecificationTaskDone
Не дублировать полный финансовый каскад внутри авто-смены задачи. Варианты:
- Предпочтительно: финансовый сервис после цикла авто-задач один раз зовёт
NotifyPaymentFinanceChangedс уже заполненнымиtaskIds. HandleSigningSpecificationTaskDoneсам шлёт узкийNotifyTaskChanged(база п.1), а финансы — отдельно безtaskIds— риск двух событий; допустимо, если идемпотентно по tags.
Не вызывать финансовый хелпер из NotificationService.
Минимальный vs полный related
| Сценарий | Минимум, чтобы менеджер на заказе увидел правду | Полный |
|---|---|---|
| Выписка, платежи не привязались | BankStatement + invalidatePaymentLists + invoicePaymentIds | + partner suggestions позже |
| Выписка, привязка без Paid предоплаты | + buyerOrderIds / paymentInvoiceIds | + partnerIds |
| Выписка/привязка → Paid предоплаты → авто-задача | + taskIds / taskAutoAdvanced | + BuyerOrders LIST |
| Отвязка платежа | invoicePaymentId + affected старый счёт/заказ + lists | без taskIds |
5. Группа «изделие / SKU» (вне или рядом с заказом)
| Источник | EntityChanged | RTK tags | Экраны |
|---|---|---|---|
SetAgreeCreateProductTaskDone / SetAgreeCreateSkuTaskDone | Task + id; Process + id; StockKeepingUnit / Product + id (ApprovalInProgress = false) | Task, Process, Product / StockKeepingUnit; при отображении товара заказа с этим SKU — Goods (широко или по заказам, если известно) | согласование изделия/SKU, карточка SKU, таблицы товаров в заказах, где SKU в составе |
Приоритет ниже, чем BuyerOrder-процесс + финансы + отгрузки, но каскад заложить в карту.
6. Обходы ChangeStatus (обязательные точки notifier)
| Источник | Почему отдельно | Каскад |
|---|---|---|
HandleCheckSupportOrderTaskIsReadyToShip | склад → авто ReadyToShip; минует ChangeStatus; уже есть auto-notification | Task (support) + BuyerOrder + LIST |
HandleSigningSpecificationTaskDone | из выписки / привязки платежа; статус CreatingOrders + state ProductionStarted | Предпочтительно не слать отдельный полный финансовый каскад отсюда: накопить taskIds и отдать в NotifyPaymentFinanceChanged вызывающему сервису. Узкий NotifyTaskChanged — запасной вариант |
Создание заказа / пути с CreateTaskCreateNotification без ChangeStatus | новая задача | Task LIST + новая Task id + BuyerOrder |
Правило: каждый путь с SaveChanges по collaborative-сущности и без прохода через уже покрытый notifier — явная строка в карте.
7. Вне скоупа (не тратить время)
| Источник | Решение |
|---|---|
| Импорт 1C | не подключать к EntityChanged |
| Справочники, шаблоны, настройки | не в первой очереди |
| Комментарий платежа | узкий InvoicePayment достаточно; можно без BuyerOrder |
8. Порядок реализации по карте
- База:
ChangeStatus+CreateNextTask(п.1). - Обходы:
HandleCheckSupportOrderTaskIsReadyToShip,HandleSigningSpecificationTaskDone(п.6). - Финансы: выписка + привязка платежа (п.4) — самый большой выигрыш для «другого пользователя».
- Товары
GoodService(п.2). - Отгрузки
ShipmentService(п.3). - Agree Product/SKU (п.5) — по остаточному приоритету.
Параллельно на фронте: глобальный маппинг entity → tags; по возможности сузить FINANCIAL_SUMMARY до id по заказу. Товары сбора/расчёта — через Goods (проверено). Partner BuyerOrder/financials на фронте ещё нет — partnerIds в related копить, в tags не маппить до появления query (проверено).
9. Подход к данным на фронте (теги и каскады mutation)
Подход к данным менять стоит в части тегов и каскадов mutation, чтобы они совпадали с картой SignalR. Иначе сокет будет компенсировать дыры в RTK (в том числе у инициатора).
Делать заодно с EntityChanged (точечно):
- Симметрия своих mutation и SignalR —
invalidatesTagsу выписки (createBankStatement) и привязки/перепривязки платежа (changeInvoicePayment) расширить по той же карте, что иNotifyPaymentFinanceChanged(Payment lists,BuyerOrders, при авто-статусе —Task). Сейчас каскад узкий: инициатор тоже может видеть stale. - Сужать грубые Payment-теги —
FINANCIAL_SUMMARY/SCHEDULE_LISTбез id бьют все открытые сводки. Итеративно: id по заказу / партнёру / schedule. Одинаково важно для mutation и для SignalR. - Один источник правды на экране — сбор/расчёт уже на
Goods(хорошо). Новые блоки не класть вtask/data, если есть entity-query (иначе снова нуженtaskIdв каждом каскаде). Сопровождение / CreatingOrders изtask/data— не переписывать сразу. keepUnusedDataForдля collaborative — после появления канала.- Убрать refetch задач с
NotificationsUpdated/useNotificationRefetch, когда заработаетEntityChanged.
Не раздувать «заодно»:
- полный перевод всего на RTK / выкидывание оставшихся redux-slice;
- Cache Patching вместо invalidation;
- Partner financials + вкладка контрагента — из finance-redesign, не блокер SignalR;
- переписывание форм RHF / всего
task/data; - группы SignalR, MediatR, outbox.
Практичный порядок вместе с сокетом:
1. EntityChanged (база → финансы → …) + listener
2. Подтянуть invalidatesTags у выписки / привязки под ту же карту
3. Сузить FINANCIAL_SUMMARY / SCHEDULE по id (итеративно)
4. keepUnusedDataFor + убрать useNotificationRefetch для Task
5. Новые экраны — entity-query, не раздувать task/data
Бек: архитектура
Разделение уведомлений и инвалидации кеша
Не смешивать с NotificationService. Сейчас refetch задач на фронте завязан на NotificationsUpdated — это временный обход из‑за отсутствия отдельного канала. При реализации развести:
Уведомления (NotificationService) | Инвалидация кеша (EntityChangeNotifier) | |
|---|---|---|
| Назначение | показать человеку событие | сообщить клиентам, что данные устарели |
| Хранение | БД (NotificationNotifications) | нет |
| Адресат | Clients.User(userId) | Clients.All + фильтр initiatedByUserId на клиенте |
| Событие SignalR | NotificationsUpdated | EntityChanged |
| Когда шлём | не всегда (только кому надо знать) | при любом значимом изменении сущности |
| Ошибка SignalR | log, транзакцию не откатывать | то же |
Сценарии не совпадают:
- бухгалтер загружает выписку или привязывает/перепривязывает платёж → у менеджера на карточке заказа (финансы, статусы задач) кеш должен обновиться, но UX-уведомление может не прийти;
- автопереход
ReadyToShipсо склада → уведомление только исполнителю, а заказ может смотреть начальник производства; - напоминание / чат → уведомление есть, инвалидация других сущностей не нужна.
Не вызывать notifier из NotificationService.Add() и не вешать на создание уведомления как единственный триггер.
Отдельный сервис
Да — тонкий сервис, без MediatR и domain events на первом этапе.
// Services/Shared/Interfaces/IEntityChangeNotifier.cs
public interface IEntityChangeNotifier
{
Task NotifyAsync(EntityChangedMessage message, CancellationToken ct = default);
Task NotifyFromChanges(ChangedEntity[] changes, Guid? initiatedByUserId = null, CancellationToken ct = default);
}
// Models/Messages/EntityChangedMessage.cs
public record EntityChangedMessage(
EnChangedEntity Entity, // Task, BuyerOrder, BankStatement, InvoicePayment, ...
Guid Id,
EntityChangedRelated? Related = null,
Guid? InitiatedByUserId = null // null — системный/фоновый вызов
);
// Полный related (в т.ч. финансовые массивы) — см. карту п.4 / NotifyPaymentFinanceChanged
public record EntityChangedRelated(
Guid? BuyerOrderId = null,
Guid? TaskId = null,
Guid? PartnerId = null,
Guid? PaymentInvoiceId = null,
Guid? PaymentScheduleId = null,
Guid? BankStatementId = null,
Guid? InvoicePaymentId = null,
Guid[]? BuyerOrderIds = null,
Guid[]? PartnerIds = null,
Guid[]? PaymentInvoiceIds = null,
Guid[]? InvoicePaymentIds = null,
Guid[]? TaskIds = null,
bool InvalidatePaymentLists = false,
bool TaskAutoAdvanced = false
);
internal class EntityChangeNotifier(
IHubContext<NotificationHub> hubContext,
ILogger<EntityChangeNotifier> logger) : IEntityChangeNotifier
{
public async Task NotifyAsync(EntityChangedMessage message, CancellationToken ct = default)
{
try
{
await hubContext.Clients.All.SendAsync("EntityChanged", message, ct);
}
catch (Exception e)
{
logger.LogError(e, "Failed to publish EntityChanged {@message}", message);
}
}
}
Сервис отправки в SignalR по-прежнему тонкий. Разбор ChangedEntity[] / ChangeSet (allowlist, related) — в NotifyFromChanges или отдельном маппере рядом. Сбор финансового related по возможности из снимка; явный NotifyPaymentFinanceChanged(PaymentFinanceChangeContext) — запасной путь (карта п.4).
Регистрация в DI рядом с нотификациями:
services.AddTransient<IEntityChangeNotifier, EntityChangeNotifier>();
Хелперы (вторично, пока нет полного покрытия анализатором):
Task NotifyTaskChanged(Guid taskId, Guid? buyerOrderId = null, Guid? initiatedByUserId = null);
Task NotifyBuyerOrderChanged(Guid buyerOrderId, Guid? initiatedByUserId = null);
Task NotifyPaymentFinanceChanged(PaymentFinanceChangeContext context);
Hub: один, события разные
Отдельный hub не нужен — один WebSocket, разные события. URL /hubs/notifications оставить (переименование hub — косметика на потом).
NotificationsUpdated— UX-уведомления, push, unread;EntityChanged— инвалидация кеша.
Универсальный обработчик от ChangedEntity[] (предпочтительный способ публикации)
Вместо точечных NotifyTaskChanged / NotifyPaymentFinanceChanged по всему коду — основной путь: после успешного SaveChanges передать снимок изменений в универсальный анализатор, который по allowlist и правилам карты шлёт EntityChanged.
Уже есть паттерн логирования:
changes = GetChangesForLog() // ChangeTracker до SaveChanges
SaveChanges
log(changes)
→ NotifyFromChanges(changes, user) // только после успеха
GetChangesForLog() сейчас собирает ChangedEntity для логов (имя, state, свойства; PK в строке ShortView). Для SignalR этого мало — снимок нужно слегка доработать: структурный id сущности, clr-тип/имя, state, нужные FK (например BuyerOrderId, PartnerId), а не парсинг ShortView.
Зачем
- меньше забытых точек (обходы
ChangeStatus, несколькоSaveChangesв одном сценарии); - один allowlist и один маппинг entity →
EntityChanged/related; - выписка: в одном
SaveChangesчасто уже statement + payments + links + статусы счетов — из трекера можно собрать богатыйrelated, близкий к финансовому хелперу.
Ограничения (обязательно учесть)
| Риск | Как закрыть |
|---|---|
Шум из трекера (DateOfStatusChange, assistants, join-таблицы) | Allowlist collaborative-сущностей; остальное игнорировать |
Слабый контракт ChangedEntity сейчас | Структурный id + FK в снимке / расширении GetChangesForLog |
| Неполная семантика | Правила маппинга по карте каскадов (Good → Goods + BuyerOrder; пачка InvoicePayment → одно финансовое сообщение) |
| Несколько DbContext | Отдельный SaveChanges task/order → отдельные вызовы анализатора; tags идемпотентны |
initiatedByUserId | Передавать UserShort / user id в NotifyFromChanges |
| Справочники / Settings | Не вешать обработчик на каждый SaveChanges подряд; только hot-path / обёртка на LogicContext collaborative-операций |
Как внедрять
NotifyFromChanges(ChangeSet|ChangedEntity[], Guid? initiatedByUserId)(или обёрткаSaveChangesAndNotifyAsync) — внутри allowlist + правила → один или несколькоNotifyAsync.- Allowlist: Task, BuyerOrder, Good, Shipment, BankStatement, InvoicePayment, PaymentInvoice, Process, … (как collaborative в карте).
- Финансовый каскад по возможности собирать из одного снимка выписки/привязки; отдельный
NotifyPaymentFinanceChanged(context)— запасной/явный путь, если трекера не хватает. - Явные
NotifyTaskChanged/ ручная сборкаrelated— исключения, не основной стиль; не дублировать авто и ручной вызов на одном пути без нужды. - Универсальность — в анализаторе; не обязательно вручную вставлять вызов в каждую строку
SaveChangesсразу — хелпер + перевод hot-path постепенно.
Итог: универсальный обработчик от снимка изменений после SaveChanges — да, предпочтительно; слать «по всем сущностям из трекера без фильтра» — нет.
Откуда вызывать
Из доменных сервисов, после успешного SaveChanges. Не из контроллеров. Предпочтительно через NotifyFromChanges (см. выше), а не ручной EntityChanged в каждом методе.
Controller → Service → GetChangesForLog → SaveChanges → NotifyFromChanges → (опционально) NotificationService
Почему не контроллер: значимые изменения идут из TaskService, TaskServiceInternal, BuyerOrderService, фоновых автопереходов — контроллеры их не покрывают.
Почему не NotificationService: другая ответственность + пропуски (изменение без уведомления).
Рядом с нотификацией, не внутри
Предпочтительный вид:
var changes = taskContext.GetChangesForLog(); // или расширенный ChangeSet
await taskContext.SaveChangesAsync();
await entityChangeNotifier.NotifyFromChanges(changes, user.Id);
await notificationService.CreateTaskNotification(...); // если нужно человеку
Явный вызов (исключение, если анализатор ещё не покрывает кейс):
await taskContext.SaveChangesAsync();
await entityChangeNotifier.NotifyAsync(new EntityChangedMessage(
EnChangedEntity.Task, taskId,
new EntityChangedRelated(BuyerOrderId: task.BuyerOrderId, TaskId: taskId),
InitiatedByUserId: user.Id));
await notificationService.CreateTaskNotification(...);
Три варианта side effect после сохранения:
- только notifier — тихое изменение, фон, правка заказа без push;
- только notification — редко для кеша (например, «прочитано»);
- оба — новая задача, автопереход статуса.
Единые «ворота» (приоритет)
Переводить на NotifyFromChanges после SaveChanges (не дублировать ручной NotifyAsync на тех же путях):
TaskService.ChangeStatus— послеSaveChanges(большинство задач).TaskServiceInternal.HandleCheckSupportOrderTaskIsReadyToShipи аналоги — минуютChangeStatus.TaskServiceInternal.CreateNextTask/ веткиTaskDone— task + buyerOrder + process list.BuyerOrderService.Update, пауза/отмена, смена ответственного.PaymentScheduleService,PaymentInvoiceService,InvoicePaymentService— карта п.4; финансы по возможности из снимка.- Банковские выгрузки — карта п.4.
ShipmentService— карта п.3.GoodService— карта п.2.
Импорт 1C в список вызовов не добавлять (разово, без доработки под кеш).
Не дублировать в каждом Set*TaskDone, если все проходят через ChangeStatus — достаточно одной точки + явных обходных путей. Allowlist в анализаторе важнее, чем полный список ручных вызовов.
Кому слать: инициатор и двойной refetch
Инициатору SignalR не нужен — его кеш уже обновит mutation или ответ эндпоинта. Если слать EntityChanged и инициатору, возможна цепочка:
1. PATCH уходит на бек
2. SaveChanges → EntityChanged (SignalR) → HTTP-ответ с данными
3. На клиенте почти одновременно:
- SignalR → invalidateTags → refetch
- mutation fulfilled → invalidatesTags → refetch (или update из ответа)
Это не рассинхрон, а лишний GET на те же теги. RTK Query частично схлопывает параллельные refetch, но при разнесении по времени второй запрос всё же возможен — заметнее на тяжёлых query (GET .../data, payment-summary).
Почему не Clients.Others
EntityChangeNotifier шлёт через IHubContext вне hub-метода. В этом контексте нет «текущего подключения» — Clients.Others / Clients.Caller не исключают инициатора так, как в hub-методе, вызванном клиентом. Исключить инициатора на беке можно только явно (по userId, connection id, группам).
Рекомендуемый подход
- Бэк шлёт
Clients.All, в payload —initiatedByUserId(изUserShort userсервиса;nullдляUserShort.System(), автопереходов склада). - Фронт в глобальном listener:
if (message.initiatedByUserId && message.initiatedByUserId === currentUserId) {
return;
}
dispatch(invalidateTagsForEntity(message));
- Фоновые/системные изменения (
initiatedByUserId: null) получают все, включая пользователя на экране без своей mutation.
Альтернативы (не на старт)
| Подход | Плюсы | Минусы |
|---|---|---|
Clients.All без фильтра | проще всего | лишний refetch у инициатора |
initiatedByUserId + ignore на клиенте | просто, надёжно | нужен currentUserId в listener |
Сервер шлёт всем, кроме userId | меньше трафика | нет built-in AllExceptUser, сложнее |
| Debounce invalidate на фронте | меньше дублей | эвристика, хрупко |
Правила реализации на беке
- Публиковать после commit (
SaveChangesAsync), не до — иначе клиент refetch'нет до записи в БД. - Best-effort: ошибка SignalR — log, HTTP-ответ успешный (как сейчас push в
NotificationService). - Шлём через
Clients.All; инициатора отсекаем на клиенте поinitiatedByUserId. Не полагаться наClients.Othersиз сервиса. - Не тащить в notifier проверку прав — права на GET; событие только
{ entity, id, related?, initiatedByUserId? }. - Группы SignalR (
BuyerOrder:{id}) — позже, если broadcast станет узким местом.
Миграция с текущей реализации
На фронте useNotificationRefetch слушает NotificationsUpdated для задач/процессов — заменить на EntityChanged:
- Бек:
EntityChangeNotifier+ вызовы из сервисов. - Фронт: глобальный listener на
EntityChanged→invalidateTags. - Убрать refetch задач из
NotificationsUpdated/useNotificationRefetchдляTask/Process. NotificationsUpdatedоставить только для колокольчика и чата.
Что не делать на беке
- Вызывать notifier из
NotificationService.Add/CreateTaskNotification. - Дублировать payload задачи/заказа в сокете.
- Ставить вызовы в контроллеры.
- Полагаться на
Clients.OthersизIEntityChangeNotifierдля исключения инициатора. - Ждать MediatR / outbox на первом этапе — для внутренней системы избыточно.
- Слать
EntityChangedпо всем entries ChangeTracker без allowlist. - Опираться только на парсинг PK из
ShortViewбез структурного снимка. - Дублировать на одном пути и
NotifyFromChanges, и ручной полный каскад без нужды.
Предусловия на фронте
Реализовывать после стабилизации тегов RTK Query по целевым сущностям, а не после «полного перевода всего на RTK Query».
Доработать id-уровень там, где сейчас широкая инвалидация:
Partnerбез id;- часть финансов в redux-slice вместо RTK tags (см. аудит импорта 1C).
Без нормальных providesTags / invalidatesTags сокет бесполезен.
После (или вместе с) каналом EntityChanged — увеличить keepUnusedDataFor для collaborative query (ориентир 300–900 с), не на весь rtkApi. До канала длинный TTL не поднимать.
Затронутые роли
Все роли, работающие параллельно над одним заказом или задачей:
- менеджер по продажам, помощник, начальник продаж;
- бухгалтер (загрузка выписок; привязка / перепривязка платежей к счетам);
- менеджер производства, начальник производства;
- снабженец (при пересечении с заказом/складом).
Затронутые страницы и код
Документация:
Фронт:
shared/lib/signalr/shared/api/rtk-api.ts,entities/*/api/*.api.tsapp/app.tsx— глобальный listener,onReconnected
Бек:
Hubs/NotificationHub.cs— тот же hub, новое событиеEntityChangedServices/Shared/—IEntityChangeNotifier,EntityChangeNotifierModels/Messages/EntityChangedMessage.cs, enumEnChangedEntity- точки вызова в
TaskService,TaskServiceInternal,BuyerOrderService, оплатах, отгрузках (не импорт 1C) - не в
NotificationService
Критерии приёмки
- Пользователь A открыл заказ; бухгалтер загрузил выписку или привязал/перепривязал платёж (или другой пользователь сменил статус задачи) — у A обновляются список и карточка без F5 (если вкладка/подписка активна).
- Автопереход статуса сопровождения со склада отражается у менеджера производства без ручного обновления.
- После реконнекта SignalR активные экраны подтягивают свежие данные по collaborative-тегам.
- Открытая форма редактирования не затирается данными с сервера без явного действия пользователя.
- Справочники и редко коллидирующие сущности не генерируют лишний трафик.
- Права на данные по-прежнему проверяются через GET; событие сокета не отдаёт полные DTO без авторизации.
- Инициатор изменения не получает лишний refetch от SignalR (фильтр по
initiatedByUserId). - Collaborative-данные переживают переключение вкладок дольше дефолтных 60 с и остаются актуальными за счёт
EntityChanged/ реконнекта.
Решение (предварительное)
- Делать real-time инвалидацию кеша, но узко — collaborative-сущности процесса заказа.
- Не делать универсальную шину «любая сущность → любой кеш» и payload-first для крупных агрегатов.
- Отдельное событие
EntityChanged, не смешивать с UX-уведомлениями. - Отдельный сервис
IEntityChangeNotifier; публикация предпочтительно черезNotifyFromChangesпослеSaveChanges(анализChangedEntity[]/ ChangeSet + allowlist), а не ручные вызовы по всему коду. Рядом сNotificationService, не из него. - Один глобальный маппинг entity → RTK tags + ограниченная инвалидация на реконнект.
initiatedByUserIdв payload; инициатор игнорирует событие на клиенте (кеш обновляет mutation).- Для collaborative-сущностей увеличить
keepUnusedDataFor(порядка минут) после появленияEntityChanged. - Каскады брать из карты: база задачи → обходы → финансы → товары → отгрузки → изделие/SKU.
- Теги и каскады mutation на фронте выровнять с картой SignalR (выписка/привязка, сужение Payment tags) — см. п.9. Не полный рефакторинг модели данных.
- Patching — только для чата и подобных мелких структур.
Связанные задачи разработки
- ITR-2794 — инвалидация задач через SignalR (бек + фронт)
- ITR-2924 — автоматический сбор изменений из сохранения, реестр правил
- ITR-2951 — инвалидация заказа покупателя и дочерних сущностей
- ITR-2982 — перезапрос данных на iOS при возврате из фона
Что не делать
- Слать имя сущности без
id. - Слать полный агрегат заказа/задачи в сокете.
- Подписывать каждый виджет отдельным
useSignalREffectдля кеша. - Сбрасывать все теги RTK на каждый реконнект.
- Вешать инвалидацию кеша на существующие push-уведомления как единственный канал.
- Вызывать notifier из
NotificationService. - Ставить вызовы notifier в контроллеры.
- Увеличивать
keepUnusedDataForдля всех tagTypes или до появленияEntityChanged. - Вешать
EntityChangedна импорт 1C — операция разовая, время на доработку не тратить. - Полный рефакторинг модели данных / всех screens «заодно» с SignalR — только теги и каскады mutation по карте.
- Слать
EntityChangedпо всем сущностям из ChangeTracker без allowlist (справочники, join-таблицы, DateOfStatusChange и т.п.). - Парсить PK только из
ShortViewбез доработки структурного снимка изменений.