168 lines
7.5 KiB
Markdown
168 lines
7.5 KiB
Markdown
# 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. 给出接口维度与页面维度的通过率统计。 |