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

2026-11-18 — Переработать панель фильтрации в чатах

Статус: Согласование

Источник: Олег Сосунов; Игорь Мягков; Олег Дубко

Эпик: ITR-3341

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

Цель​

  1. Собрать управление списком чатов в одну панель: поиск с выбором, где искать; фильтр непрочитанных; фильтр по тегам. Сделать разбор входящих и поиск по нужным полям быстрее, не раздувая шапку списка отдельными контролами.
  2. Улучшить отображение даты/времени последнего сообщения на карточке списка: компактный формат, дата не исчезает при наведении, полная дата и время — в подсказке.

Контекст​

Как сейчас​

  • В шапке списка — отдельные контролы: поле поиска, вкладки типа (Все / Заказы / Поручения / Личные / Групповые), ниже — выбор тегов.
  • Поиск единый: одновременно по названию чата, тексту сообщений и ФИО отправителя в сообщениях. Выбрать «только заголовки» или «только участники» нельзя.
  • Фильтра «только непрочитанные» нет (есть бейджи и ручная отметка «непрочитанным», но не отбор списка).
  • Сортировки списка по непрочитанным нет — и в этом эпике не делаем.
  • На карточке дата последнего сообщения — календарная (дд.мм.гггг без времени). На широком экране при наведении на карточку дата скрывается, появляется меню «⋯».

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

  • Единая панель управления:
    1. строка поиска + тоггл-иконки областей поиска (заголовки / участники / сообщения);
    2. ряд фильтров: чип «Непрочитанные», чип «Теги», при активных фильтрах — «Сбросить»;
    3. при открытии «Теги» — выбор меток внутри той же панели (в т.ч. «Без тегов»), без отдельного поля выбора тегов под панелью.
  • Вкладки типа чата остаются под панелью — это навигация по типу списка, не часть пульта фильтров.
  • Сортировку «сначала непрочитанные» не вводим (при необходимости — отдельный эпик).
  • На карточке — компактная дата/время последнего сообщения; при наведении на карточку дата не прячется; меню «⋯» показывается рядом с датой. При наведении на дату — подсказка с полной датой и временем.

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

  1. Быстрый разбор входящих. Сотрудник включает «Непрочитанные» — в списке только чаты с непрочитанными сообщениями и/или с личной отметкой «непрочитанным». Прочитал чат — он исчезает из этого отбора. Пришло новое сообщение в прочитанный чат — чат снова появляется в списке (если проходит остальные фильтры), обычно ближе к верху по свежести.
  2. Поиск по названию. Нужен заказ / поручение по заголовку: оставляет включённым только «заголовки», вводит номер или фрагмент имени — не засоряет выдачу совпадениями из длинных переписок.
  3. Поиск по участнику. Включает «участники», ищет по ФИО — находит чаты, где человек в составе, без обязательного совпадения в тексте сообщений.
  4. Поиск по тексту переписки. Включает «сообщения» (или все области), ищет фразу из переписки.
  5. Смешанный поиск. Включены две или три области сразу — совпадение в любой из выбранных достаточно.
  6. Теги в той же панели. Открывает «Теги», выбирает метки / «Без тегов» — список сужается; отдельные контролы тегов вне панели не использует.
  7. Сброс. Нажимает «Сбросить» — снимаются непрочитанные и выбранные теги; текст поиска и области поиска / вкладка типа не обязаны сбрасываться вместе с этим (см. решения).
  8. Вкладки типа. Как сейчас переключает Все / Заказы / … — фильтры панели применяются поверх выбранного типа.
  9. Дата на карточке. В списке видит компактную подпись (сегодня — время, вчера — «вчера», до недели — день недели, дальше — дата). Наводит на дату — видит полные дату и время. Наводит на карточку — дата остаётся, появляется «⋯».

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

