Настройки модуля «Чат и коммуникации»

Доступ к настройкам:

1. Включите модуль чата (см. ниже) — иначе пункт настроек чата в меню может быть скрыт.
2. Перейдите в «Настройки» → «Чат» (адрес /settings/chat/).
3. Нужно право system.settings (как у прочих разделов настроек системы).

На странице пять вкладок: Общие параметры, Команды, Каналы, Правила маршрутизации событий, Группы упоминаний. Справа сверху есть кнопка «Открыть коммуникации» для перехода в мессенджер.

Руководство пользователя: 3.12. Чат и коммуникации.

1. Включение модуля

1. Настройки → Основные настройки системы (MainSystemSettings).
2. Включите «Модуль чата включён» (chat_enabled). По умолчанию включён.
3. Сохраните.

Если выключить:

• пункт «Коммуникации» пропадает из меню;
• скрывается иконка чата в шапке;
• кнопки «Открыть обсуждение» на карточках объектов не показываются;
• API и страница /communications/ отвечают как недоступные;
• доставка системных уведомлений в чат не выполняется.

Настройки на /settings/chat/ при выключенном модуле могут быть скрыты из бокового меню настроек — сначала снова включите чат.

Подробнее о блоке MainSystemSettings: Системные настройки.

2. Что должно быть готово для работы

Рекомендуемая первичная заливка демо-иерархии каналов (идемпотентно; при deploy.sh выполняется автоматически после createsuperuser):

python manage.py seed_communication_channels --tenant-id=1

Опционально подписать всех сотрудников:

python manage.py seed_communication_channels --tenant-id=1 --auto-subscribe-all-staff

Команда не запускается сама при миграциях — её нужно выполнить при внедрении или обновлении.

Проверка проекции события (для диагностики):

python manage.py emit_test_domain_event --sync-project

3. Вкладка «Общие параметры»

Параметры хранятся в справочнике настроек модуля и редактируются прямо в таблице (форма открывается без перезагрузки страницы). Значения с единицами измерения показаны в интерфейсе.

3.1. Общие параметры

3.2. Вложения

3.3. Функционал

3.4. Уведомления

3.4.1. Центр событий (рабочие «Входящие» и каналы)

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

Кратко по пунктам (полные пояснения и сценарии внедрения):
Куда приходят уведомления и в каком виде.

Практический совет: на новых стендах сразу выключите Legacy PWA-колокольчик и Notify как сообщения в Разговорах. Режимы «параллельно / дублирование» Inbox оставляйте только на период миграции типов событий.

После migrate: seed часто оставляет Источник Inbox и родственные флаги в режиме legacy / parallel. Целевой режим для пользователей — только Event Center (unified / «только рабочие карточки»), но переключайте его после тестирования сценариев, а не «молча» сразу после обновления схемы.

Также в общих параметрах может быть настройка вкладки по умолчанию при открытии коммуникаций («Входящие» или «Разговоры»).

3.5. Политики сообщений

3.6. Ограничения частоты

3.7. Присутствие

Интервал обновления «пульса» на стороне клиента задаётся конфигурацией сервера (около 25 секунд) и в этой таблице обычно не правится.

3.8. Параметры только в конфигурации сервера

Часть лимитов задаётся в конфигурации приложения (не на вкладке), со значениями по умолчанию:

• порог синхронного экспорта (около 500 сообщений) и срок хранения файла выгрузки (24 часа);
• минимум длины поискового запроса (2 символа);
• максимум участников группы (100) и канала (5000);
• срок хранения записей уведомлений чата (около 180 дней);
• пауза между email по одному диалогу (около 5 минут);
• интервал фоновой проекции событий в каналы (около 15 секунд);
• лимит личных оповещений по ключевым словам (около 50 на пользователя);
• идентификатор системного пользователя для служебных DM (используется только если включён устаревший режим «Notify как сообщения в Разговорах»).

При смене критичных лимитов согласуйте с сопровождением сервера.

4. Вкладка «Команды»

Команда — папка в дереве каналов мессенджера (например, «Заявки», «Согласования»).

Создать / изменить

1. Вкладка «Команды» → «Добавить команду» (или изменить строку).
2. Заполните:
3. Название;
4. Код (slug) — латиницей; если пусто, подставится из названия;
5. Порядок сортировки;
6. Видимость: для всех внутренних или ограниченная правилом;
7. для ограниченной — правило в формате JSON с ключами roles (типы пользователей) и/или users (числовые id), хотя бы один список непустой;
8. В архиве — скрыть из обычного дерева.
9. Сохраните.

Без заполненного уникального slug в пределах организации команду не сохранить. Удаление невозможно, если к команде привязаны каналы — сначала перенесите или удалите каналы.

Seed создаёт команды: заявки, задачи, согласования, проекты, персонал, CRM, база знаний (и др. по версии).

5. Вкладка «Каналы»

Создать / изменить канал

