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

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 по сообщениям этого чата не показываем.
  • Список чатов, бейджи непрочитанных, превью последнего сообщения и открытая лента обновляются при любом режиме.
  • В настройках панели чатов — пункт, открывающий модалку дефолтов по типу чата для новых чатов / при вступлении; на уже существующих чатах задним числом не перетираем.
  • Колокольчик: записи «По чату» и счётчик колокольчика — как сейчас (эпик их не режет и не перестраивает).

Пользовательские сценарии​

  1. Приглушить групповой чат. В «Информации о чате» выбирает «Только упоминания и ответы». Обычные сообщения коллег: список и непрочитанные обновляются, toast и push нет. Когда кого-то @ упомянули его или ответили на его сообщение — toast (и push при подписке) приходят.
  2. Полностью выключить алерты по чату. Режим «Выкл»: переписка и непрочитанные работают, toast/push по этому чату нет.
  3. Вернуть всё. Режим «Все» — снова toast/push на каждое сообщение.
  4. Дефолт на будущее. В настройках панели чатов открывает пункт про оповещения → модалка: для групповых — «только упоминания и ответы», для личных — «все». Новый групповой чат (или вступление) получает этот режим; уже открытые чаты не меняются сами.
  5. Переопределение. Дефолт «только упоминания», но в одном важном групповом вручную ставит «Все» — действует только этот чат.
  6. Чужой участник. Настройка личная: коллега со своим режимом; чужой выбор не видит и на него не влияет.

Принятые решения​

ТемаРешение
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 по оповещениям чатовРежимы, дефолты (модалка из настроек панели), отличие от колокольчика и непрочитанных в списке