2026-11-20 — Настройки оповещений в чатах
Статус: Согласование
Источник: Алексей (ITR-3310); уточнения по MVP — Олег / разбор в чате
Эпик: ITR-3310
Связанные материалы: chats.md, notifications.md, notifications-and-chats.md, chat-mentions.md.
Цель
Дать сотруднику личный контроль, когда чат «шумит»: toast в приложении и Web Push по сообщениям — без отключения самой переписки. Список чатов, непрочитанные и открытое окно обновляются всегда. Колокольчик в шапке в этом эпике не меняем.
Контекст
Как сейчас
- Каждое новое сообщение создаёт уведомление «По чату» всем активным участникам кроме автора.
- По тому же событию фронт обновляет список/окно чата и показывает toast; при подписке уходит Web Push «из чатов».
- Обращения (
@) в тексте уже есть, но не влияют на то, кому показывать toast/push: алерт уходит всем. - Ответ на сообщение (цитата) тоже не даёт отдельного правила оповещения.
- Глобально в профиле можно только включить/выключить Web Push «из чатов» целиком; настроек на чат и дефолтов по типу нет.
- Жалоба: слишком много оповещений из чатов (в т.ч. групповых); пример ожидания — «из групповых только при упоминании».
Как должно быть
- У каждого активного участника на каждый чат — режим оповещений:
- Все — toast и push на каждое новое сообщение (как сейчас по смыслу алерта);
- Только упоминания и ответы — toast и push, только если вас
@упомянули или сообщение — ответ на ваше; - Выкл — toast и push по сообщениям этого чата не показываем.
- Список чатов, бейджи непрочитанных, превью последнего сообщения и открытая лента обновляются при любом режиме.
- В настройках панели чатов — пункт, открывающий модалку дефолтов по типу чата для новых чатов / при вступлении; на уже существующих чатах задним числом не перетираем.
- Колокольчик: записи «По чату» и счётчик колокольчика — как сейчас (эпик их не режет и не перестраивает).
Пользовательские сценарии
- Приглушить групповой чат. В «Информации о чате» выбирает «Только упоминания и ответы». Обычные сообщения коллег: список и непрочитанные обновляются, toast и push нет. Когда кого-то
@упомянули его или ответили на его сообщение — toast (и push при подписке) приходят. - Полностью выключить алерты по чату. Режим «Выкл»: переписка и непрочитанные работают, toast/push по этому чату нет.
- Вернуть всё. Режим «Все» — снова toast/push на каждое сообщение.
- Дефолт на будущее. В настройках панели чатов открывает пункт про оповещения → модалка: для групповых — «только упоминания и ответы», для личных — «все». Новый групповой чат (или вступление) получает этот режим; уже открытые чаты не меняются сами.
- Переопределение. Дефолт «только упоминания», но в одном важном групповом вручную ставит «Все» — действует только этот чат.
- Чужой участник. Настройка личная: коллега со своим режимом; чужой выбор не видит и на него не влияет.
Принятые решения
| Тема | Решение |
|---|---|
| Scope | Только чатовые алерты: toast в приложении и Web Push «из чатов». Колокольчик не меняем |
| Режимы на чат | Все | Только упоминания и ответы | Выкл — для любого типа чата |
| Упоминание | Сотрудник есть среди обращений @ в этом сообщении |
| Ответ | Сообщение с ответом на сообщение, автором которого является текущий сотрудник |
| Список / unread / лента | Обновляются всегда, независимо от режима |
| Расчёт алерта | На беке: нужно ли алертовать этого получателя |
| Push | Если алерт не нужен — не отправляем |
| SignalR | Событие уходит всегда (чтобы обновить чаты); в пейлоаде флаг shouldAlert (true / false) |
| Фронт | Одна развилка: при shouldAlert === false не показывать toast; остальное поведение realtime без изменений |
| Колокольчик | Запись «По чату» и поведение колокольчика — как сейчас (не фильтруем по режиму в этом эпике) |
| Где менять режим чата | «Информация о чате» → блок оповещений (личный) |
| Где менять дефолты по типу | Настройки панели чатов — дополнительный пункт, открывает модалку с режимом по каждому типу чата |
| Мастер / пресет при первом заходе | Нет — пользователь сам выставляет дефолты в модалке, когда понадобится |
| Дефолты по типу | Да, в MVP: хранятся у сотрудника; применяются при создании чата с участием / вступлении в чат |
| Существующие чаты | Дефолты не перезаписывают уже выставленный режим на участнике |
| Стартовый режим, если дефолт не задан | Все (как сегодняшнее поведение алертов) |
| Права | Активный участник меняет только свой режим; чужие режимы не редактирует |
| Отдельный тип «вас упомянули» | Не вводим; формулировки toast/push остаются в духе текущего «новое сообщение» |
Схема доставки
Новое сообщение
→ для каждого активного участника кроме автора:
бек считает shouldAlert по режиму чата + упоминание/ответ
SignalR → всегда (shouldAlert true|false) → фронт: список/лента всегда;
toast только если shouldAlert
Web Push → только если shouldAlert
колокольчик → как сейчас (без изменений в этом эпике)
Дефолты «из коробки»
Пока пользователь сам не задал значения в модалке — для всех типов Все. Отдельного мастера и автопресета «групповые = только @» при первом заходе нет.
Критерии приёмки
- Активный участник в «Информации о чате» может выбрать Все / Только упоминания и ответы / Выкл.
- Режим личный: у других участников свой; чужой режим не влияет.
- При Все — toast и push (при подписке) на новое сообщение, как по смыслу сейчас.
- При Только упоминания и ответы — toast/push только при
@на этого сотрудника или ответе на его сообщение; иначе нет. - При Выкл — toast/push по сообщениям этого чата нет.
- Во всех режимах список чатов, непрочитанные и открытое окно обновляются при новом сообщении.
- При
shouldAlert = falseна фронте toast не показывается; приtrue— показывается. - Web Push при
shouldAlert = falseне уходит. - В настройках панели чатов есть пункт, открывающий модалку дефолтов по типам чатов; новый чат / вступление подставляют дефолт сотрудника (или Все, если не задан).
- Нет мастера/автопресета при первом заходе.
- Смена дефолтов не меняет режимы уже существующих участий задним числом.
- Колокольчик по поведению не меняется относительно текущего (в рамках этого эпика).
- User-guide описывает режимы, дефолты и отличие от колокольчика / непрочитанных в списке чатов.
Вне scope
- Фильтрация или скрытие записей «По чату» в колокольчике по режиму чата.
- Отдельный тип/текст уведомления «вас упомянули».
- Mute на время (например «на 2 часа»).
- Алерты на ответы в ветке без явного reply / без
@. - Массовая смена режима по всем чатам одним кликом (кроме дефолтов на будущее).
- Отдельный realtime-канал чатов вместо текущего события уведомлений (достаточно флага в текущем пейлоаде).
- Настройки оповещений по задачам / процессам / напоминаниям о дедлайнах (не чаты).
Открытые вопросы
Нет — по UI дефолтов и мастеру первого захода решения зафиксированы выше. Правило алерта: @ или ответ на ваше сообщение.
Задачи эпика
| # | Задача | Смысл |
|---|---|---|
| 1 | Задача 1. Бек. Режим на участнике и дефолты по типу | Хранение режима у участника чата; дефолты сотрудника по типам; API чтения/смены; подстановка дефолта при создании чата / вступлении |
| 2 | Задача 2. Бек. shouldAlert, push и флаг в SignalR | При новом сообщении: расчёт shouldAlert (режим + упоминание + ответ на моё); push только при true; в realtime-пейлоаде всегда флаг shouldAlert |
| 3 | Задача 3. Фронт. UI режима чата и дефолтов | Блок оповещений в «Информации о чате»; пункт в настройках панели чатов → модалка дефолтов по типам |
| 4 | Задача 4. Фронт. Toast по shouldAlert | Одна развилка: при shouldAlert = false не показывать toast; обновление списка/ленты/unread без изменений |
| 5 | Задача 5. Документация. User docs по оповещениям чатов | Режимы, дефолты (модалка из настроек панели), отличие от колокольчика и непрочитанных в списке |