1. «Добавить канал».
2. Поля:
3. Команда (необязательно для канала «без папки»);
4. Название, slug;
5. Тип: ручной / системный / гибридный;
6. Политика публикации:
   • Все;
   • Администраторы (создатель канала);
   • Только система;
   • Выбранные роли — тогда укажите типы учётных записей и/или подразделения (сотрудники выбранного подразделения и дочерних смогут писать);
7. Код модуля — по необходимости;
8. Порядок, В архиве.
9. При создании автоматически заводится корневой разговор канала; название разговора синхронизируется с названием канала.

Для политики «Выбранные роли» нужно указать хотя бы один тип пользователя или подразделение.

Кто видит канал

• Клиенты портала каналы не видят.
• Внутренние — с учётом видимости команды и канала; архивные каналы в обычном дереве скрыты (создатель может видеть при специальных режимах).

6. Вкладка «Правила маршрутизации событий»

Правило Event Center — это конструктор маршрута: куда положить событие, кому (роли аудитории), с каким смыслом (purpose) и какими политиками доставки/отложения. Это не только «тип события → канал».

Основные поля

В таблице правил можно быстро включить/выключить правило и фильтровать по purpose / destination / domain.

Создать / изменить

1. «Добавить правило» (вкладка Правила маршрутизации событий).
2. Укажите тип события (и домен при необходимости).
3. Выберите purpose и destination.
4. Для канала — выберите целевой канал; для Inbox — аудиторию ролей.
5. При необходимости сузьте условия, задайте политику доставки, snooze/dedupe.
6. Включите правило переключателем Активно.

Согласования

Для трансляции согласований:

1. Должны существовать каналы команды «Согласования» (seed создаёт «Ожидают решения», «Новые», «Завершённые») и/или правила с destination = Inbox для согласующих.
2. Seed и матрица покрывают типичные approval.* / *.approval_required; сверяйте purpose/destination с нужным UX (личная карточка vs канал команды).
3. Модули отправляют событие, если включены Event Center и проекция/маршрутизация (см. п. 3.4.1).

Утверждение по-прежнему выполняется в исходном модуле или кнопками на карточке Inbox (если тип события в волне handlers). Канал только уведомляет подписчиков.

Если каналов или правил нет

• Нет правила на канал → событие не появится в ленте канала (личная карточка всё равно может создаться другим правилом / матрицей).
• Нет маршрута в Inbox для роли → у сотрудника может не быть личной карточки, хотя канал заполнен.

«Догоняющая» заливка старых событий штатно не предполагается. Фоновая проекция — порядка раз в 15 секунд.

Текст писем/мессенджеров правится в Настройки → Уведомления; шаблон не задаёт вкладку purpose во «Входящих» — это делает правило маршрутизации / матрица.

7. Вкладка «Группы упоминаний»

Группа позволяет писать в чате @slug и уведомить набор людей.

Создать / изменить

1. «Добавить группу упоминаний».
2. Название и slug (без обязательного @ в начале).
3. Укажите участников и/или подразделения (хотя бы что-то одно).
4. Сотрудники выбранных подразделений и дочерних узлов оргструктуры получают упоминание, если они участники диалога, где группа упомянута.

8. Права администратора vs пользователя

Отдельных групп «Chat-Admin» / «Chat-User» в поставке нет: админские экраны завязаны на system.settings, пользовательские — на членство и тип учётной записи.

9. Уведомления: что настраивает администратор

Кратко:

1. Глобально — включение модуля чата и параметр «Уведомления по email» на вкладке общих параметров.
2. Центр событий — режимы «Входящих», маршрутизация в каналы, флаги Legacy PWA-колокольчик и Notify как сообщения в Разговорах (см. п. 3.4.1 выше).
3. Каналы и правила — куда попадают общие события команды.
4. Текст писем и сообщений — в разделе Настройки → Уведомления.

Подробно и простым языком (куда приходит сообщение, в каком виде, сценарии, чек-лист):
Куда приходят уведомления и в каком виде.

Колокольчик в шапке по умолчанию не ведёт отдельный список system.Notification: он открывает коммуникации; рабочие события — во «Входящих».

10. Импорт и экспорт

Аудит действий экспорта и чувствительных операций пишется во внутренний журнал аудита коммуникаций (для расследований сопровождением).

11. Чек-лист внедрения

1. Включить «Модуль чата включён».
2. Проверить вкладку Общие параметры (лимиты файлов и политик).
3. Настроить блок центра событий: Event Center вкл.; Legacy PWA-колокольчик и Notify как сообщения в Разговорах — выкл. См. куда приходят уведомления.
4. Выполнить первичную заливку команд и каналов при внедрении (см. раздел «Что должно быть готово» выше).
5. Просмотреть команды, каналы и правила; отключить лишние демо-каналы или заменить на реальные.
6. Создать нужные группы упоминаний.
7. Убедиться, что фоновые задачи коммуникаций обрабатываются.
8. Проверить с тестовым сотрудником: меню, три вкладки (Разговоры / Входящие / Каналы), чат заявки (только обсуждение людьми), подписка на канал, карточка «Требуется действие» во «Входящих» (не в чате объекта), упоминание, экспорт, кнопка Скрыть на INFO.
9. Показать сотрудникам Настройки доставки.