7.5 KiB
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 执行目标(必须全量覆盖)
当输入 测试波次管理 时,默认目标页面固定为:
- 团购波次(
GroupWaveBatchListPanel) - 散单波次(
SandanWaveBatchListPanel) - 拣货中任务(
WavePickTaskListPanel)
6.2 自动执行步骤(严格顺序)
- 启动前检查:
- 确认本地服务可访问(
http://localhost:5174)。 - 使用文档中的账号完成登录。
- 确认本地服务可访问(
- 逐页面执行测试(按“团购波次 -> 散单波次 -> 拣货中任务”顺序):
- 页面加载:检查首屏渲染、表格数据加载、分页是否可用。
- 筛选能力:至少验证 3 类筛选(文本、枚举、数值区间)并校验结果一致性。
- 核心功能按钮:逐个触发并记录调用接口、请求参数、响应状态与页面回显。
- 异常链路:对可预期异常场景(空选择、非法条件、任务未完成)进行校验。
- 接口核对:
- 以
src/api/order.wave/orderwave.ts的接口封装为基准,映射本次实际触发接口。 - 对照接口文档检查参数与响应结构兼容性。
- 以
- 归因分类:
- 前端问题:参数拼装错误、字段名不匹配、状态映射错误、UI 未按响应更新。
- 后端问题:5xx、业务报错、返回结构缺失或类型不符合约定。
- 文档问题:接口文档与实际行为不一致。
- 输出报告:
- 必须输出“通过测试的接口”和“问题接口”两大清单(见 6.3)。
6.3 波次管理报告模板(必须使用)
报告标题:
[TEST_REPORT] - 波次管理 - {YYYY-MM-DD HH:mm:ss}
- Test Summary
- 页面覆盖:团购波次 / 散单波次 / 拣货中任务(3/3)
- 功能点通过率:{passed}/{total}
- 接口通过率:{api_passed}/{api_total}
- Passed APIs(通过测试的接口)
- 页面:{页面名}
- method:
xxx.xxx.xxx - 请求校验:通过/不通过(说明)
- 响应校验:通过/不通过(说明)
- 最终结论:通过
- Problem APIs(问题接口)
- 严重级别:P0/P1/P2
- 页面:{页面名}
- method:
xxx.xxx.xxx - 问题类型:前端问题 / 后端问题 / 文档不一致
- 现象:{错误码、报错信息、页面表现}
- 复现步骤:{最短步骤}
- 期望结果:{按文档或业务预期}
- 实际结果:{当前表现}
- 建议处理:{前端/后端/文档修正建议}
- API Compliance
- 参数不一致接口:{数量与列表}
- 响应不一致接口:{数量与列表}
- 向后兼容风险:{有/无,说明}
- Issue Logs
- Console Error 摘要
- 4xx/5xx 请求清单
- 关联页面与操作路径
6.4 完成判定
满足以下条件才算完成:
- 三个页面均已执行测试并有结果记录。
- 报告中包含“通过测试的接口”与“问题接口”两个清单。
- 每个问题接口均包含可复现步骤与归因分类。
- 给出接口维度与页面维度的通过率统计。