test-spec.md 7.7 KB
单测 Spec — 新增页面操作审计日志并优化页面视觉样式
status: applied created: 2026-07-07
0. 测试原则
- Red/Green TDD：本轮涉及横切日志与已有页面改造，优先补静态/编译/构建验证；若发现已有可复用单测，再按 Red/Green 增量补充。
- First Run the Tests：开始验证前读取
code-copilot/rules/automated-testing-standard.md。 - 展示工作：所有命令、结果、警告和跳过项追加到
execution-log.md。 - 增量复用：本变更新建测试规格，后续验证只追加本轮增量。
1. 测试框架
| 项目 | 值 |
|---|---|
| JUnit 版本 | 待 Maven 检测 |
| Mock 框架 | 待 Maven 检测 |
| 前端测试 | Vite 构建为主，必要时补 Playwright 页面检查 |
| 已有测试风格 | 后续按实际模块检查补充 |
2. 覆盖范围
P0 — 核心业务逻辑（必须覆盖）
| 类名 | 方法 | 场景 | 输入 | 预期结果 |
|---|---|---|---|---|
OperationLogAspect |
around |
请求头包含页面路径和标题 | X-Page-Path, X-Page-Title |
OperationLogInfo 写入页面字段 |
OperationLogAspect |
around |
查询类请求 | OperationType.QUERY 或 GET/HEAD/OPTIONS |
直接放行，不保存审计日志 |
OperationLogAspect |
around |
POST 查询兼容接口 | /getById、/page 等查询 URL |
识别为 QUERY 并直接放行 |
OperationLogAspect |
around |
变更类请求 | ADD/UPDATE/DELETE/IMPORT/EXPORT/OTHER 或 POST/PUT/PATCH/DELETE |
保存审计日志 |
OperationLogAspect |
fillAuditSnapshot |
加密请求体被省略 | [DECRYPTED_REQUEST_BODY_OMITTED] |
不写入 afterData |
SysUserController |
edit/remove/updateStatus/resetPwd |
用户管理主操作 | 用户 ID / DTO | 写入脱敏 beforeData、afterData、diffData |
interceptors.js |
resolvePageAuditHeaders |
页面标题仅为基础系统名 | /system/user + 菜单数据 |
优先写入菜单/页签标题 |
operation-log.vue |
normalizeOperationTypeOptions |
字典同时存在 INSERT=新增 和 ADD=新增 |
sys_operation_type 字典列表 |
搜索下拉只保留一个 ADD=新增 |
SysOperationLogServiceImpl |
page |
多条件筛选 | Query DTO | 调用 XML 分页查询 |
SysOperationLogServiceImpl |
selectExportList |
导出筛选 | Query DTO | 返回导出列表 |
P1 — 数据访问层
SysOperationLogMapper.xml明确列字段，不使用SELECT *。- 页面、操作人、时间、状态、URL 等筛选条件可组合。
operationType=ADD筛选兼容历史INSERT日志。V1.0.15__normalize_operation_type_add_dict.sql避免在sys_dict_data唯一键已存在ADD时直接把INSERT改成ADD。
P2 — 入口层/服务层
/system/operationLog/page返回新增字段。/system/operationLog/{id}返回详情。/api/excel/export/sys_operation_log_export可反射调用sysOperationLogService.selectExportList。
不测试（明确列出原因）
- 不做真实合规留存策略验证：本需求不新增清理任务。
- 不做所有业务表数据库级 diff 自动采集：通用切面不具备跨业务表自动前后快照能力，本轮提供上下文字段和默认请求/响应快照。
3. 执行计划
- Step 1: 读取自动化测试标准。
- Step 2: 静态检查迁移脚本版本、字段、
NOT EXISTS、显式列。 - Step 3: 后端 system 插件依赖编译。
- Step 4: 前端生产构建。
- Step 5: 如服务可用，登录后访问
/system/operation-log验证列表、筛选、详情、导出。
4. 历史验证基线
| 时间 | 范围 | 命令 | 结果 | 备注 |
|---|---|---|---|---|
| 2026-07-07 | 初始调研 | rg OperationLog/sys_operation_log |
通过 | 确认已有日志链路 |
5. 本轮增量验证
| 时间 | 变更范围 | 必跑项 | 实际命令 | 结果 | 跳过/警告 |
|---|---|---|---|---|---|
| 2026-07-07 | 静态 | 空白/SQL/XML | git diff --check; rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.14__enhance_operation_log_page_audit.sql; xmllint --noout forge-server/forge-framework/forge-plugin-parent/forge-plugin-system/src/main/resources/mapper/SysOperationLogMapper.xml |
通过 | Flyway 占位符扫描无输出 |
| 2026-07-07 | 后端 | 编译 | env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -q -pl forge-framework/forge-plugin-parent/forge-plugin-system -am compile -DskipTests |
通过 | - |
| 2026-07-07 | 后端 | 主应用依赖编译 | env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -q -pl forge-admin-server -am compile -DskipTests |
通过 | - |
| 2026-07-07 | 前端 | 构建 | source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build |
通过 | v20.20.0 未安装，已回退到本机已安装的 v20.19.0；构建存在既有 warning |
| 2026-07-08 | 后端 | 查询日志过滤增量 | git diff --check; env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -q -pl forge-admin-server -am compile -DskipTests |
通过 | 未启动服务做数据库落库验证 |
| 2026-07-08 | SQL | Flyway 字典补丁别名修复 | `rg -n "seed\.dict_label | '新增' dict_label | SELECT 1 tenant_id, 2 dict_sort" forge-server/db/migration/V1.0.14__enhance_operation_log_page_audit.sql;git diff --check` |
| 2026-07-08 | 前后端 | 页面标题/模块/快照修复 | git diff --check; env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -q -pl forge-admin-server -am compile -DskipTests; source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build |
通过 | 前端构建仍存在既有动态导入、CSS // 注释和 chunk size warning |
| 2026-07-08 | 前后端/SQL | 操作类型新增重复修复 | git diff --check; rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.15__normalize_operation_type_add_dict.sql; xmllint --noout forge-server/forge-framework/forge-plugin-parent/forge-plugin-system/src/main/resources/mapper/SysOperationLogMapper.xml; env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -q -pl forge-admin-server -am compile -DskipTests; source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build |
通过 | rg 占位符扫描无输出；前端构建仍存在既有 warning；未启动 MySQL 实跑 Flyway |
6. 执行证据
execution-log.md：本变更目录执行日志。- 关键接口：
/system/operationLog/page、/system/operationLog/{id}、/api/excel/export/sys_operation_log_export。 - 关键数据库检查：
SHOW COLUMNS FROM sys_operation_log、Excel 配置sys_operation_log_export。 - 服务启动与停止：按执行情况补充。
7. 跳过项
- 后端服务启动、登录后页面联调、真实数据库 Flyway 实跑：本轮未启动本地 MySQL/Redis/后端服务；已用幂等 SQL 静态检查、Mapper XML 检查、后端主应用依赖编译和前端构建覆盖核心风险。