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

Журнал действий — история операций в IZI CRM

Опубликовано: · Обновлено: (13 дней назад)· IZI Team

Журнал действий — кто и что менял в вашем клубе

Заголовок раздела «Журнал действий — кто и что менял в вашем клубе»

Журнал действий — раздел IZI CRM, который автоматически фиксирует каждую операцию сотрудника: создание акции, изменение продукта, работу со сменой и сотни других мутаций. Запись появляется сразу после выполнения операции без каких-либо настроек с вашей стороны — система работает на уровне Apollo-плагина и перехватывает все CRM-мутации. Каждая строка в журнале говорит вам: кто именно (имя и email сотрудника), что сделал (название операции), в каком клубе (если операция привязана к конкретному клубу), когда (дата и время с точностью до секунды) и с каким результатом — зелёная отметка для успешных операций, красная для завершившихся с ошибкой. Действия конечных посетителей клуба в журнал не попадают: он ведётся только по сотрудникам, работающим через CRM-интерфейс. Это принципиальное разграничение: вы видите только те изменения, которые реально влияют на конфигурацию клуба — тарифы, продукты, акции, настройки смен. Системные автоматические операции тоже фиксируются — в таких записях вместо имени сотрудника отображается пометка «Система», что позволяет отличить ручные действия от фоновых процессов. Раздел расположен в настройках организации и доступен пользователям с разрешением AUDIT_LOG_READ. Возможности фильтрации — по сотруднику, типу операции, клубу и периоду — позволяют за несколько секунд сузить тысячи записей до нужного события, а детальный просмотр каждой записи открывает точные входные параметры операции в JSON.

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

  • пользователь аутентифицирован с ролью CRM;
  • запрос является мутацией (изменение данных, не чтение);
  • мутация входит в перечень AuditLogOperationName — он генерируется автоматически из GraphQL-схемы и обновляется при добавлении новых функций.

Примеры операций, которые фиксируются: создание и обновление продуктов, управление акциями и промокодами, работа с тарифами, операции со сменами, изменения в настройках клуба. Системные автоматические операции (без конкретного сотрудника) тоже попадают в лог — в колонке «Пользователь» для них отображается пометка «Система».

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

КолонкаЧто показывает
Дата и времяМомент выполнения операции; цветная полоска слева — зелёная (успех) или красная (ошибка)
ПользовательИмя и email сотрудника; «Система» для автоматических операций
ОперацияЧеловекочитаемое название операции, например «Обновление продукта»
КлубКлуб, в контексте которого выполнена операция; прочерк для операций уровня организации
ДействияКнопка открытия деталей (появляется при наведении, если запись имеет детали)

По умолчанию таблица отсортирована по дате — сначала самые свежие записи. Пагинация — до 100 записей на странице.

Панель фильтров расположена над таблицей и позволяет сузить выборку по четырём параметрам:

  • Период — диапазон дат (обе границы включительно);
  • Пользователи — выбор нескольких сотрудников одновременно;
  • Операции — выбор одного или нескольких типов операций;
  • Клубы — фильтр по конкретному клубу или нескольким клубам.

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

Клик по строке или кнопка с иконкой в колонке «Действия» открывает модальное окно с двумя вкладками.

Содержит структурированную карточку записи:

  • Дата и время — точный момент операции;
  • Пользователь — имя и email (или пометка «Система»);
  • Операция — человекочитаемое название и технический идентификатор операции;
  • Клуб — если операция привязана к конкретному клубу;
  • Ошибки — если статус ERROR, блок с сообщениями об ошибках и путями GraphQL, по которым они возникли;
  • Связанные сущности — кнопки-теги с клиентом, заказом, транзакцией, девайсом, зоной или другими объектами, которых касалась операция. По клику открывается карточка этой сущности прямо из журнала.

Два блока с JSON-содержимым:

  • Входные параметры — переменные, с которыми была вызвана мутация (содержимое поля input);
  • Результат выполнения — либо data с результатом успешной операции, либо errors с массивом ошибок GraphQL.

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

Типичный сценарий — кто-то изменил данные, и нужно понять кто и когда.

  1. Откройте журнал действий в настройках организации.
  2. Выставьте примерный период через фильтр дат.
  3. В фильтре «Операции» выберите тип (например, «Обновление продукта»).
  4. Просмотрите результаты — таблица покажет кто выполнял операции этого типа в выбранном периоде.
  5. Нажмите на нужную строку и перейдите во вкладку «Технические данные» — там будут точные значения, которые передавались в момент операции.

Если операция завершилась с ошибкой (красная отметка), во вкладке «Обзор» сразу виден блок с текстом ошибки. Это помогает понять, что именно не дало операции выполниться.

Раздел «Журнал действий» отображается только пользователям с разрешением AUDIT_LOG_READ на уровне организации. Разрешение задаётся в настройках ролей и может быть назначено как владельцу, так и отдельным административным ролям.

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

Частые вопросы

Что такое журнал действий в IZI CRM?

Журнал действий — автоматический лог всех операций, выполненных сотрудниками через CRM-интерфейс. Каждая запись содержит имя пользователя, тип операции, клуб (если применимо), статус выполнения и точное время.

Какие операции попадают в журнал?

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

Можно ли отфильтровать журнал по конкретному сотруднику?

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

Как посмотреть детали конкретной операции?

Нажмите на строку в таблице журнала или на кнопку с иконкой в колонке «Действия». Откроется модальное окно с вкладками: «Обзор» — дата, пользователь, операция, клуб и связанные сущности; «Технические данные» — входные параметры и результат выполнения в JSON.

Что означают статусы SUCCESS и ERROR?

SUCCESS — операция завершилась без ошибок, данные сохранены. ERROR — мутация завершилась с ошибкой GraphQL; во вкладке «Обзор» детальной записи будут показаны сообщения об ошибках и пути, по которым они возникли.

Какое разрешение нужно для доступа к журналу?

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

Хранятся ли входные параметры операций?

Да. В технических данных записи хранятся переменные GraphQL-запроса (поля input: {}) и результат выполнения — либо data с результатом, либо массив errors с описанием ошибок.

Можно ли связать запись журнала с конкретным клиентом, заказом или сессией?

Да, если операция касалась конкретной сущности, в деталях записи отображаются «Связанные сущности»: клиент, заказ, транзакция, девайс, зона и другие — с возможностью перейти к ним прямо из модального окна.

Записываются ли системные операции?

Да, но с пометкой «Система» вместо имени пользователя. Системные операции — это внутренние автоматические действия без конкретного CRM-пользователя.

Сколько записей показывается на странице?

По умолчанию 50 записей на страницу, максимум 100. Переключение страниц и размера страницы доступно прямо в таблице.

Есть ли сортировка в таблице журнала?

Да, таблица сортируется по четырём колонкам: «Дата и время», «Пользователь», «Операция» и «Клуб». Повторный клик по заголовку меняет направление сортировки.

Как журнал помогает при разборе инцидентов?

Если что-то изменилось неожиданно — например, пропал продукт или изменился тариф — в журнале можно найти операцию по типу и периоду, увидеть кто и когда это сделал, и проверить точные входные параметры во вкладке «Технические данные».