ТемаРешение
Каркас UXОдна панель: поиск+scope / непрочитанные+теги (+ раскрытие тегов)
Вкладки типаВне панели, под ней; поведение вкладок не меняем
Области поискаТри независимых тоггла: заголовки, участники, сообщения
Где тогглыИконки в строке поиска (не плашки под полем); подписи — в подсказках
Дефолт областейВсе три включены (поведение близко к текущему единому поиску)
Минимум областейНельзя выключить последнюю включённую
«Участники»Поиск по составу участников чата (не только по автору последнего сообщения)
«Непрочитанные»Фильтр, не сортировка: в списке только непрочитанные для текущего сотрудника
Что считается непрочитаннымЕсть непрочитанные сообщения или личная отметка «непрочитанным» (как в счётчике / бейджах)
Сочетание фильтровНепрочитанные, теги, вкладка типа и поиск — логическое И
ТегиТот же смысл, что в chat-tags.md; UI выбора — внутри панели
«Сбросить»Сбрасывает фильтры панели: непрочитанные + выбранные теги; строку поиска и области — не сбрасываем вместе с чипом (поиск отдельно очищается крестиком в поле)
Смена вкладки типаНепрочитанные и теги не сбрасываем — фильтры панели остаются и применяются к новой вкладке
Иконки областей поискаTitle (заголовки), Person (участники), Textsms (сообщения) — из @mui/icons-material
Дата на карточке при hoverНе скрываем; меню «⋯» появляется рядом (как сейчас по смыслу hover на десктопе)
Компактный формат датыСегодня → время (ЧЧ:ММ); вчера → «вчера»; старше вчера и младше 7 суток → день недели (пн…вс); иначе → календарная дата; другой год — с годом
Подсказка по датеПри наведении на дату — полные дата + время (дд.мм.гггг ЧЧ:ММ)
СортировкаВне scope этого эпика
ПостраничностьКак сейчас по свежести активности; фильтр непрочитанных — условие отбора, без смены ключа постраничной выдачи
Live-обновленияПри фильтре «Непрочитанные»: прочтение → чат уходит из текущего списка; новое входящее в подходящий чат → чат появляется / обновляется без обязательной полной перезагрузки всего списка
ПраваДоступ к списку чатов как сейчас; фильтры личные (теги уже личные; непрочитанность — своя)

Ориентир раскладки​

┌─────────────────────────────────────────┐
│ ⌕ Поиск чатов… Title Person Msg│
│─────────────────────────────────────────│
│ [Непрочитанные] [Теги · N] Сбросить │
│─────────────────────────────────────────│
│ (при открытых тегах) #… #… Без тегов│
└─────────────────────────────────────────┘
Все | Заказы | Поручения | Личные | Групповые
…карточки чатов…

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

  • Поиск, фильтр непрочитанных и выбор тегов собраны в одной панели; отдельного поля тегов под панелью нет.
  • В строке поиска тогглы областей с иконками Title / Person / Textsms (заголовки / участники / сообщения); по умолчанию все включены; последнее включённое выключить нельзя; у иконок есть понятные подсказки.
  • При выбранных областях поиск идёт только по ним; «участники» — по составу участников чата.
  • Чип «Непрочитанные» оставляет в списке только чаты с непрочитанными сообщениями и/или личной отметкой непрочитанным.
  • Фильтры панели сочетаются с вкладками типа и друг с другом.
  • «Сбросить» снимает непрочитанные и выбранные теги; вкладки типа остаются.
  • Переключение вкладок типа не сбрасывает «Непрочитанные» и выбранные теги.
  • При активном «Непрочитанные» прочтение убирает чат из списка, новое сообщение снова показывает подходящий чат (с учётом остальных фильтров).
  • Постраничная подгрузка списка работает с новыми фильтрами.
  • Сортировки «сначала непрочитанные» в продукте нет.
  • Дата/время на карточке в компактном формате (сегодня / вчера / день недели / дата); при наведении на дату — полные дата и время.
  • При наведении на карточку (десктоп) дата не скрывается; меню «⋯» доступно рядом с датой.
  • Обновлены user docs по поиску, фильтрам списка и отображению даты на карточке.

Вне scope​

  • Сортировка списка (в т.ч. «сначала непрочитанные»).
  • Отдельная вкладка «Непрочитанные» вместо чипа-фильтра.
  • Изменение модели личных тегов и справочника тегов (уже сделано).
  • Изменение правил ручной отметки «непрочитанным» (уже сделано).
  • Поиск по вложениям / файлам.
  • Сохранение пресетов фильтров между сессиями (если не понадобится в реализации «как удобно» — не требование приёмки).

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

#ЗадачаСмысл
1Задача 1. Бек. Области поиска и фильтр непрочитанныхПараметры списка: где искать (заголовки / участники / сообщения) и отбор только непрочитанных; сочетание с типом и тегами; прежняя постраничность по активности
2Задача 2. Фронт. Единая панель фильтровПанель: поиск с тогглами Title / Person / Textsms, «Непрочитанные», теги внутри панели, «Сбросить»; вкладки типа под панелью без сброса фильтров; live-поведение при фильтре непрочитанных
3Задача 3. Фронт. Дата на карточке спискаКомпактный формат даты/времени; tooltip с полной датой и временем; дата не скрывается при hover карточки; «⋯» рядом
4Задача 4. Документация. Поиск, фильтры и дата в списке чатовUser docs: области поиска, непрочитанные, теги в панели; компактная дата и подсказка; без описания сортировки

Порядок: задача 1 → 2; задача 3 — параллельно с 2 или сразу после; задача 4 — к приёмке / после реализации.

Оценка: ориентир 3.5–5.5 чел.-дн. (бек + фронт); документация — 0.5 дн.