单测 Spec — 数据表逻辑删除分批改造

status: propose created: 2026-07-07

0. 测试原则

Red/Green TDD：涉及新增逻辑的单测必须先 Red 再 Green。
First Run the Tests：开始前先跑相关模块已有测试或编译，记录基线。
展示工作：必须把实际命令、结果、警告、跳过项写入 execution-log.md。
增量复用：执行 /test 或阶段验收前，先读取 code-copilot/rules/automated-testing-standard.md 和当前变更四件套。

1. 测试框架

项目	值
JUnit 版本	以项目 Maven 依赖为准
Mock 框架	以项目 Maven 依赖为准
已有测试数量	`/test` 阶段统计
已有测试风格	优先复用现有 service/mapper 测试风格

2. 覆盖范围

P0 — Batch 1 核心逻辑（必须覆盖）

类名	方法	场景	输入	预期结果
`EmployeeServiceImpl`	`deleteById(Long id)`	删除员工	存在的员工 ID	数据库记录保留，`del_flag=1`
`ReportTemplateService`	`deleteTemplate(Long id, Long userId)`	删除模板	当前用户拥有的模板 ID	数据库记录保留，`del_flag=1`
`FlowNodeConfigServiceImpl`	`deleteConfig(String id)`	删除节点配置	存在配置 ID	主配置逻辑删除，层级/操作配置按分类处理

P1 — Mapper XML 查询过滤

Mapper	方法	场景	预期结果
`ReportProjectMapper.xml`	`selectProjectPage`	存在 `del_flag=1` 项目	列表不返回
`ReportProjectMapper.xml`	`countByDirectoryIds`	目录下只有已删除项目	计数为 0
`FlowNodeConfigMapper.xml`	`selectByModelKeyAndNode`	同节点存在已删除配置	返回未删除配置

P2 — SQL 迁移

脚本	场景	预期结果
Batch 1 Flyway	目标列不存在	自动新增列
Batch 1 Flyway	目标列已存在	不报错
Batch 2/3 Flyway	表不存在	不报错，跳过

不测试（明确列出原因）

qrtz_*、act_*、flw_*：框架自带表，明确排除。
授权关系表：默认保留物理删除，防止脏授权。
纯日志清理表：保留物理删除，按留存策略清理。

3. 执行计划

Step 1: 读取 code-copilot/rules/automated-testing-standard.md。
Step 2: 运行 Batch 1 相关模块编译，确认基线。
Step 3: 为 Batch 1 代表服务补充最小单测或集成 smoke。
Step 4: 执行 Flyway SQL 幂等验证。
Step 5: 扩展 Batch 2/3 后按模块补充 smoke。

4. 历史验证基线

时间	范围	命令	结果	备注
2026-07-07	静态审计	`rg` + SQL/实体扫描	已完成	远程库只读查询未完成

5. 本轮增量验证

