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

2026-11-03 — Рефакторинг фронта чатов (наведение порядка)

Статус: Реализовано (фазы 1–5; хвост по toast/push уведомлений — отдельная задача)

Источник: разбор текущего UI чатов (Георгий); согласование приоритетов с Олегом

Эпик: ITR-3439

Связанные материалы:

Итог реализации​

Сделано:

  • единая навигация активного чата и шторки (ITR-3445);
  • общие модалки/меню списка и состояние фильтров в Redux (ITR-3446);
  • модуль скролла/подгрузки ленты и перехода к сообщению (ITR-3447);
  • секции деталей чата и разбор поля ввода (отправка / упоминания / черновики / вложения) (ITR-3448);
  • карта и правила «куда класть новое» для следующих фич (ITR-3449, этот документ + chats.md / cursor-architecture.md).

Вне скоупа рефакторинга (отложено):

  • уведомление самому себе в групповом чате (in-app toast) и зависшее уведомление — ITR-3466. Бек автора уже исключает; на фронте toast по NotificationsUpdated без фильтра по отправителю; зависание — вероятный дубль SignalR + APP_FOCUSED_NOTIFICATION / отсутствие key у snackbar. См. также отложенный ITR-3277 в chat-performance.md.
  • неверный toast при переходе к удалённому сообщению — как на проде до рефакторинга; отдельный фикс (кэш replyToMessage.isArchived + классификация «удалено» vs «далеко»).
  • полная догонялка истории до сообщения — по-прежнему ITR-3441.

Цель​

Привести фронт чатов в предсказуемое состояние после быстрой серии доработок: убрать накопленные обходные решения, развести ответственность экранов и сценариев, зафиксировать правила «куда класть новое».

Эпик не про новые пользовательские возможности и не про ускорение бека (это уже chat-performance). Цель — чтобы следующая волна фич чатов встраивалась в одно место, а не через новые временные мосты.

Приоритет команды сейчас на других работах; этот эпик — подготовка, к которой вернёмся перед/вместе с хвостом доработок чатов.

Зачем сейчас (связь с будущим бэклогом)​

В планах (после других приоритетов), среди прочего:

НаправлениеТрекерПочему упирается в текущий фронт
Поиск по заголовкам и по истории внутри чатаITR-3341, ITR-3359Фильтры списка и пагинация/скролл ленты размазаны; поиск по истории ляжет на ту же «догонялку» сообщений
Закрепить / избранноеITR-3143Действия и меню списка, вкладки/сортировка, обновление списка после действия
Отметить чат непрочитаннымITR-3170Меню карточки и обновление списка
Доскролл до сообщения в историиITR-3441Сейчас при «далеком» ответе — ошибка; нужна устойчивая подгрузка и переход к сообщению без хрупкой работы с DOM
В пуше — куда пришло (личный / название чата)ITR-3348Несколько каналов «открыть этот чат» из уведомлений
Материалы чатаITR-3345Карточка деталей чата уже перегружена сценариями

Пока порядок не наведён, каждая из этих задач рискует добавить ещё один обходной путь.

Контекст​

Как сейчас​

Чаты на фронте выросли вокруг шторки: список, окно переписки, детали, теги, создание, настройки отображения. По пути появились типичные долги быстрого роста:

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

Для пользователя продукт в целом работает; боль — у разработки и у скорости/надёжности следующих фич.

Как должно быть​

  • Один источник истины для «какой чат открыт» и «открыта ли шторка»; открытие из уведомления и выход из чата идут тем же путём, без служебных DOM-событий и отложенных «ожидающих» id.
  • Список чатов: одна общая модалка деталей / одно меню действий / одна модалка тегов на панель — карточка только сообщает «открыть для этого чата».
  • Фильтры списка (вкладка, поиск, теги) переживают закрытие шторки в рамках сессии так, как ожидает пользователь; обновление списка — штатными средствами кэша запросов, без счётчиков-«тиков».
  • Окно переписки: скролл, подгрузка истории и переход к сообщению — через понятный модуль списка; без прямой покраски DOM из обработчиков клика.
  • Детали и сценарии разнесены: базовое отображение чата отдельно от сценариев (теги, выход/закрытие, создание, позже — материалы).
  • Зафиксированы правила размещения нового кода (см. ниже), чтобы долг не нарастал сразу после эпика.

