Историю заказа нельзя восстановить по полю updated_at: оно сообщает время последней записи, но не actor, причину и старое значение. Для каждой подтверждённой команды создавайте отдельное audit event с идентификатором заказа, действием, субъектом, источником, before/after diff и correlation ID. Событие не редактируется вместе с заказом.

Начните с критичных переходов — статус, оплата, сумма, адрес доставки, состав и возврат. Полный snapshot после каждого нажатия обычно избыточен и опасен для персональных данных. Сохраняйте только поля, которые нужны для расследования и бизнес-контроля, с маскированием чувствительных значений.

Один факт изменения отвечает на семь вопросов

Поле событияПримерЗачем
occurred_at2026-10-09T09:15:20+03:00порядок событий
actoruser:482 или service:paymentкто инициировал
actionorder.status_changedчто произошло
objectorder:8421с какой сущностью
diffstatus: paid → shippedкакие данные изменились
reason/sourceadmin_ui / webhookоткуда пришла команда
correlation_idreq_01J...связь с request и интеграцией

Actor бывает не только человеком. Автоматическая задача, webhook платёжного сервиса и миграция получают собственную service identity. Не записывайте все фоновые изменения как admin или system: такой журнал не позволяет найти конкретный процесс и версию кода.

Audit event создаётся рядом с бизнес-командой

Событие формируется после проверки прав и валидации команды, но связано с той же транзакцией, что и изменение заказа. Если commit откатился, успешного audit event быть не должно. Неудачные попытки можно писать в security log с outcome=denied, отделяя их от истории фактического состояния.

{
  "event": "order.status_changed",
  "object": "order:8421",
  "actor": "service:delivery-sync",
  "source": "carrier_webhook",
  "before": {"status": "packed"},
  "after": {"status": "shipped"},
  "correlation_id": "req_01J...",
  "outcome": "success"
}

Пример не содержит адрес, телефон, access token или полный webhook payload. При необходимости доказать входные данные храните отдельную защищённую ссылку на сырой объект с собственным сроком хранения. Audit trail должен помогать расследованию, не превращаясь во вторую неуправляемую базу персональных данных.

Debug-лог и аудит живут по разным правилам

  • Debug-лог объясняет работу кода и может менять формат между релизами.
  • Audit trail использует стабильные business event names и версионированную схему.
  • Доступ к истории выдаётся только ролям, которым он нужен.
  • Записи защищаются от незаметного изменения и удаления.
  • Срок хранения определяется риском и требованиями организации, а не размером диска.

OWASP относит добавление, изменение и удаление данных к подходящим событиям audit trail и требует защищать механизмы журналирования от несанкционированного доступа и изменения. NIST рассматривает генерацию, передачу, хранение, доступ и удаление логов как единый процесс управления, а не просто вызов logger в контроллере.

История должна переживать интеграции и повторные события

Сохраняйте external event ID для webhook и event ID для внутренних очередей. Если один carrier webhook пришёл дважды, бизнес-операция остаётся идемпотентной, а журнал может отразить вторую попытку как duplicate_ignored. Тогда оператор видит, почему статус не менялся второй раз, и не принимает это за потерянное событие.

PostgreSQL triggers могут фиксировать изменения на уровне таблицы, но они не знают бизнес-причину без переданного контекста. Trigger полезен как страховочный слой для прямых UPDATE, однако основное приложение должно передать actor, source и correlation ID безопасным способом. Не доверяйте actor ID из редактируемого поля формы.

Расследование начинается с timeline одного заказа

  1. Отсортировать audit events по occurred_at и стабильному sequence/event ID.
  2. Связать нужное событие с request, job или webhook по correlation ID.
  3. Проверить identity actor и разрешение на действие в момент операции.
  4. Сравнить before/after с соседними событиями и текущим состоянием.
  5. Зафиксировать причину, исправление и тест, не редактируя старую запись.

Исправление принято, когда тестовый оператор, service job и запрещённая попытка оставляют различимые следы, а восстановленная цепочка совпадает с состоянием заказа. Для разбора подготовьте order ID, временной диапазон, event IDs, версии схемы и обезличенные diffs. Пароли сотрудников и полные данные покупателя к задаче не прикладывают.

Проверенные источники