Уведомления
Продуктовая и доменная карта 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) состав меняет, но это уведомление не шлёт.
Каналы доставки
Одно событие при создании записи уведомления может пройти по трём каналам:
- In-app — запись в БД (схема Notification); список / непрочитанные / прочтение по HTTP.
- SignalR — хаб
/hubs/notifications, событиеNotificationsUpdatedс счётчиком и телом уведомления. Доставка конкретному пользователю, не всем. - 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 |