单测 Spec — AiCrudPage 表格增强与通用展开面板

status: propose created: 2026-06-27

0. 测试原则

Red/Green TDD：新增核心纯函数测试时先确认失败再实现。
First Run the Tests：开始实现前先跑前端现有可用检查，确认基线。
展示工作：执行后把命令、结果、警告、跳过项追加到 execution-log.md。
增量复用：开始 /test、阶段验证或归档前验收前，先读取 code-copilot/rules/automated-testing-standard.md 和本变更已有文档。

1. 测试框架

项目	值
前端框架	Vue 3 + Vite
组件库	Naive UI
包管理	pnpm，执行前使用 Node v20.19.0
单测框架	待按项目现有配置确认
E2E	可复用 pc-e2e-tester / Playwright 验证运行态页面

2. 覆盖范围

P0 — 核心配置与数据加载（必须覆盖）

模块: `expand-utils.js`

方法	场景	输入	预期结果
`buildExpandParams`	从当前行映射参数	`paramsMap={orderId:'row.id'}`，`row.id=1`	输出 `{orderId:1}`
`buildExpandParams`	支持多 source	`row/query/params/user`	正确取值，不存在时返回空或默认值
`extractExpandData`	records 包裹	响应 `{data:{records:[]}}`	输出 records
`normalizeExpandConfig`	单 panel	传入单个 table 配置	归一化为 `panels[]`
`normalizeExpandConfig`	未启用	`enabled=false` 或空配置	不渲染展开列

P1 — 组件渲染

组件	场景	预期
`AiTable`	开启 `resizable`	表头可拖拽调整列宽
`AiCrudRowExpand`	首次展开	显示 loading，请求成功后渲染内容
`AiCrudRowExpand`	请求失败	展示错误和重试入口
`ExpandTablePanel`	子表数据	渲染内嵌表格，默认无工具栏
`ExpandDescriptionsPanel`	描述字段	按配置列数展示字段
`ExpandTabsPanel`	多面板	Tab 切换不重复请求已缓存面板

P2 — 入口层/设计器

场景	预期
设计器新增展开面板	选择子表后自动生成 table panel
设计器配置描述面板	选择字段后生成 descriptions panel
运行态预览	`expandConfig` 被完整透传
未配置展开	老页面表格行为不变

不测试（明确列出原因）

后端数据权限逻辑：展开数据源复用已有接口，后端权限由已有机制保障。
子表编辑：第一期展开面板建议只读，编辑仍由详情/编辑弹窗里的 ChildTableEditor 负责。

3. 执行计划

Step 1: 读取 automated-testing-standard.md 和当前变更文档。
Step 2: 运行 pnpm --dir forge-admin-ui build 确认前端构建。
Step 3: 若项目有前端单测框架，补 expand-utils 单测并确认 Red/Green。
Step 4: 启动前端页面，使用 E2E/手工验证表格展开、子表、描述、Tabs、列宽拖拽。
Step 5: 追加 execution-log.md，记录命令、结果、跳过项和服务清理。

4. 历史验证基线

时间	范围	命令	结果	备注
2026-06-27	方案阶段	未执行	跳过	本轮只记录方案，不改运行代码。

5. 本轮增量验证

时间	变更范围	必跑项	实际命令	结果	跳过/警告
2026-06-27	文档方案	文档落盘检查	`sed -n` 检查新增文档；`git status --short` 检查变更状态	通过	未进入实现阶段，未运行构建或测试。
2026-06-27	运行态展开实现	目标文件 ESLint	`pnpm --dir forge-admin-ui exec eslint ...`	通过	`AiTable.vue` 保留既有 `vue/no-required-prop-with-default` warning。
2026-06-27	前端整体构建	Vite build	`pnpm --dir forge-admin-ui build`	通过	有既有 CSS `//` 注释 warning、store 动静态导入 warning；新增 nested tabs 动态导入提示，不阻断构建。
2026-06-27	列表/表单设计器配置入口	目标文件 ESLint	`pnpm --dir forge-admin-ui exec eslint ...ListPageGridDesigner.vue ...ForgePropertyPanel.vue ...`	通过	`AiTable.vue` 既有 warning；`ListPageGridDesigner.vue` 保留既有单行按钮换行 warning。
2026-06-27	设计器入口整体验证	Vite build	`pnpm --dir forge-admin-ui build`	通过	CSS `//` 注释、store 动静态导入、ExpandPanelRenderer chunk 提示均不阻断构建。

6. 执行证据

execution-log.md：code-copilot/changes/ai-crud-table-expand-enhancement/execution-log.md
关键接口：复用各业务子表/详情接口，按实现阶段补充。
关键数据库检查：无数据库变更。
服务启动与停止：实现阶段按实际记录。