Поведение для пользователя после эпика в целом то же (те же экраны и сценарии), плюс ощутимо легче длинный список чатов за счёт одной модалки/меню вместо сотен скрытых.

Не цели этого эпика​

  • Реализация поиска, избранного, «непрочитанного», материалов, доработки пушей — это отдельные задачи (см. таблицу выше).
  • Переписывание бекенда чатов и прав доступа.
  • Смена визуального дизайна чатов «с нуля».
  • Обязательный перенос всего дерева файлов в новые папки ради структуры; структура подчиняется ясности границ, а не наоборот.
  • Вынос в глобальное состояние приложения любого мимолётного UI (якорь меню, фокус поля) — это ухудшит сопровождение.

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

ТемаРешение
Тип эпикаТехнический рефакторинг фронта с сохранением UX; пользовательский changelog — только если эффект заметен (например, список перестал «тяжелеть»)
Глобальное состояниеТуда — то, что общее для шторки и внешних входов: открытость панели, активный чат, при необходимости устойчивые настройки отображения панели. Не складывать туда якоря меню и каждый локальный флаг контрола
Фильтры спискаУстойчивое состояние фичи списка (общий стор или контекст уровня шторки) — чтобы пережить закрытие панели; не прокидывать пять пропсов ради прокидывания
Reply / edit / пины кнопок вводаНе обязательный перенос в глобальный стор в первой очереди; достаточно убрать проксирование через лишние уровни (контекст окна чата или локальный модуль)
Модалки и меню спискаОдин экземпляр на панель чатов; карточка только инициирует открытие
Переход к сообщениюКоманда списку (подгрузить → прокрутить → подсветить через состояние/CSS), без ручного поиска узла и записи в style
СлоиСценарии (создание, теги, шаринг ссылки, lifecycle) отделять от отображения сущности; если удобнее начать с модулей внутри текущих зон чата — допустимо, без большого «переезда ради переезда»
Порядок работФазы с вертикальной готовностью: после фазы можно вести другие приоритеты и позже вернуться
Параллельные костылиНа время эпика не добавлять новые служебные window-события, счётчики-тики обновления и модалки внутрь элемента списка
ПраваБез новых ролей; доступ как сейчас

Фазы​

Фаза 1. Навигация активного чата​

Единый активный чат и открытие шторки; убрать связку «ожидающий id» / служебное событие при выходе; настройки положения/полноэкрана не живут только как разрозненный локальный стейт без ясного владельца.

Зачем для бэклога: пуш → конкретный чат (ITR-3348), любые deep-link «открыть чат».

Фаза 2. Список чатов​

Одна модалка деталей, одно меню, одна модалка тегов; фильтры как состояние фичи; обновление списка без ручного «тика»; карточка списка лёгкая (без тяжёлых детей в каждой строке).

Зачем для бэклога: избранное, «непрочитанный», поиск по списку, действия из меню.

Фаза 3. Окно переписки и история​

Модуль скролла/подгрузки; переход к сообщению без DOM-хаков; разрезать перегруженный хук данных окна; по возможности упростить прокси reply/edit.

Зачем для бэклога: доскролл до сообщения (ITR-3441), поиск по истории (ITR-3341).

Фаза 4. Детали, ввод, сопутствующие сценарии​

Секции деталей чата; вынос оркестрации отправки/упоминаний/черновиков из монолита ввода; сценарии тегов/lifecycle не размножают окна в списке. Подготовка места под материалы (ITR-3345).

Фаза 5. Документация и правила​

Обновить карту чатов / user-facing описание только там, где поведение или устройство панели реально изменились для поддержки; зафиксировать в рабочей карте «куда класть новое» для следующих задач.

Правила «куда класть новое» (после эпика)​

