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