2026-11-18 — Переработать панель фильтрации в чатах
Статус: Согласование
Источник: Олег Сосунов; Игорь Мягков; Олег Дубко
Эпик: ITR-3341
Связанные материалы:
- chats.md;
- user guide: notifications-and-chats.md;
- теги чатов: chat-tags.md;
- отметить непрочитанным: chat-mark-unread.md.
Цель
- Собрать управление списком чатов в одну панель: поиск с выбором, где искать; фильтр непрочитанных; фильтр по тегам. Сделать разбор входящих и поиск по нужным полям быстрее, не раздувая шапку списка отдельными контролами.
- Улучшить отображение даты/времени последнего сообщения на карточке списка: компактный формат, дата не исчезает при наведении, полная дата и время — в подсказке.
Контекст
Как сейчас
- В шапке списка — отдельные контролы: поле поиска, вкладки типа (Все / Заказы / Поручения / Личные / Групповые), ниже — выбор тегов.
- Поиск единый: одновременно по названию чата, тексту сообщений и ФИО отправителя в сообщениях. Выбрать «только заголовки» или «только участники» нельзя.
- Фильтра «только непрочитанные» нет (есть бейджи и ручная отметка «непрочитанным», но не отбор списка).
- Сортировки списка по непрочитанным нет — и в этом эпике не делаем.
- На карточке дата последнего сообщения — календарная (
дд.мм.ггггбез времени). На широком экране при наведении на карточку дата скрывается, появляется меню «⋯».
Как должно быть
- Единая панель управления:
- строка поиска + тоггл-иконки областей поиска (заголовки / участники / сообщения);
- ряд фильтров: чип «Непрочитанные», чип «Теги», при активных фильтрах — «Сбросить»;
- при открытии «Теги» — выбор меток внутри той же панели (в т.ч. «Без тегов»), без отдельного поля выбора тегов под панелью.
- Вкладки типа чата остаются под панелью — это навигация по типу списка, не часть пульта фильтров.
- Сортировку «сначала непрочитанные» не вводим (при необходимости — отдельный эпик).
- На карточке — компактная дата/время последнего сообщения; при наведении на карточку дата не прячется; меню «⋯» показывается рядом с датой. При наведении на дату — подсказка с полной датой и временем.
Пользовательские сценарии
- Быстрый разбор входящих. Сотрудник включает «Непрочитанные» — в списке только чаты с непрочитанными сообщениями и/или с личной отметкой «непрочитанным». Прочитал чат — он исчезает из этого отбора. Пришло новое сообщение в прочитанный чат — чат снова появляется в списке (если проходит остальные фильтры), обычно ближе к верху по свежести.
- Поиск по названию. Нужен заказ / поручение по заголовку: оставляет включённым только «заголовки», вводит номер или фрагмент имени — не засоряет выдачу совпадениями из длинных переписок.
- Поиск по участнику. Включает «участники», ищет по ФИО — находит чаты, где человек в составе, без обязательного совпадения в тексте сообщений.
- Поиск по тексту переписки. Включает «сообщения» (или все области), ищет фразу из переписки.
- Смешанный поиск. Включены две или три области сразу — совпадение в любой из выбранных достаточно.
- Теги в той же панели. Открывает «Теги», выбирает метки / «Без тегов» — список сужается; отдельные контролы тегов вне панели не использует.
- Сброс. Нажимает «Сбросить» — снимаются непрочитанные и выбранные теги; текст поиска и области поиска / вкладка типа не обязаны сбрасываться вместе с этим (см. решения).
- Вкладки типа. Как сейчас переключает Все / Заказы / … — фильтры панели применяются поверх выбранного типа.
- Дата на карточке. В списке видит компактную подпись (сегодня — время, вчера — «вчера», до недели — день недели, дальше — дата). Наводит на дату — видит полные дату и время. Наводит на карточку — дата остаётся, появляется «⋯».
Принятые решения
| Тема | Решение |
|---|---|
| Каркас 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 дн.