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

Чаты

Продуктовая и доменная карта чатов. Для пользователей: Уведомления и чаты. Живая выжимка по коду — в 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