test-spec.md 4.8 KB
单测 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- 关键接口：复用各业务子表/详情接口，按实现阶段补充。
- 关键数据库检查：无数据库变更。
- 服务启动与停止：实现阶段按实际记录。