Назначение
На крупном портале десятки обработчиков событий разбросаны по файлам, их сложно найти, сопровождать и безопасно менять. В результате чего, ошибки в обработчиках задач и CRM часто обнаруживаются только постфактум.
Модуль решает задачи:
- регистрация и снятие обработчиков событий Bitrix24 без правки файлов на сервере;
- автогенерация шаблонов обработчиков с try/catch и логированием;
- справочник 300+ событий по 15+ модулям (main, crm, tasks, iblock, im и др.) с описаниями;
- просмотр всех зарегистрированных обработчиков на портале (в т.ч. сторонних);
- логирование ошибок и уведомления администратора через мессенджер;
- бизнес-логика задач: CRM-привязки, диск, ФОТ, нумерация, аудиторы;
- синхронизация карточек CRM «наша организация» ↔ дубликат-партнёр.
Возможности модуля
| Область | Что даёт |
|---|---|
| Администрирование | Регистрация, редактирование и удаление обработчиков из UI |
| Справочник | Каталог событий Bitrix24 с описаниями по модулям |
| Автосоздание | Готовый PHP-шаблон при добавлении нового обработчика |
| Мониторинг | Просмотр всех обработчиков портала, лог ошибок, IM-уведомления |
| Задачи | Единый класс вместо 15 разрозненных блоков БП |
| CRM | Двусторонняя синхронизация компании и дубликата-партнёра |
| Отчётность | Автосоздание задач по шаблону с подзадачами и публикацией в чат |
Административный интерфейс
Модуль открывается в Настройки → Настройки модулей → Обработчики событий.
Вкладка «События»
- выбор модуля-источника (main, crm, tasks, iblock, im, bizproc, sale и др.);
- добавление обработчика: событие, класс, метод, сортировка;
- редактирование и удаление зарегистрированных обработчиков модуля;
- при добавлении автоматически создаётся PHP-файл-шаблон для собственной логики.
Раздел «Справочник»
- полный список всех обработчиков выбранного модуля на портале (включая сторонние);
- отображение модуля-получателя, класса, метода, callback, сортировки.
Вкладка «Настройки»
| Параметр | Описание |
|---|---|
| LOG_ENABLED | Включение записи ошибок в файл |
| NOTIFY_ON_ERROR | Отправка уведомлений при ошибках |
| NOTIFY_TYPE | user — пользователю, chat — в чат |
| NOTIFY_TARGET | ID получателя |
Раздел «Лог ошибок»
- просмотр содержимого логов модуля;
- очистка лога одной кнопкой.
Обработчики задач
Класс объединяет логику, ранее разнесённую по 15 блокам бизнес-процессов. Использует traits для IM и работы с папками на диске.
При создании задачи:
- наследование CRM-привязки от родительской задачи;
- нормализация привязки до одного элемента CRM;
- запрет создания без привязки к CRM;
- запрет привязки к закрытой сделке (WON/LOSE);
- автоматическая нумерация и формирование заголовка;
- назначение наблюдателей из сделки + заместитель при отсутствии постановщика;
- автоматическое включение учёта времени для задач определённых групп;
- назначение рабочей группы по отделу ответственного.
При обновлении задачи:
- пересчёт уровня вложенности;
- синхронизация CRM-привязки и переименование по сделке/лиду;
- создание и синхронизация папки задачи на Bitrix Disk;
- пересчёт ФОТ по подзадачам и соисполнителям;
- синхронизация папки с групповым диском;
- восстановление папки при восстановлении задачи;
- синхронизация названия чата задачи;
- откат статуса «Завершена», если есть незакрытые подзадачи;
- переименование папок дочерних задач при смене префикса.
Задачи по шаблону
Срабатывает после создания задачи по заданному шаблону:
- Сначала обновляет заголовок: «Задача {месяц} {год}».
- Затем создаёт подзадачи для каждого подчинённого отдела.
- После этого публикует в чат подзадачи список завершённых за месяц задач и обращений (смарт-процессы).
- Наконец, переносит родительскую задачу в заданную иерархию.
Синхронизация компаний CRM
Концепция
Для каждой нашей организации автоматически создаётся дубликат-партнёр. Пользователи редактируют дубликат; изменения синхронизируются в оригинал.
Направления синхронизации
| Направление | Что синхронизируется |
|---|---|
| Дубликат → оригинал | поля компании, наблюдатели, файловые UF, реквизиты, банки, контакты, мультиполя |
| Оригинал → дубликат | только при первичном создании дубликата («окно создания») |
Защита от гонок: блокировки по ID компании, cooldown между прогонами, синхронизация реквизитов только в том же HTTP-запросе, парные удаления через UF-связи.
Удобство для пользователей
- Администратор без SSH — новый обработчик регистрируется в UI, файл-шаблон создаётся сам.
- Справочник под рукой — не нужно искать название события в документации Bitrix.
- Видимость всего портала — на вкладке «Справочник» видны и чужие обработчики, не только модульные.
- Ошибки не теряются — лог и уведомление в чат при сбое обработчика.
- Сотрудники не замечают модуль — но получают корректные задачи: папки на диске, CRM-привязки, ФОТ и названия создаются автоматически.
- Безопасное редактирование компаний — пользователи работают с дубликатом, оригинал «нашей организации» остаётся консистентным.
Результат для бизнеса
- быстрое внедрение изменений — новая логика на событие без деплоя всего портала;
- единые правила для задач — CRM-привязка, диск и ФОТ работают одинаково для всех отделов;
- меньше «битых» задач — нельзя создать задачу без CRM или с закрытой сделкой;
- автоматические отчёты — шаблонные задачи с подзадачами и публикацией в чат экономят время руководителей;
- целостность CRM — синхронизация компаний и реквизитов без ручного копирования;
- сопровождаемость — централизованный лог и каталог обработчиков снижают риск «забытых» скриптов на сервере.
Связь с другими приложениями
| Приложение | Связь |
|---|---|
| Мои данные | ФОТ задач, история ФОТ, расчёт баланса; создание задачи начисления ФОТ |
| Универсальный бот | Связанные функции при проставлении ФОТ в задаче |
| Мониторинг отделов | Общая логика отчётных задач и статистики по подразделениям |
