diff --git a/openspec/changes/quality-metrics/specs/audit-trail/spec.md b/openspec/changes/quality-metrics/specs/audit-trail/spec.md new file mode 100644 index 0000000..8389001 --- /dev/null +++ b/openspec/changes/quality-metrics/specs/audit-trail/spec.md @@ -0,0 +1,12 @@ +## ADDED Requirements + +### Requirement: Аудит выгрузки метрик качества +Каждый успешный `GET /quality-metrics/export` SHALL добавлять отдельное неизменяемое событие `audit_event` с +`action = EXPORT`, `section = EXPORT`, `object_type = quality_metrics`, `object_id = null`, `user_id` инициатора, +`before_value = null` и `after_value = {report, format, filters, rows}`: `report` — тип выгрузки, `format` — `csv` или +`json`, `filters` — применённые фильтры, `rows` — число выгруженных строк. Выгрузка сводной ОСВ и шахматки продолжают +писать собственные события `EXPORT`. + +#### Scenario: Выгрузка метрик оставляет след +- **WHEN** пользователь с `QUALITY_METRICS_VIEW` выгружает факты за период в CSV +- **THEN** записано одно событие `EXPORT` с `object_type = quality_metrics`, форматом, фильтрами и числом строк