时间	变更范围	必跑项	实际命令	结果	跳过/警告
2026-07-07	Batch 1	编译 + 静态 SQL 检查	`git diff --check`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.2__fix_existing_logic_delete_contract.sql`; `mvn -q -pl forge-admin-server -am -DskipTests compile`; `mvn -q -pl forge-report-server -am -DskipTests compile`; `mvn -q -pl forge-flow/forge-flow-server -am -DskipTests compile`	通过	首次 Maven 使用 JDK 8 失败，改用 OpenJDK 17 后通过；远程/本地 MySQL 均不可用，未做 SQL 实跑和接口 smoke
2026-07-07	Batch 2.1	编译 + XML/SQL 静态检查	`git diff --check`; `rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.3__add_logic_delete_to_platform_internal_tables.sql`; `xmllint --noout ...`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.3 SQL 实跑和接口 smoke
2026-07-07	Batch 2.2	编译 + XML/SQL 静态检查	`git diff --check`; `rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.4__add_logic_delete_to_system_config_tables.sql`; `xmllint --noout ...`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.4 SQL 实跑和接口 smoke
2026-07-07	Batch 2.3a	编译 + XML/SQL 静态检查	`git diff --check`; `rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.5__add_logic_delete_to_org_post_tables.sql`; `xmllint --noout ...`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.5 SQL 实跑和接口 smoke；用户/角色/租户/菜单资源未进入本批
2026-07-07	Batch 2.3b-1	编译 + XML/SQL 静态检查	`git diff --check`; `rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.6__add_logic_delete_to_tenant_table.sql`; `xmllint --noout ...`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.6 SQL 实跑和接口 smoke；用户/角色/菜单资源未进入本批
2026-07-07	Batch 2.3b-2	编译 + XML/SQL 静态检查	`git diff --check`; `rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.7__add_logic_delete_to_role_table.sql`; `xmllint --noout ...`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.7 SQL 实跑和接口 smoke；用户/菜单资源未进入本批
2026-07-07	Batch 2.3b-3	编译 + XML/SQL 静态检查	`git diff --check`; `rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.8__add_logic_delete_to_resource_table.sql`; `xmllint --noout ...`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.8 SQL 实跑和接口 smoke；用户表未进入本批
2026-07-07	Batch 2.3b-4	编译 + XML/SQL 静态检查	`git diff --check`; `rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.9__add_logic_delete_to_user_table.sql`; `xmllint --noout ...`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.9 SQL 实跑和登录/接口 smoke
2026-07-07	Batch 3.1	编译 + XML/SQL 静态检查	`rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.10__add_logic_delete_to_lowcode_design_metadata_tables.sql`; `xmllint --noout ...`; `git diff --check`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.10 SQL 实跑和接口 smoke；数据资产/报表目录/业务样例表未进入本批
2026-07-07	Batch 3.2	编译 + XML/SQL 静态检查	`rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.11__add_logic_delete_to_report_data_metadata_tables.sql`; `xmllint --noout ...`; `git diff --check`; `mvn -q -pl forge-admin-server -am -DskipTests compile`; `mvn -q -pl forge-report-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.11 SQL 实跑和接口 smoke；采购样例业务表未进入本批
2026-07-07	Batch 3.3	编译 + XML/SQL 静态检查	`rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.12__add_logic_delete_to_sample_purchase_order.sql`; `xmllint --noout ...`; `git diff --check`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.12 SQL 实跑和接口 smoke
2026-07-07	Task 4	编译 + XML/SQL 静态检查	`rg -n -i 'delete\\s+from' forge-server -g '*Mapper.xml'`; `rg -n '[ \t]$' ...`; `rg -n '\$\{[^}]+\}' forge-server/db/migration/V1.0.13__add_logic_delete_to_prompt_and_query_scheme_tables.sql`; `xmllint --noout ...`; `git diff --check`; `mvn -q -pl forge-admin-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，未做 V1.0.13 SQL 实跑和接口 smoke；剩余 13 处 `DELETE FROM` 均已分类为保留物理删除
2026-07-07	Task 5	最终收尾验证	`rg -n '\$\{[^}]+\}' V1.0.2..V1.0.13`; `rg -n '[ \t]$' ...`; `git diff --check`; `rg -n -i 'delete\\s+from' forge-server -g '*Mapper.xml'`; `mvn -q -pl forge-admin-server -am -DskipTests compile`; `mvn -q -pl forge-report-server -am -DskipTests compile`; `mvn -q -pl forge-flow/forge-flow-server -am -DskipTests compile`	通过	本地 MySQL 3407 不可用，最终 SQL 实跑和接口 smoke 跳过

6. 执行证据

execution-log.md：记录所有命令和结果。
关键接口：员工删除、报表项目/模板删除、流程节点配置删除。
关键数据库检查：删除前后记录是否保留，删除字段是否置位。
服务启动与停止：如需 API smoke，记录进程和清理情况。