test(e2e): A5 审计与日志端到端用例

覆盖操作日志列表 / 筛选 / 详情 diff 与原始 JSON / 导出创建轮询与签名下载 / 导出自身留痕 / 权限三态 / 运行日志空态与配置外链；A5_E2E=1 门控，临时账号与角色自建自清。

e2e/README.md

@@ -2,13 +2,14 @@
 
 ## 现有用例
 
-| 文件                        | 说明                                                                     | 默认是否执行      |
-| --------------------------- | ------------------------------------------------------------------------ | ----------------- |
-| `smoke.spec.ts`             | A0 冒烟：登录、模块切换、403 / 404                                       | 是                |
-| `a1-identity.spec.ts`       | A1-QA-01 账号生命周期（①–⑥）                                             | 否，需 `A1_E2E=1` |
-| `a2-roles.spec.ts`          | A2-QA-01 角色管理 / 权限三态 / SoD / 即时生效                            | 否，需 `A2_E2E=1` |
-| `a3-client.spec.ts`         | A3-QA-01 客户与行业六页可访问 / 数据加载                                 | 否，需 `A3_E2E=1` |
-| `a4-dicts-settings.spec.ts` | A4-QA-01 数据字典 / 三层合并 / 编码只读 / 系统配置 / 阈值确认 / 变更记录 | 否，需 `A4_E2E=1` |
+| 文件                        | 说明                                                                      | 默认是否执行      |
+| --------------------------- | ------------------------------------------------------------------------- | ----------------- |
+| `smoke.spec.ts`             | A0 冒烟：登录、模块切换、403 / 404                                        | 是                |
+| `a1-identity.spec.ts`       | A1-QA-01 账号生命周期（①–⑥）                                              | 否，需 `A1_E2E=1` |
+| `a2-roles.spec.ts`          | A2-QA-01 角色管理 / 权限三态 / SoD / 即时生效                             | 否，需 `A2_E2E=1` |
+| `a3-client.spec.ts`         | A3-QA-01 客户与行业六页可访问 / 数据加载                                  | 否，需 `A3_E2E=1` |
+| `a4-dicts-settings.spec.ts` | A4-QA-01 数据字典 / 三层合并 / 编码只读 / 系统配置 / 阈值确认 / 变更记录  | 否，需 `A4_E2E=1` |
+| `a5-audit-logs.spec.ts`     | A5-QA-01 操作日志列表 / 筛选 / 详情 diff / 导出闭环 / 权限三态 / 运行日志 | 否，需 `A5_E2E=1` |
 
 ## A1 账号生命周期用例
 
@@ -109,3 +110,27 @@ A4_E2E=1 pnpm exec playwright test e2e/a4-dicts-settings.spec.ts --reporter=list
 - Semi Select 选项可访问名含图标 aria-label（tick），精确匹配不到，使用 `.semi-select-option` 文本点击。
 - `Modal.confirm` 的确认 / 取消按钮 `aria-label` 固定为 `confirm` / `cancel`，不要按 `okText` 文本定位。
 - `RadioGroup` 隐藏 input 被 addon 拦截，点可见文本或 `.semi-radio-addon-buttonRadio`。
+
+## A5 审计与日志用例（A5-QA-01）
+
+覆盖 5 条：
+
+1. `/system/audit-logs` 列表可见：h1「操作日志」、副标题、查看留痕提示条（`audit.log.view`）、表格有数据、导出按钮（超管）。
+2. 筛选：动作分类「权限与角色」→ URL `?category=permission` 且结果变化；「重置」恢复默认。
+3. 详情：点击「修改角色权限」行 → `/system/audit-logs/{id}`；变更对比含「权限点」；元信息含 trace_id / IP / 请求 / 耗时；切换「原始 JSON」可看到完整记录（occurred_at / actor / action / target / before / after）；只读说明存在。
+4. 导出闭环：打开 560 抽屉 → 创建导出任务 → 轮询到「导出完成」→ 导出历史出现「已完成」任务 → API 断言 `download_token` 存在且签名下载返回 200 CSV → 关闭抽屉并重置筛选后，列表出现 `audit.export` 记录（导出自身留痕）。
+5. 权限三态：无 `audit:read` 账号访问 `/system/audit-logs` → `/403`；仅有 `audit:read`（自定义角色，无 `audit:export`）→ 页面显示「只读 · 无 audit:export 权限」且不渲染导出按钮。
+6. 运行日志：`audit.logs_platform_url` 置空 → 空态 + 「前往系统配置」；写入示例地址后刷新 → 外链与平台入口卡存在；结束后还原配置。
+
+### 前置与运行
+
+1. API 3000 + Web 5173（`pnpm dev`，真实 PG；已执行 `pnpm db:init`）。
+2. 用例自建临时账号 `qa5.audit.e2e`（超管）、`qa5.audit.viewer`（仅 `audit:read`）、`qa5.audit.ro`（素材运营，无 `audit:read`）与自定义角色 `a5e2e_audit_viewer`；结束后删除账号 / 角色并还原 `audit.logs_platform_url`。
+3. ⚠️ 审计表 append-only：用例产生的登录 / 查看 / 导出 / 下载审计记录**不删除**，属预期留痕。
+
+```bash
+A5_E2E=1 pnpm exec playwright test e2e/a5-audit-logs.spec.ts --reporter=list
+```
+
+- 可选覆盖：`A5_E2E_BASE_URL`（缺省 `http://127.0.0.1:5173`）、`A5_E2E_API_BASE_URL`（缺省 `http://127.0.0.1:3000/api/v1`）。
+- 用例不点击外网链接；运行日志只断言外链 href 存在。