单测 Spec — 编码规则易混淆字符独立选择

status: done created: 2026-07-18

0. 测试原则

复用归档变更“编码规则配置优化”的 31/31 Generator、14/14 前端和 8691 modules 构建基线。
先补本轮字符集合契约测试并确认 Red，再实现 Green。
不启动 Admin/MySQL/Redis，不修改本地数据库；真实 Flyway/HTTP 由可用环境补充。

1. 测试框架

项目	值
后端	JUnit 5；Maven `enable-tests` profile
前端	Vitest；Node v20.19.0
静态	ESLint、xmllint、Flyway placeholder、git diff check

2. 覆盖范围

P0 — 核心业务逻辑

类/模块	场景	输入	预期结果
`CodeRuleRadixCodec`	单独排除 I	`I`	字母表无 I，仍含 O/Z
`CodeRuleRadixCodec`	排除 O/Z	`O,Z`	字母表无 O/Z，仍含 I
`CodeRuleRadixCodec`	小写进制	`I`	移除 i，不移除 o/z
`CodeRuleRadixCodec`	旧开关	新字段空、旧值 1	等价 I/O/Z 全选
`CodeRuleEngine`	容量与编码	具体字符组合	步长、最大值和编码使用同一字母表

P1 — 数据访问层

Mapper XML 读写 excluded_characters。
V1.0.39 先防重补列，再回填历史 exclude_ambiguous=1。

P2 — 前端

字符集合规范化支持单选、组合、重复/非法字符过滤和旧开关全选。
进制切换不清空已选字符。
页面存在 I、O、Z 三个独立复选项，不再使用总开关。

不测试

不执行真实数据库迁移和登录态浏览器验收；本轮不启动服务且遵循既定联调分工。

3. 执行计划

Step 1：新增前后端测试并确认 Red。
Step 2：实现协议、迁移和引擎后确认 Green。
Step 3：完成前端选择交互，执行 Vitest 与定向 ESLint。
Step 4：执行 Generator 回归、前端 build、Admin 聚合编译和静态检查。

4. 历史验证基线

时间	范围	命令	结果	备注
2026-07-17	Generator 编码规则	八个编码规则相关测试类	passed，31/31	归档变更最终基线
2026-07-17	前端	Vitest + ESLint + build	passed，14/14；0 errors；8691 modules	归档变更最终基线
2026-07-17	Admin reactor	compile -DskipTests	passed，42/42	Java 17

5. 本轮增量验证

时间	变更范围	必跑项	实际命令	结果	跳过/警告
2026-07-18	字符集合纯函数	Vitest	`pnpm exec vitest run src/views/app-center/__tests__/code-rule-utils.spec.js`	passed，18/18	Red 阶段 2 项按预期失败
2026-07-18	编码规则后端	JUnit	八个编码规则相关测试类	passed，36/36	0 failure/error/skip；含旧总开关与新全选字段的服务层等价性
2026-07-18	相关前端文件	ESLint	五个编码规则 JS/Vue 文件	passed，0 errors	首轮发现 3 个导入排序错误后修正
2026-07-18	生产前端	Vite build	`pnpm build`	passed，8691 modules	仅仓库既有非阻断警告
2026-07-18	Admin 聚合	Maven compile	`mvn -pl forge-admin-server -am compile -DskipTests`	passed，42/42	Java 17
2026-07-18	页面交互	Playwright Chromium	登录、打开新增工作台、展开 SEQ、点击 I/Z	passed	labels=I/O/Z；checked=true/false/true；console 0 errors
2026-07-18	XML/Flyway/差异	静态检查	xmllint、placeholder、diff check	passed	新文件另做 no-index check

6. 执行证据

execution-log.md：同目录追加实际命令与关键输出。
关键数据库检查：Flyway 静态契约；真实迁移由用户环境补验。
服务启动与停止：临时 Vite :3000 已停止并确认端口释放；:8580 为用户原有后端，未停止。