测试 Spec — 前端字典来源与设计器枚举整改

status: apply created: 2026-07-27

0. 测试原则

复用当前前端 Vitest/Vite 基线，只做本轮增量验证。
先验证纯函数 Red，再实现 Green；页面改造以构建、Lint 和静态合同为主。
不把未执行的真实 Flyway 或浏览器 E2E 记为通过。
所有命令、结果、警告和跳过项写入 execution-log.md。

1. P0 覆盖

场景	输入	预期
数字字典转换	`value='1'/'0'`	输出 `1/0`，保留标签和样式元数据
布尔字典转换	`value='1'/'0'` 或 `true/false`	输出严格布尔值
协议值映射	`MYSQL` 等字典值	输出生成器当前兼容值，未知值按原值保留
空字典	`null/undefined/[]`	返回空数组，不抛异常
异步 Schema	字典挂载后更新	computed options 随 `dict.value` 更新

2. P1 静态合同

V1.0.54 在本阶段尚未部署，可在首次 Flyway 执行前补齐缺失 seed；一旦进入 forge_schema_history 则禁止继续修改。
sys_dict_type / sys_dict_data INSERT 使用显式列名。
所有 seed 的 tenant_id=1，类型和值分别用 NOT EXISTS 防重复。
sys_req_method=PATCH、flow_process_form_type=business 存在。
Data 脱敏正则在 SQL 中正确转义，静态预期值与前端读取值一致。
目标 AiCrudPage Schema 依赖字典时均为 computed。
目标页面不再声明已迁移的运行时业务 options 数组。
三处标签类型统一从 constants 导入。

3. P1 构建与测试

pnpm vitest run src/utils/__tests__/dict-options.spec.js。
对目标文件运行 ESLint，不执行全仓自动修复。
pnpm build。
git diff --check、SDD 尾随空白和 EOF 检查。

4. P2 部署验证

在隔离 MySQL 8 执行 Flyway，确认 forge_schema_history 中 1.0.54 成功。
查询新增字典类型/数据数量并抽查 dict_value。
清空浏览器缓存，验证目标下拉首次加载、编辑回显、搜索和保存。
验证数字/布尔字段请求体类型、生成器数据库类型兼容值、流程 business 表单和触发器 JSON 值。

5. 历史验证基线

时间	范围	结果	备注
2026-07-27	当前前端测试框架盘点	Vitest 2.1.9，已有多模块组件/工具测试	未在 Proposal 阶段运行全量测试

6. 本轮增量验证

时间	变更范围	实际命令	结果	跳过/警告
2026-07-27	字典转换工具	`pnpm vitest run src/utils/__tests__/dict-options.spec.js`	Review 修复后 5/5 passed	新增字典未加载时保留持久化值合同
2026-07-27	22 个目标 JS/Vue 文件	`pnpm exec eslint <目标文件>`	exit 0，零问题	未对全仓执行自动修复
2026-07-27	Flyway 与硬编码合同	版本、placeholder、`NOT EXISTS`、租户、关键值、正则和目标 options `rg` 扫描	passed	剩余 options 为动态数据源、顶级资源占位及 `dictData` 页面本地控件
2026-07-27	前端生产构建	`NODE_OPTIONS=--max-old-space-size=8192 pnpm build`	passed	存在既有组件命名、CSS 注释和 chunk 警告，不阻断构建
2026-07-27	第三轮 Review 修复	Vitest、22 个目标文件 ESLint、生产构建	passed：5/5、ESLint exit 0、8727 modules	入口模式/应用模式不再使用硬编码业务选项 fallback；既有构建警告不阻断
2026-07-27	第四轮 Review 修复	Vitest、22 个目标文件 ESLint、Flyway seed/placeholder 静态检查、生产构建	passed：6/6、ESLint exit 0、placeholder 无输出、8727 modules	补齐应用模式字典及五处状态回显；既有构建警告不阻断
2026-07-27	第五轮 Review 修复	Vitest、`dataset.vue`/测试 ESLint、生产构建	passed：9/9、ESLint exit 0、8727 modules	覆盖数字发布状态、无硬编码 fallback、分类状态字典和详情 hydration；既有构建警告不阻断
2026-07-27	第六轮 Review 修复	Vitest、`dataset.vue`/测试 ESLint、生产构建	passed：10/10、ESLint exit 0、8727 modules	列表类型标签消费 `data_dataset_type` 字典元数据；既有构建警告不阻断
2026-07-27	Code Quality 最终修复	`pnpm vitest run src/utils/__tests__/dict-options.spec.js`；Flyway/SDD/格式静态检查	passed：11/11；静态检查通过	补齐 `ai_business_app_entry_mode` 及六个协议值；按用户要求不重跑 build/E2E
待部署	P2 真实环境	MySQL/Flyway、字典 API、浏览器加载/回显/保存	not run	部署门禁，不计为通过

7. 执行证据

自动化和静态检查：execution-log.md。
数据迁移：本地仅静态检查，真实结果待部署环境。
服务启动与停止：本阶段默认不启动后端服务；如启动前端预览，必须记录端口和停止状态。

8. 第四轮 Spec Review 增量合同

V1.0.54 必须同时声明 ai_business_app_mode 类型及 DYNAMIC_RENDER、CODE_DOWNLOAD 两个值，且保持 tenant_id=1 和 NOT EXISTS。
system/menu.vue、app-center/trigger.vue、data/dataset.vue、external/manage.vue、system/config-center.vue 的目标业务状态回显必须消费字典元数据。
Vitest 必须证明依赖异步字典的 computed options 在字典到达后从空数组更新为转换后的值。

9. 第五轮 Spec Review 增量合同

data_dataset_publish_status 搜索选项必须通过 toNumberDictOptions 保持后端 Integer 协议。
发布状态、访问模式和数据集类型未知值不得伪装成默认业务标签；分类停用标签必须消费 sys_enable_disable。
beforeRenderDetail 必须先等待 ensureRowScopeDictOptions()，再调用 prepareDatasetFormData 组装旧字段格式的 ruleItems。

10. 第六轮 Spec Review 增量合同

数据集列表类型标签必须使用 DictTag，并传入 datasetTypeOptions.value 和 row.datasetType。
tableColumns 区段不得恢复按 TABLE 硬编码“单表/SQL”标签和样式的三元表达式。

11. Code Quality 最终增量合同

V1.0.54 必须声明 ai_business_app_entry_mode 类型。
该类型必须完整种入 RUNTIME、ROUTE、IFRAME、EXTERNAL、H5、API 六个现存协议值。
Vitest 直接检查迁移源码，防止后续删除类型或任一协议值。