# <模块名称> 审计日志 SOP

## 记录原则

所有会改变目标业务对象关键状态、负责人/处理人、可见性、金额、结论或对外结果的动作都必须记录审计日志。

## 审计字段

| 字段 | 含义 | 示例 |
| --- | --- | --- |
| target_type | 业务对象类型 | order / customer / request |
| target_id | 业务对象 ID | 100001 |
| actor_id | 操作人 ID | 1001 |
| actor_name | 操作人名称 | zhangsan |
| action | 操作类型 | ASSIGN / APPROVE / CLOSE |
| field_name | 变更字段 | status / owner_id / amount |
| old_value | 旧值 | lisi |
| new_value | 新值 | wangwu |
| source | 来源 | web |
| request_id | 请求 ID | req-001 |
| created_at | 操作时间 | 2026-07-01 10:00:00 |

## 必须记录的动作

| 动作 | 写入时机 | oldValue | newValue | 验收 |
| --- | --- | --- | --- | --- |
| 创建记录 | 创建成功后 | 空 | 业务摘要 | 审计列表可见 |
| 编辑字段 | 保存成功后 | 修改前字段 | 修改后字段 | 字段前后值正确 |
| 分配/转交 | 分配成功后 | 原处理人 | 新处理人 | 审计记录处理人变化 |
| 状态流转 | 状态变更成功后 | 原状态 | 新状态 | 审计记录状态变化 |
| 结论/审核 | 结论保存成功后 | 原结论 | 新结论 | 审计记录结论变化 |
| 评论/备注新增 | 保存成功后 | 空 | 摘要或脱敏内容 | 审计记录评论动作 |
| 关闭/归档 | 操作成功后 | 原状态 | 目标终态 | 审计记录关闭或归档时间 |

## 验收方式

1. 执行关键操作后能在审计列表查询到记录。
2. oldValue/newValue 和实际变更一致。
3. 敏感字段已脱敏。
4. 操作失败不写成功审计。
5. 多步写入失败时审计和业务数据保持一致。