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

Уведомления

Продуктовая и доменная карта in-app уведомлений, напоминаний и Web Push. Для пользователей: Уведомления и чаты. Живая выжимка по коду — в cursor-architecture.md (§ «Уведомления»). Исторический UX-прототип: notification.md. Чаты — см. chats.md.

Что видит пользователь​

  • Колокольчик в шапке → выдвижная панель: уведомления (задачи, процессы, напоминания, сообщения чата и т.п.), фильтр непрочитанных, «прочитать все».
  • Карточка ведёт на задачу, заказ, процесс, чат или другую страницу (ссылка / id в уведомлении).
  • Иконка сообщений — панель чатов и отдельный счётчик непрочитанных сообщений в чатах.
  • Профиль → Подписки: отдельно «уведомления» и «уведомления из чатов» (Web Push).

Счётчик непрочитанных и список колокольчика обновляются в реальном времени, пока открыта вкладка с активным соединением SignalR.

Типы и сценарии​

Тип (UI)Когда создаётсяКомуПереходPush
По задачеНовая задача; добавление в задачу; автосмена статуса и др.См. получатели по задачамЗадачаДа (по умолчанию)
По корректировкеТребование или результат корректировкиУчастники корректировкиЗадачаДа
По процессуЗавершение процесса; смена ответственного или сопровождающего заказа; изменение плана оплат с отменой счетов / отвязкой платежейПри завершении процесса — см. получатели; иначе — затронутые сотрудники заказаПроцесс или заказ (часто вкладка оплат)Да
НапоминаниеПриближение дедлайна задачи; дата следующего контакта по заказу покупателя; дата следующего контакта с контактным лицом контрагентаДедлайн — исполнитель и соисполнители; next contact — сотрудники access group партнёраЗадача / заказ / карточка партнёраДедлайн задачи — без push; next contact — с push
По чатуНовое сообщение в чатеАктивные участники, кроме автораЧат (колокольчик и панель чатов)Да (отдельная подписка «из чатов»)
По контрагентуЗаложен под приближение даты контакта с контрагентом (партнёр / контактное лицо)——Тип в фильтре есть; сейчас эти сценарии создают «Напоминание», не этот тип

Ежедневные напоминания (дедлайны и next contact) запускает трекер: вызов API POST /Notification/Reminder/send-daily (вместе с Google-синхронизацией заказов).

Получатели по задачам и процессам​

Инициатор действия (сотрудник, от чьего имени уходит событие) не получает уведомление по этому событию. Роли на задаче: автор, исполнитель, соисполнители, наблюдатель (поле на задаче) и наблюдатели пользовательской задачи (список).

СобытиеКому уходит
Создание задачиИсполнитель, соисполнители, наблюдатель и наблюдатели списка (если заданы)
Добавление в пользовательскую задачу (смена состава)Только новые соисполнители и новые наблюдатели списка
Автосмена статуса задачиИсполнитель и соисполнители
Приближение дедлайна задачиИсполнитель и соисполнители
Завершение процессаПо всем задачам процесса: авторы, исполнители, соисполнители, наблюдатель и наблюдатели списка (уникальный набор сотрудников)

Соисполнители и списки наблюдателей в основном у пользовательских задач. У процессных чаще заполнены исполнитель и одиночный наблюдатель; при создании следующей задачи процесса уведомление всё равно строится по тем же правилам.

Смена соисполнителей / наблюдателей с уведомлением «вы добавлены» — при обновлении пользовательской задачи через основной API смены состава. Правка наблюдателей через сохранение данных задачи (UpdateData) состав меняет, но это уведомление не шлёт.

Каналы доставки​

Одно событие при создании записи уведомления может пройти по трём каналам:

  1. In-app — запись в БД (схема Notification); список / непрочитанные / прочтение по HTTP.
  2. SignalR — хаб /hubs/notifications, событие NotificationsUpdated с счётчиком и телом уведомления. Доставка конкретному пользователю, не всем.
  3. Web Push — в браузер/ОС, если у сотрудника есть активная подписка нужного типа и для сценария не отключён push.

Подписки Web Push хранятся в домене сотрудников (Employee), не в схеме Notification. Типы подписки: обычные уведомления и сообщения чата. Уведомление типа «чат» уходит в подписку «сообщения»; остальные — в «уведомления».

Web Push: один браузер — один владелец​

Это ограничение модели браузера, а не случайный баг UI:

  • на один origin в одном профиле браузера обычно одна push-подписка → один endpoint;
  • в БД уникальна пара «endpoint + тип подписки»; при подписке другого пользователя строка перепривязывается к текущему сотруднику;
  • параллельно двум аккаунтам ОлМаг с одного браузера (один профиль) получать push нельзя — нужны разные профили браузера или устройства.

Отписка деактивирует запись по endpoint и типу. Статус «подписан» в профиле смотрится только для текущего сотрудника и текущего endpoint.

Что не является уведомлением колокольчика​

Событие SignalR InvalidateCache обновляет клиентский кеш сущностей (списки, карточки). Оно идёт через тот же хаб, но не создаёт запись в колокольчике и не шлёт Web Push. См. signalr-cache-invalidation.md.

Часть экранов (в том числе чаты) слушает NotificationsUpdated, чтобы обновить список — это побочный realtime-канал, не отдельный «чат-хаб».

Связь с чатами​

Сообщение в чате создаёт запись типа «По чату»: она попадает в колокольчик (список / счётчик / «прочитать все»), обновляет список и окно чата по SignalR NotificationsUpdated и уходит в Web Push по подписке «из чатов» (если включено). Отдельный счётчик непрочитанных сообщений в панели чатов (Chat/…/unread/count) остаётся. Mentions и вложения не вводят отдельный тип: в превью текст приводится к читаемому виду (@Имя, «Фото», имя файла). Подробности — в chats.md и cursor-architecture.md (§ «Чат»).

Где смотреть в коде​

СлойОриентир
БекNotificationService, ReminderService, TaskServiceInternal (создание / процесс / новые участники), NotificationHub, PushSubscriptionService
Фронтentities/notification, подписки в профиле (profile-subscribe-card), SignalR-контекст
ТрекерTrackingService → send-daily