feat(admin): 新增后台审计日志视图

2026-10-30 13:29:46 +08:00
parent d46636c3d2
commit 1acf433611
10 changed files with 713 additions and 6 deletions
@@ -194,12 +194,12 @@ dist/assets/AdminLayout-*.js               36.87 kB │ gzip  13.02 kB
 ## 5. 已知限制

 1. 移动端订单列表/详情与消息中心已接入真实接口；下单、支付、交接、归还、结账等操作仍待迁移。
-2. 后台已完成仪表盘、订单列表/详情、退款审核、提现审核、商品列表/详情与审核、用户列表/详情与人工操作、申诉仲裁、财务看板、公告管理，其余页面仍为统一占位。
+2. 后台已完成仪表盘、订单列表/详情、退款审核、提现审核、商品列表/详情与审核、用户列表/详情与人工操作、申诉仲裁、财务看板、公告管理、审计日志，其余页面仍为统一占位。
 3. 分销后台已完成主题、Logo、登录页与 Shell 轻改，页面结构未重写。
-4. 后台菜单权限码按后端逐个核对：订单 `order:list` / `order:view` / `order:close`，商品 `listing:view` / `listing:approve` / `listing:reject` / `listing:offline`，用户 `user:view` / `user:freeze` / `user:unfreeze` / `user:deposit_free` / `user:growth_points` / `user:manual_realname` / `user:revoke_realname` / `user:wallet_adjust`，提现 `withdrawal:list` / `withdrawal:detail` / `withdrawal:review` / `withdrawal:pay`，申诉 `dispute:view` / `dispute:arbitrate`，财务 `wallet:view`，公告 `announcement:view` / `announcement:manage`；其余页面仍需核对。
+4. 后台菜单权限码按后端逐个核对：订单 `order:list` / `order:view` / `order:close`，商品 `listing:view` / `listing:approve` / `listing:reject` / `listing:offline`，用户 `user:view` / `user:freeze` / `user:unfreeze` / `user:deposit_free` / `user:growth_points` / `user:manual_realname` / `user:revoke_realname` / `user:wallet_adjust`，提现 `withdrawal:list` / `withdrawal:detail` / `withdrawal:review` / `withdrawal:pay`，申诉 `dispute:view` / `dispute:arbitrate`，财务 `wallet:view`，公告 `announcement:view` / `announcement:manage`，审计日志 `audit_log:view`；系统配置与分销站点仍需核对。
 5. SVG 中文尚未转曲。
 6. 入口包已降至 495 kB（gzip 161 kB）；AntD 共享基础设施仍在入口，后续可拆独立入口。
-7. 移动端、订单、分销轻改与首屏优化均已提交；商品管理与审核在本批次提交。
+7. 移动端、订单、分销轻改与首屏优化均已提交；商品管理、审核、退款、提现、用户、申诉、财务、公告与审计日志已按批次提交。

 ---

@@ -0,0 +1,86 @@
+# Phase 2 验收报告（后台审计日志）
+
+> 日期：2026-10-30  
+> 项目：解忧商行（hfb_jysh）  
+> 范围：`/console-jy8k3m/audit-logs`  
+> 结论：**本切片通过，审计日志列表、筛选、分页与明细抽屉已接真实接口**
+
+---
+
+## 1. 接口与权限
+
+| 能力 | 接口 | 权限码 |
+| --- | --- | --- |
+| 审计日志列表 | `GET /api/admin/audit-logs` | `audit_log:view` |
+
+查询参数：
+
+```text
+actor_id   管理员 ID，正整数
+action     动作代码，精确匹配
+biz_type   业务类型，精确匹配
+page       页码，默认 1
+page_size  每页条数，默认 20，最大 100
+```
+
+响应字段：`items`、`total`、`page`、`page_size`。单条记录包含 `id`、`actor_type`、`actor_id`、`actor_username`、`actor_nickname`、`action`、`biz_type`、`biz_id`、`ip`、`user_agent`、`detail`、`created_at`。
+
+## 2. 页面
+
+`frontend/src/features/admin/AdminAuditLogsPage.tsx`
+
+- 筛选：管理员 ID、动作、业务类型
+- 动作与业务类型支持下拉建议，也允许直接输入后端动作代码
+- 列：时间/编号、操作人、动作、业务对象、IP、变更摘要、操作
+- 分页 10 / 20 / 50
+- 行点击或「详情」打开右侧抽屉
+- 无 `audit_log:view` 权限时显示提示并停止请求
+
+## 3. 明细抽屉
+
+- 操作信息：发生时间、日志编号、操作人、操作人类型、动作代码、业务对象
+- 请求信息：来源 IP、User-Agent
+- 变更明细：`detail` 统一格式化为两空格缩进 JSON，等宽字体、可滚动
+- `detail` 兼容 JSON 对象、JSON 字符串与 `null`，无法解析的字符串按原文展示
+
+## 4. 动作与业务类型文案
+
+在 `frontend/src/features/admin/labels.ts` 增加：
+
+- `auditActorTypeMap`：管理员 / 用户 / 系统
+- `auditBizTypeMap`：订单、商品、申诉、用户资料、后台账号、系统配置、支付配置、人工打款、运营支出、捡漏、分销、公告
+- `auditActionMap`：订单、商品、申诉、用户、配置、打款、支出、捡漏、分销与令牌刷新等已知动作的中文名称
+
+未知动作或业务类型保留原始代码，避免后端新增动作时前端丢失信息。
+
+## 5. 菜单与路由
+
+- 路由：`frontend/src/app/AppRouter.tsx` 新增 `audit-logs`
+- 菜单：`frontend/src/layouts/AdminLayout.tsx` 权限码由错误的 `audit:view` 修正为后端实际使用的 `audit_log:view`
+- 占位列表同步移除 `audit-logs`
+
+## 6. 验证结果
+
+```text
+npx tsc --noEmit                                    通过
+npm run build                                       通过（入口 497.18 kB，gzip 161.36 kB）
+GET /api/admin/audit-logs?page=1&page_size=5        ok，total=1
+GET /api/admin/audit-logs?actor_id=1&action=...     ok，筛选命中 1 条
+GET /console-jy8k3m/audit-logs                      200
+```
+
+开发库当前只有 1 条改密产生的审计记录；列表读取与筛选已实测，未触发新的资金或配置写操作。
+
+## 7. 已知限制
+
+1. 没有动作字典接口，筛选项来自前端维护的已知动作清单，后端新增动作需同步文案（未知动作仍可展示与按代码筛选）。
+2. 不支持时间范围筛选与关键字搜索，后端暂未提供对应参数。
+3. 没有导出 CSV 或日志归档能力。
+4. `detail` 仅在抽屉中展示，未做字段级 diff 高亮。
+
+## 8. 下一步建议
+
+1. 后台系统配置页。
+2. 线下出款与运营支出登记。
+3. 审计日志时间范围与关键字筛选（需后端补参数）。
+4. 移动端下单、支付与交接/归还/结账。
@@ -395,7 +395,7 @@ hfb_jysh/

 ### Phase 4：管理后台核心（4–5 周）

-> 状态：**进行中（2026-10-30）**。已完成仪表盘、订单、退款、提现、商品、用户、申诉、财务看板与公告管理；线下出款/运营支出、系统配置与审计日志待迁移。
+> 状态：**进行中（2026-10-30）**。已完成仪表盘、订单、退款、提现、商品、用户、申诉、财务看板、公告管理与审计日志；线下出款/运营支出与系统配置待迁移。

 - 后台登录、工作台、订单列表、订单详情。
 - 商品列表、商品详情、审核。