Чаты
Продуктовая и доменная карта чатов. Для пользователей: Уведомления и чаты. Живая выжимка по коду — в cursor-architecture.md (§ «Чат»). Уведомления о сообщениях и Web Push — в notifications.md. Исторический UX-прототип: notification.md.
Эпики по кускам функционала: обращения (ITR-2912), вложения (ITR-2993; политика типов — ITR-3111), thumbs (ITR-2999), теги списка (ITR-2741), кликабельные https (ITR-3116), производительность (ITR-3197, основная часть реализована), рефакторинг фронта / правила для следующих фич (ITR-3439, реализовано), отметить непрочитанным (ITR-3170, реализовано), чат поручения, описание (ITR-2935), чат заказа на производство (ITR-3378). Участники: ITR-3034 (ITR-3105 / ITR-3106); смена владельца группового — ITR-3377 — см. § «Участники и права».
Что видит пользователь
- Иконка сообщений в шапке → панель: список чатов, вкладки по типу (Все / Заказы / Поручения / Личные / Групповые), фильтр по личным тегам, поиск по названию, непрочитанные; меню карточки — «Отметить непрочитанным» (личный пустой кружок + счётчик шапки; см. chat-mark-unread.md).
- Вкладка «Заказы»: группировка по заказу покупателя (
groupByBuyerOrder) — в группе чат заказа покупателя и чаты заказов на производство (только доступные участнику). - На карточке в списке — краткий ряд своих тегов (внизу на всю ширину); клик по тегу ничего не делает.
- Карточка чата → лента сообщений в той же панели; можно открыть из заказа покупателя, с заказа на производство и с пользовательской задачи / контроля.
- Шапка окна чата: клик по названию → «Информация о чате»; копирование ссылки; переход к связанному заказу или задаче.
- Настройки панели (localStorage, только десктоп): полный экран, сторона панели, сторона окна сообщений относительно списка, выравнивание своих сообщений; ширина панели и списка — перетаскиванием.
Типы чатов
| Тип | Назначение | Создание / закрытие |
|---|---|---|
| По заказу покупателя | Переписка по конкретному заказу | Создаётся вместе с заказом (и при split — новый чат у нового заказа). Закрывается автоматически при завершении / отмене заказа. Ручные close/reopen запрещены. |
По заказу на производство (EnChatType.Order, в UI тип «По ЗНП») | Переписка по заказу на производство | Создаётся при создании заказа на производство (OrderService.SetOrderChat); связь с заказом на производство и с заказом покупателя. Название короткое (ЗНП \{номер\}-\{номенклатура\}). Закрывается при завершении / отмене заказа покупателя. Ручные close/reopen запрещены. |
| Групповой | Несколько участников, не привязан к заказу | Создание из UI; состав меняют участники (см. права ниже); закрыть / возобновить — владелец; владение можно передать (ITR-3377). |
| Личный (приватный) | Диалог двух сотрудников | Состав фиксирован: участников нельзя менять, покинуть нельзя. |
| По пользовательской задаче (в UI — «Поручение») | Обсуждение пользовательской задачи | Создаётся кнопкой «Создать чат» на пользовательской задаче или контроле (автор, исполнитель, соисполнители). Владелец — автор; исполнитель и соисполнители — RequiredByProcess; наблюдатели — обычные участники. Новые роли задачи добавляются в чат, снятые не удаляются. Добавление в чат вручную → наблюдатель задачи (ITR-3422). Автозакрытия нет; close/reopen — владелец. |
Название типа с бека для поручения — «По пользовательской задаче»; фронт подменяет его на «Поручение» в карточке списка и во вкладке фильтра. Для заказа на производство бек отдаёт «По ЗНП».
Не путать тип чата «Групповой» с личными тегами списка и с удалённой заготовкой «групп списка» (папок).
Участники и права
Участник: роль (владелец / админ / участник), дата входа / выхода, последнее прочитанное; флаг RequiredByProcess (в UI — «Системный»: нельзя покинуть и нельзя удалить вручную).
Права на состав разделены (ITR-3034 / ITR-3105 / ITR-3106): вместо одного «управлять участниками» — CanAddParticipants и CanDeleteParticipants в permissions ответа чата. UI опирается на флаги с бека.
| Действие | Кто / условие |
|---|---|
| Писать | Активный участник, чат не закрыт |
| Править название и т.п. | Только групповой (и чат по пользовательской задаче), только владелец |
| Добавить участника | Не личный; чат не закрыт; любой активный участник |
| Удалить участника | Не личный; чат не закрыт; владелец или участник с RequiredByProcess. Нельзя удалить себя, владельца и «системных» |
| Сменить владельца | Только групповой; текущий владелец → другой активный участник (CanChangeOwner / ITR-3377). Чаты заказа и поручения — нет |
| Закрыть / возобновить | Не чат заказа покупателя / заказа на производство; только владелец |
| Покинуть | Не личный; не владелец; не RequiredByProcess |
| Править описание | Бек (CanEditDescription): не личный; владелец или RequiredByProcess. Фронт показывает добавление/правку описания по canEditChat — т.е. только владельцу группового чата или чата поручения. Флаг canEditDescription в ответе есть, но фронт его не использует (системные участники и владелец чата заказа описание из UI не правят) |
Смена ответственного или сопровождающего заказа покупателя обновляет состав чата заказа покупателя и чатов связанных заказов на производство (добавление новых по ролям).
Выбор сотрудников (создание чата, добавление участника) — только с учётной записью (onlyWithUser).
Сообщения
- Текст (в т.ч. с обращениями), отправка / правка / мягкое удаление, отметка прочтения.
- Кто прочитал (ITR-3223):
GET …/Message/{id}/read-by→ список сотрудников (GetReadByUsers); UI в ленте по действию на сообщении. - Ответ на сообщение:
replyToMessageIdпри отправке; в ленте — цитата (replyToMessage: автор, текст, признак удаления / вложений), клик прокручивает к исходному через модуль ленты, если оно уже подгружено; полной догонялки истории пока нет (ITR-3441). - Черновик недописанного текста — localStorage на фронте, ключ по email и chatId.
- История: участник видит все сообщения чата, включая отправленные до его входа (фильтра по дате входа нет).
- Вложения можно добавить кнопкой, вставкой из буфера и drag-and-drop на окно чата.
- Выделение текста в ленте → кнопка «Создать тег: …» (создать или взять существующий личный тег и назначить на чат).
- В ленте на фронте отображаются системные события входа/выхода участников; разделитель «Непрочитанные сообщения».
- В закрытый чат писать нельзя.
Ссылки в тексте
Реализовано (ITR-3116). ТЗ: clickable-https-links.md.
При просмотре голый https://… становится ссылкой (без смены хранения текста). Same origin приложения — текущая вкладка; иначе — новая. http:// и markdown-ссылки не поддерживаются. В превью списка и уведомлениях — plain text.
Тот же приём на фронте для описания пользовательской задачи и комментария к заказу (в режиме просмотра). У комментария заказа правка «по карандашу» (ITR-3471) — без автоссылок в режиме редактирования.
Обращения (mentions)
Отдельной таблицы нет: typed-токены в тексте сообщения вида @{e:guid:Display}; в UI — @Имя. Упомянутый должен быть участником чата. Тип r (роль) зарезервирован, в MVP не используется.
Отдельного уведомления «вас упомянули» нет — то же «По чату»; в превью токены превращаются в читаемый @Имя.
ТЗ: chat-mentions.md.
Вложения и превью
Реализовано: вложения ITR-2993, thumbs ITR-2999.
| Что | Как работает |
|---|---|
| Хранение | S3 (не Drive); метаданные MessageAttachment; скачивание через бек участникам чата |
| Отправка | Multipart …/Message/with-attachments: текст (опционален при файлах) + файлы; до 10 шт. на сообщение (ITR-3111: лимиты типа и размера сняты) |
| Типы / размер | Ограничений по расширению, MIME и размеру основного файла нет (старые проверки помечены obsolete). Пустой файл не принимается |
| Лента | Вложения под текстом; документы — имя, размер, скачать; картинки — thumb (если есть), иначе оригинал (legacy); по клику — оригинал в модалке |
| Thumbs | Для растровых jpeg/png/webp/gif/bmp — генерация на фронте (≤ 800 px, JPEG 0.8), на беке обязательны; бэкфилла нет; при удалении — оригинал + thumb из S3 |
| Список / push | Краткая подпись («Фото», имя файла, «N файлов»), не URL хранилища |
Код: бек — MessageService / вложения + S3; фронт — message-input, create-chat-image-thumb, with-attachments.
Организация списка (личные теги)
Реализовано (ITR-2741). ТЗ: chat-tags.md.
| Тема | Как работает |
|---|---|
| Модель | ChatTag (личный справочник сотрудника) + связь M:N ChatTagChat (чат — много тегов). Заготовка ChatGroup / ChatParticipant.ChatGroupId удалена. |
| Владение | Только свои теги; чужим не видны |
| Справочник | Страница /chat-tags (как отрасли /sector): create / rename / delete |
| Назначение на чат | Блок «Мои теги» в «Информация о чате» (с 1.14.3 — можно ввести новое имя → «Создать» и назначить); меню «⋯ → Теги» (только существующие); выделение текста в ленте → «Создать тег» |
| Список | В выдаче — теги текущего пользователя; фильтр tagIds / noTags на беке; на карточке — 1–2 + «+N», без клика по чипу |
| Выход / закрытый чат | Теги сохраняются; править можно (разметка списка, не членство) |
Не путать с типом чата «Групповой».
Уведомления и realtime
При новом сообщении всем активным участникам кроме автора создаётся запись типа «По чату» → колокольчик, SignalR NotificationsUpdated и Web Push (подписка «из чатов»), если включено. См. notifications.md. Известный хвост UI: иногда in-app toast у автора / зависший toast (ITR-3466; бек автора не уведомляет) — см. chat-refactoring.md.
Производительность (ITR-3197): реализовано — ответ отправителю не ждёт рассылку уведомлений участникам; дата активности чата хранится отдельно, без обхода истории; фронт реже перезагружает ленту и список целиком; вложения при отправке грузятся быстрее; индикатор загрузки чата. Отложено — облегчение запроса списка (last message / unread) и ленивая подгрузка превью. ТЗ: chat-performance.md.
Отдельного ChatHub нет: список и открытый чат обновляются по тому же событию NotificationsUpdated. Событие InvalidateCache к доставке сообщений не относится — см. notifications.md и signalr-cache-invalidation.md.
Ограничение Web Push «один браузер / профиль — один владелец подписки» действует и для чатов — см. notifications.md (§ Web Push).
Связь с заказом покупателя
- Создание заказа → чат типа «по заказу», участники (ответственный — владелец).
- Split заказа → у нового заказа свой чат.
- Смена ответственного / сопровождающего → обновление участников чата заказа покупателя и чатов связанных заказов на производство.
- Завершение / отмена заказа → автозакрытие чата заказа покупателя и чатов связанных заказов на производство.
- Из карточки заказа можно открыть связанный чат.
- Deep-link: query
openChat=\{chatId\}открывает панель с этим чатом через единую навигацию шторки (после авторизации); копирование ссылки — меню карточки / шапка окна чата.
Подробнее по split: buyer-order-split.md. Чат заказа на производство: manufacture-order-chat.md.
Связь с заказом на производство
- При резерве номера / создании заказа на производство — чат типа
Order(SetOrderChat): владелец и участники по ролям/должностям + ответственный/сопровождающий заказа покупателя. - Открытие с карточки / таблицы заказов на производство (
chat.idв ответе заказа). - Ручное создание чата этого типа и ручные close/reopen запрещены.
Связь с пользовательской задачей
- Чат не создаётся вместе с задачей; на форме пользовательской задачи и контроля — кнопка «Создать чат» / «Открыть чат». Для контроля чат привязан к исходной пользовательской задаче.
- Создать могут автор, исполнитель, соисполнители; если среди участников задачи есть сотрудник без учётной записи — отказ.
- Изменение задачи автором →
UpdateCustomTaskChatParticipants: новых добавить, снятых не удалять. - Ручное
AddParticipantв чат поручения → сотрудник становится наблюдателем задачи (ITR-3422). - Завершение процесса чат не закрывает.
ТЗ: bitrix24-migration.md, custom-task-change-executor.md.
Где смотреть в коде
| Слой | Ориентир |
|---|---|
| Бек | ChatService, MessageService, ChatTagService, MessageMentionHelper, NotificationHub |
| Фронт | widgets/chat/*, entities/chat/* (slice навигации/фильтров/оверлеев, секции деталей, composer/hooks ввода, token-parser, вложения/thumbs, теги списка, realtime-hooks). Правила размещения нового кода — chat-refactoring.md |
| Создание с заказом покупателя | BuyerOrderService; автозакрытие — TaskService / BuyerOrderService → ChatService.Close |
| Создание с заказом на производство | OrderService.SetOrderChat / ReserveOrderNumber |