Журнал изменений конфигурации CRM в коробочном Битрикс24

Задача

В большом коробочном портале настройки CRM меняют разные администраторы и разработчики. Если после этого перестал запускаться бизнес-процесс, пропала стадия, изменилось обязательное поле или поменялась автоматизация, важно быстро понять не только что изменилось, но и когда это произошло.

Я разработал отдельный журнал конфигурации CRM. Он фиксирует изменения настроек, сохраняет состояние объекта до и после изменения и, когда это возможно, связывает событие с пользователем, который его выполнил.

Задача модуля — не заменять историю карточек CRM, а контролировать именно конфигурацию портала.

Что можно отслеживать

В настройках можно отдельно включить или выключить нужные группы событий:

• шаблоны бизнес-процессов CRM;
• роботы и автоматизацию;
• создание, изменение и удаление воронок сделок;
• стадии сделок;
• стадии лидов;
• настройки смарт-процессов;
• воронки смарт-процессов;
• стадии смарт-процессов;
• пользовательские поля CRM и их настройки.

Для каждого объекта различаются три действия: создание, изменение и удаление.

Как устроено отслеживание

Для конфигурационных сущностей я использую снимки состояния. Модуль нормализует интересующие настройки и сравнивает текущее состояние с предыдущим.

состояние до
    ↓
изменение настройки
    ↓
состояние после
    ↓
сравнение
    ↓
create / update / delete
    ↓
запись в журнал

Такой подход позволяет отслеживать и те настройки, для которых нет одного универсального события, подходящего для всего набора конфигурации CRM.

Для пользовательских полей дополнительно используются события ядра. Фоновая проверка нужна для изменений, которые прошли не через обычный пользовательский интерфейс: например, через консоль, интеграцию или сторонний код.

Как определяется автор

Если изменение выполняется из интерфейса портала, модуль делает снимок конфигурации до POST-запроса и повторную проверку после него. Благодаря этому изменение можно связать с текущим авторизованным пользователем.

пользователь сохраняет настройку
        ↓
снимок до изменения
        ↓
Битрикс выполняет сохранение
        ↓
снимок после изменения
        ↓
в журнал записывается USER_ID

Для бизнес-процессов и роботов дополнительно можно использовать автора, который хранится в самом шаблоне. Если изменение обнаружено только фоновой проверкой и определить пользователя однозначно нельзя, журнал не подставляет случайного автора.

Журнал изменений

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

В строке журнала показываются:

• дата и время изменения;
• тип конфигурации;
• действие;
• название и технический идентификатор объекта;
• автор;
• краткое описание изменения;
• источник обнаружения.

Блок «До / после» раскрывает сохранённые состояния объекта и позволяет увидеть, какие параметры реально изменились.

Что получилось

В результате изменения настроек CRM перестают быть неявными. Если после доработки портала возникает проблема, можно сначала открыть журнал и проверить, что менялось непосредственно перед ней.

Такой аудит особенно полезен на коробочных порталах, где одновременно работают несколько администраторов, разработчиков и интеграторов, а конфигурация постепенно обрастает автоматизацией и собственным кодом.

При этом журнал отделён от обычных данных CRM: изменение сделки или контакта не создаёт запись. Отслеживаются именно настройки и структура CRM.