2026-05-09 18:18:05 +08:00

168 lines
7.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# WMS 自动化测试工作流(Agent 自动执行工作流)
当用户输入 `测试[目标页面]`,Agent 必须全自动执行本流程,完成目标页面各功能的测试并输出测试报告,无需用户干预。
专项触发词:当用户输入 `测试波次管理`,Agent 必须自动执行“波次管理专项测试”(见下文第六节),覆盖 `团购波次`、`散单波次`、`拣货中任务` 三个页面。
## 一、 测试上下文基准 (Context Baseline)
项目类型: 基于 Vue3 + Vite + TypeScript 的 WMS 前端系统。
路由模式: 动态路由。
说明:此工作流仅对项目进行测试并根据测试结果输出测试报告,不涉及任何针对项目代码的修改。禁止任何对项目代码的修改操作。
目的:测试接口后端是否可用、前端对接口的使用是否有问题、通过测试排查出请求/响应有更新但前端未更新的接口功能等。
依赖参考
- 前端 API 目录:`src/api`
- 前端 公共组件目录:`src/components`
- 前端 路由目录:`src/router`
- 前端 页面框架目录:`src/layout`
- 前端 页面目录:`src/views`
- 前端 状态管理目录:`src/stores`
- 前端 组合式逻辑目录:`src/composables`
- 前端 工具方法目录:`src/utils`
- 前端 语言包目录:`src/lang`
- 后端 接口文档:`workflows/api-doc-system/data/module`
波次管理关键文件(测试优先参考):
- 波次 API:`src/api/order.wave/orderwave.ts`
- 团购波次:`src/views/order/waveOrder/GroupWaveBatchListPanel.vue`
- 散单波次:`src/views/order/waveOrder/SandanWaveBatchListPanel.vue`
- 拣货中任务:`src/views/order/waveOrder/WavePickTaskListPanel.vue`
- 波次配置:`src/views/order/waveOrder/config/wave-config.ts`
页面/标签页基础结构:
- 主入口一般为 `index.vue` 或标签页组件(如 `GroupWaveBatchListPanel.vue`、`SandanWaveBatchListPanel.vue`、`WavePickTaskListPanel.vue`)。
- `config` 配置文件管理 `scan-box` 筛选条件、`upper-table` 列配置及工具栏按钮。
## 二、 环境引导 (Environment Setup)
前置条件:
确认本地开发服务器已运行 (npm run dev)。
访问规则:
基准路径:http://localhost:5174
登录账号:
"username": "yjm",
"password": "111111"
## 三、 测试任务定义 (Task Definition)
路径导航: 按照路由表进入目标页面。
UI 完整性检查: 验证核心按钮(如“入库确认”、“打印标签”)是否按权限加载。
基础数据显示:检查目标页面upper-table是否有正常获取数据并显示,表格哪些状态字段数据显示为英文而不是翻译字段(如"订单状态"显示'pedding'而不是'待审核')。
筛选条件测试:测试各筛选条件能否正常使用获取符合筛选条件的数据,将不可用或筛选结果包含非筛选条件数据的问题筛选进行记录。
- 功能测试: 根据页面按钮和接口信息分别测试页面各功能。
1、请求测试:发起请求后,根据接口文档检查该功能请求的传参是否符合接口文档的要求。
2、后端功能测试:根据响应结果判断后端该接口服务是否可用,区分后端接口不可用与前端请求传参错误导致的失败。
3、根据接口设计,刷新页面或刷新相关数据表单,查看功能是否被应用/添加。
4、检查项目是否符合接口响应设计,统计项目响应设计与接口响应数据、设计有不符的接口。
异常捕获: 记录 Console Error 或 4xx/5xx 错误。
## 四、 断言与逻辑校验 (Assertions)
视觉断言: 提交后是否出现 ElMessage.success 或预期的跳转。
业务断言: 操作后页面状态(如单据状态位)是否发生预期更新。
## 五、 报告生成标准 (Reporting Specification)
规定测试结果的输出格式。
报告标题: [TEST_REPORT] - {模块名} - {时间}
核心板块:
Test Summary: 成功/失败总览。
API Compliance: 实际请求与接口文档的匹配程度(字段缺失、类型错误等)。
Issue Logs: 发现的 Bug 描述及复现建议。
最小必填字段:
- 通过测试的接口:按页面分组列出 `method`、请求摘要、通过结论。
- 问题接口:按严重级别列出 `method`、失败类型(前端参数/后端异常/文档不一致/响应兼容问题)、证据摘要。
- 页面功能通过率:页面维度统计(通过项 / 总项)。
- 复现步骤:问题接口对应的最短复现路径。
- 修复建议:对前端或后端的最小改动建议。
---
## 六、 波次管理专项测试(触发词:`测试波次管理`)
### 6.1 执行目标(必须全量覆盖)
当输入 `测试波次管理` 时,默认目标页面固定为:
1. 团购波次(`GroupWaveBatchListPanel`)
2. 散单波次(`SandanWaveBatchListPanel`)
3. 拣货中任务(`WavePickTaskListPanel`)
### 6.2 自动执行步骤(严格顺序)
1. 启动前检查:
- 确认本地服务可访问(`http://localhost:5174`)。
- 使用文档中的账号完成登录。
2. 逐页面执行测试(按“团购波次 -> 散单波次 -> 拣货中任务”顺序):
- 页面加载:检查首屏渲染、表格数据加载、分页是否可用。
- 筛选能力:至少验证 3 类筛选(文本、枚举、数值区间)并校验结果一致性。
- 核心功能按钮:逐个触发并记录调用接口、请求参数、响应状态与页面回显。
- 异常链路:对可预期异常场景(空选择、非法条件、任务未完成)进行校验。
3. 接口核对:
- 以 `src/api/order.wave/orderwave.ts` 的接口封装为基准,映射本次实际触发接口。
- 对照接口文档检查参数与响应结构兼容性。
4. 归因分类:
- 前端问题:参数拼装错误、字段名不匹配、状态映射错误、UI 未按响应更新。
- 后端问题:5xx、业务报错、返回结构缺失或类型不符合约定。
- 文档问题:接口文档与实际行为不一致。
5. 输出报告:
- 必须输出“通过测试的接口”和“问题接口”两大清单(见 6.3)。
### 6.3 波次管理报告模板(必须使用)
报告标题:
`[TEST_REPORT] - 波次管理 - {YYYY-MM-DD HH:mm:ss}`
1) Test Summary
- 页面覆盖:团购波次 / 散单波次 / 拣货中任务(3/3)
- 功能点通过率:{passed}/{total}
- 接口通过率:{api_passed}/{api_total}
2) Passed APIs(通过测试的接口)
- 页面:{页面名}
- method:`xxx.xxx.xxx`
- 请求校验:通过/不通过(说明)
- 响应校验:通过/不通过(说明)
- 最终结论:通过
3) Problem APIs(问题接口)
- 严重级别:P0/P1/P2
- 页面:{页面名}
- method:`xxx.xxx.xxx`
- 问题类型:前端问题 / 后端问题 / 文档不一致
- 现象:{错误码、报错信息、页面表现}
- 复现步骤:{最短步骤}
- 期望结果:{按文档或业务预期}
- 实际结果:{当前表现}
- 建议处理:{前端/后端/文档修正建议}
4) API Compliance
- 参数不一致接口:{数量与列表}
- 响应不一致接口:{数量与列表}
- 向后兼容风险:{有/无,说明}
5) Issue Logs
- Console Error 摘要
- 4xx/5xx 请求清单
- 关联页面与操作路径
### 6.4 完成判定
满足以下条件才算完成:
1. 三个页面均已执行测试并有结果记录。
2. 报告中包含“通过测试的接口”与“问题接口”两个清单。
3. 每个问题接口均包含可复现步骤与归因分类。
4. 给出接口维度与页面维度的通过率统计。