Модуль «Обработчики событий»

Назначение

На крупном портале десятки обработчиков событий разбросаны по файлам, их сложно найти, сопровождать и безопасно менять. Ошибки в обработчиках задач и CRM часто обнаруживаются только постфактум.

Модуль решает задачи:

• регистрация и снятие обработчиков событий Bitrix24 без правки файлов на сервере;
• автогенерация шаблонов обработчиков с try/catch и логированием;
• справочник 300+ событий по 15+ модулям (main, crm, tasks, iblock, im и др.) с описаниями;
• просмотр всех зарегистрированных обработчиков на портале (в т.ч. сторонних);
• логирование ошибок и уведомления администратора через мессенджер;
• бизнес-логика задач: CRM-привязки, диск, ФОТ, нумерация, аудиторы;
• синхронизация карточек CRM «наша организация» ↔ дубликат-партнёр.

Возможности модуля

Административный интерфейс

Модуль открывается в Настройки → Настройки модулей → Обработчики событий.

Вкладка «События»

• выбор модуля-источника (main, crm, tasks, iblock, im, bizproc, sale и др.);
• добавление обработчика: событие, класс, метод, сортировка;
• редактирование и удаление зарегистрированных обработчиков модуля;
• при добавлении автоматически создаётся PHP-файл-шаблон для собственной логики.

Вкладка «Справочник»

• полный список всех обработчиков выбранного модуля на портале (включая сторонние);
• отображение модуля-получателя, класса, метода, callback, сортировки.

Вкладка «Настройки»

Вкладка «Лог ошибок»

• просмотр содержимого логов модуля;
• очистка лога одной кнопкой.

Обработчики задач

Класс объединяет логику, ранее разнесённую по 15 блокам бизнес-процессов. Использует traits для IM и работы с папками на диске.

При создании задачи:

• наследование CRM-привязки от родительской задачи;
• нормализация привязки до одного элемента CRM;
• запрет создания без привязки к CRM;
• запрет привязки к закрытой сделке (WON/LOSE);
• автоматическая нумерация и формирование заголовка;
• назначение наблюдателей из сделки + заместитель при отсутствии постановщика;
• автоматическое включение учёта времени для задач определённых групп;
• назначение рабочей группы по отделу ответственного.

При обновлении задачи:

• пересчёт уровня вложенности;
• синхронизация CRM-привязки и переименование по сделке/лиду;
• создание и синхронизация папки задачи на Bitrix Disk;
• пересчёт ФОТ по подзадачам и соисполнителям;
• синхронизация папки с групповым диском;
• восстановление папки при восстановлении задачи;
• синхронизация названия чата задачи;
• откат статуса «Завершена», если есть незакрытые подзадачи;
• переименование папок дочерних задач при смене префикса.

Задачи по шаблону

Срабатывает после создания задачи по заданному шаблону:

1. Обновляет заголовок: «Задача {месяц} {год}».
2. Создаёт подзадачи для каждого подчинённого отдела.
3. Публикует в чат подзадачи список завершённых за месяц задач и обращений (смарт-процессы).
4. Переносит родительскую задачу в заданную иерархию.

Синхронизация компаний CRM

Концепция

Для каждой нашей организации автоматически создаётся дубликат-партнёр. Пользователи редактируют дубликат; изменения синхронизируются в оригинал.

Направления синхронизации

Защита от гонок: блокировки по ID компании, cooldown между прогонами, синхронизация реквизитов только в том же HTTP-запросе, парные удаления через UF-связи.

Удобство для пользователей

• Администратор без SSH — новый обработчик регистрируется в UI, файл-шаблон создаётся сам.
• Справочник под рукой — не нужно искать название события в документации Bitrix.
• Видимость всего портала — на вкладке «Справочник» видны и чужие обработчики, не только модульные.
• Ошибки не теряются — лог и уведомление в чат при сбое обработчика.
• Сотрудники не замечают модуль — но получают корректные задачи: папки на диске, CRM-привязки, ФОТ и названия создаются автоматически.
• Безопасное редактирование компаний — пользователи работают с дубликатом, оригинал «нашей организации» остаётся консистентным.

Результат для бизнеса

• быстрое внедрение изменений — новая логика на событие без деплоя всего портала;
• единые правила для задач — CRM-привязка, диск и ФОТ работают одинаково для всех отделов;
• меньше «битых» задач — нельзя создать задачу без CRM или с закрытой сделкой;
• автоматические отчёты — шаблонные задачи с подзадачами и публикацией в чат экономят время руководителей;
• целостность CRM — синхронизация компаний и реквизитов без ручного копирования;
• сопровождаемость — централизованный лог и каталог обработчиков снижают риск «забытых» скриптов на сервере.

Связь с другими приложениями