Краткий контракт для следующих задач по чатам:

  1. Навигация панели (открыт ли чат, какой активен, открытие из уведомления) — только через согласованное состояние панели, не через новые события окна браузера.
  2. Действия над чатом из списка (закрыть, выйти, теги, позже — закрепить / непрочитанный) — через общие окна/меню панели, не через экземпляр на каждую карточку.
  3. Фильтры и поиск списка — в состоянии фичи списка; параметры поиска (заголовки / участники / …) — рядом с этим состоянием, а не размазанные по виджету.
  4. История и прыжки по сообщениям — через модуль ленты (подгрузка + переход), не через прямые манипуляции DOM из карточки сообщения.
  5. Новые блоки в деталях (материалы и т.п.) — отдельная секция/сценарий, не раздувание одного экрана «обо всём».

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

Поведение не должно ухудшиться:

  1. Открыть шторку → выбрать чат → писать / отвечать / редактировать → назад к списку на мобильном.
  2. Открыть чат из уведомления / по сохранённому контексту — открывается нужный чат.
  3. Выйти из чата / закрыть чат — если это был активный, окно переписки закрывается согласованно.
  4. Фильтры и поиск списка, теги, создание чата, детали, копирование ссылки — как до рефакторинга по смыслу.
  5. Вложения, упоминания, превью картинок — без регрессии соседних эпиков.
  6. Длинный список чатов: интерфейс не деградирует из‑за сотен скрытых окон в DOM.

Задачи эпика​

#ЗадачаТрекерСтатус
1Задача 1. Фронт. Единая навигация активного чата и шторкиITR-3445Сделано
2Задача 2. Фронт. Список: общие модалки/меню и состояние фильтровITR-3446Сделано
3Задача 3. Фронт. Лента: скролл, подгрузка, переход к сообщениюITR-3447Сделано
4Задача 4. Фронт. Детали чата и поле вводаITR-3448Сделано
5Задача 5. Документация. Карта чатов и правила для следующих фичITR-3449Сделано

Оценки и детальные карточки YouGile — отдельно по правилу нарезки задач; в этом документе — состав эпика.

Критерии приёмки​

  1. Есть один согласованный способ задать/сбросить активный чат и открыть шторку; открытие из уведомления и выход из чата не требуют отдельных служебных событий окна.
  2. В открытой панели со списком в DOM не монтируется отдельная модалка деталей/тегов на каждую карточку — общие окна на панель.
  3. Фильтры списка (вкладка / поиск / теги) после закрытия и повторного открытия шторки в той же сессии ведут себя предсказуемо (не «сбрасываются в ноль» только из‑за размонтирования, если продукт ожидает сохранение).
  4. Переход к сообщению-ответу не опирается на ручной поиск узла и запись цвета в inline-style; сценарий готов к наращиванию «подгружать историю, пока не найдём» (ITR-3441) без новой ломки.
  5. Ключевые пользовательские сценарии из раздела регрессии проходят; права и состав ролей не изменены.
  6. В рабочей документации (карта чатов) отражены новые границы и правила для следующих задач; устаревшие описания обходных мостов убраны или помечены.

Вне scope (явно)​

  • ITR-3341 / 3359 (поиск), 3143 (избранное), 3170 (непрочитанный), 3441 (полная догонялка истории), 3348 (текст пуша), 3345 (материалы) — отдельные задачи после/рядом, этот эпик только готовит почву.
  • Косметика (иконки типов файлов в превью вложений, перенос всех стилей в отдельные файлы) — не блокер фаз 1–3.
  • Бекенд-контракты поиска/избранного — вне этого эпика.

Открытые вопросы​

  • Нужен ли пользовательский пункт в истории версий — нет (технический рефакторинг без заметного пользовательского эффекта для changelog).
  • Фильтры: сессия vs local persistence — принято состояние сессии вкладки в Redux (listActiveTab / listSearch / listSelectedTagIds); между перезагрузками страницы не помним.
  • Насколько дробить поле ввода — сделаны границы модулей (hooks + composer context) без большого переезда слоёв FSD.