Историю заказа нельзя восстановить по полю updated_at: оно сообщает время последней записи, но не actor, причину и старое значение. Для каждой подтверждённой команды создавайте отдельное audit event с идентификатором заказа, действием, субъектом, источником, before/after diff и correlation ID. Событие не редактируется вместе с заказом.
Начните с критичных переходов — статус, оплата, сумма, адрес доставки, состав и возврат. Полный snapshot после каждого нажатия обычно избыточен и опасен для персональных данных. Сохраняйте только поля, которые нужны для расследования и бизнес-контроля, с маскированием чувствительных значений.
Один факт изменения отвечает на семь вопросов
| Поле события | Пример | Зачем |
|---|---|---|
| occurred_at | 2026-10-09T09:15:20+03:00 | порядок событий |
| actor | user:482 или service:payment | кто инициировал |
| action | order.status_changed | что произошло |
| object | order:8421 | с какой сущностью |
| diff | status: paid → shipped | какие данные изменились |
| reason/source | admin_ui / webhook | откуда пришла команда |
| correlation_id | req_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 одного заказа
- Отсортировать audit events по occurred_at и стабильному sequence/event ID.
- Связать нужное событие с request, job или webhook по correlation ID.
- Проверить identity actor и разрешение на действие в момент операции.
- Сравнить before/after с соседними событиями и текущим состоянием.
- Зафиксировать причину, исправление и тест, не редактируя старую запись.
Исправление принято, когда тестовый оператор, service job и запрещённая попытка оставляют различимые следы, а восстановленная цепочка совпадает с состоянием заказа. Для разбора подготовьте order ID, временной диапазон, event IDs, версии схемы и обезличенные diffs. Пароли сотрудников и полные данные покупателя к задаче не прикладывают.