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

7.5 KiB
Raw Blame History

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}
  1. Passed APIs(通过测试的接口)
  • 页面:{页面名}
  • method:xxx.xxx.xxx
  • 请求校验:通过/不通过(说明)
  • 响应校验:通过/不通过(说明)
  • 最终结论:通过
  1. Problem APIs(问题接口)
  • 严重级别:P0/P1/P2
  • 页面:{页面名}
  • method:xxx.xxx.xxx
  • 问题类型:前端问题 / 后端问题 / 文档不一致
  • 现象:{错误码、报错信息、页面表现}
  • 复现步骤:{最短步骤}
  • 期望结果:{按文档或业务预期}
  • 实际结果:{当前表现}
  • 建议处理:{前端/后端/文档修正建议}
  1. API Compliance
  • 参数不一致接口:{数量与列表}
  • 响应不一致接口:{数量与列表}
  • 向后兼容风险:{有/无,说明}
  1. Issue Logs
  • Console Error 摘要
  • 4xx/5xx 请求清单
  • 关联页面与操作路径

6.4 完成判定

满足以下条件才算完成:

  1. 三个页面均已执行测试并有结果记录。
  2. 报告中包含“通过测试的接口”与“问题接口”两个清单。
  3. 每个问题接口均包含可复现步骤与归因分类。
  4. 给出接口维度与页面维度的通过率统计。