sheng/mes-ui-d2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3f546564ccb78121bae122f978bc946a221eea65
mes-ui-d2/docs/测试文档-工艺流程.md
sheng 3f546564cc
Some checks failed
Release pipeline / publish (push) Has been cancelled
Details
Release pipeline / Always run job (push) Has been cancelled
Details
feat(production-master-data): 新增工艺流程管理完整模块 
- 添加工艺流程、流程卡工序的全套CRUD及复制接口
- 新增工艺流程列表页与流程卡详情页的路由和页面组件
- 补充产品、工序分类、工序子类的全量查询接口
- 优化弹窗表单组件，支持字段禁用与focus/blur/change事件回调
- 修复工序单元页面的国际化调用和权限配置问题
- 补充中英文多语言国际化文案
- 新增该模块的功能测试文档
2026-06-04 17:07:15 +08:00

20 KiB
Raw Blame History

功能测试文档 — 工艺流程 (Process Routing)

模块路径：生产配置 → 工艺模型 → 工艺流程
路由：/production_configuration/technology_model/technology_flow
API BASE：production_configuration/technology_model/technology_flow/
i18n 前缀：page.production_master_data.process_model.process_routing
文档版本：v1.0
适用代码版本：基于 process-routing/index.vue
测试目标：验证工艺流程页面的列表、查询、新增、编辑、删除、流程卡管理入口等核心操作

0. 文档使用说明

  • 测试人员按顺序执行 T-XX 编号的测试用例
  • 每个用例的 预期结果 描述必须与实际界面/接口响应一致才可标记为通过
  • 失败的用例在 问题描述 列填写具体错误信息、截图编号、操作环境
  • 所有"实际结果"必须如实记录，禁止空填或留白
  • 整体测试结论位于文末 测试总结 处

1. 测试环境配置要求

项目 要求
操作系统 Windows 10 / 11 64-bit
Node.js 18.16.0（与项目 .node-version / package.json#engines 一致）
包管理器 pnpm 10.33.0（与 package.json#packageManager 一致）
浏览器 Chrome 100+ / Edge 100+
后端服务 Webman 后端已启动且数据库已初始化
数据库 工艺流程、流程类别、产品、权限等基础数据已存在
启动命令 pnpm install → pnpm dev，访问 http://localhost:8080
测试账号 具备「生产配置-工艺模型-工艺流程」读写权限的账号
浏览器语言 中英文均需验证（默认以中文为准）

2. 测试前置条件

  1. 已使用具备 production_configuration/technology_model/technology_flow 下 create / edit / delete 权限的账号登录
  2. 流程类别 至少存在 1 条数据（否则新增时的「流程类别」下拉为空）
  3. 产品列表 至少存在 1 条数据（否则新增时的「关联产品」下拉为空）
  4. 浏览器开发者工具 Network 面板可正常观察接口请求
  5. 已确认 src/locales/zh-chs.json 与 src/locales/en.json 中存在 page.production_master_data.process_model.process_routing 节点

3. 测试用例

3.1 列表与查询

T-01：页面正常加载

  • 操作步骤
    1. 登录系统
    2. 进入「生产配置 → 工艺模型 → 工艺流程」
  • 预期结果
    • URL 跳转到 /production_configuration/technology_model/technology_flow
    • 页面顶部展示搜索区（编码、名称、查询、重置）
    • 下方展示表格列：序号 / 工艺流程编码 / 工艺流程名称 / 流程类别 / 关联产品 / 版本 / 状态 / 备注 / 操作
    • 工具栏右上角显示帮助按钮，鼠标悬停提示「工艺流程用于设置生产工艺流程并管理流程卡…」
    • 控制台无报错
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-02：默认分页加载列表

  • 操作步骤
    1. 访问工艺流程页面
  • 预期结果
    • 列表自动加载（无需手动点击查询）
    • 加载时表格显示 loading 遮罩
    • 加载完成显示数据行（如有数据）
    • 分页组件显示「共 X 条」并按 10 条/页 显示
    • 发起请求 GET production_configuration/technology_model/technology_flow/list?method=production_master_data_process_model_process_routing_list&page_no=1&page_size=10&code=&name=
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-03：按编码精确搜索

  • 操作步骤
    1. 在「工艺流程编码」输入框输入已存在的完整编码
    2. 点击「查询」按钮
  • 预期结果
    • 列表仅展示编码完全匹配的数据行
    • 列表刷新到第 1 页
    • 接口请求参数 code=<已输入值>
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-04：按名称模糊搜索

  • 操作步骤
    1. 在「工艺流程名称」输入框输入名称片段
    2. 点击「查询」按钮
  • 预期结果
    • 列表仅展示名称包含该片段的数据行
    • 接口请求参数 name=<已输入值>
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-05：按回车键触发查询

  • 操作步骤
    1. 在「工艺流程编码」或「工艺流程名称」输入框聚焦
    2. 输入关键字后按键盘 Enter
  • 预期结果
    • 等同于点击「查询」按钮，触发列表刷新
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-06：重置搜索条件

  • 操作步骤
    1. 在搜索框输入任意条件并点击「查询」
    2. 点击「重置」按钮
  • 预期结果
    • 两个搜索输入框被清空
    • 列表自动以空条件重新加载
    • 页码回到第 1 页
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-07：分页切换

  • 操作步骤
    1. 准备超过 10 条工艺流程数据
    2. 在分页器中切换到第 2 页或修改每页条数
  • 预期结果
    • 列表按新页码 / 每页条数重新加载
    • 接口请求参数 page_no / page_size 与界面一致
    • 分页总数保持正确
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-08：空数据展示

  • 操作步骤
    1. 在没有任何工艺流程数据时访问页面，或筛选一个不存在的数据
  • 预期结果
    • 表格区域显示 Element UI 空数据占位（无红色错误）
    • 分页器显示「共 0 条」
    • 不会弹出错误提示
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-09：i18n 中文切换

  • 操作步骤
    1. 在用户设置中切换语言到「简体中文」
    2. 访问工艺流程页面
  • 预期结果
    • 所有表头、按钮、提示文本为中文（"工艺流程编码"、"新增"、"删除"等）
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-10：i18n 英文切换

  • 操作步骤
    1. 切换语言到「English」
    2. 访问工艺流程页面
  • 预期结果
    • 所有表头、按钮、提示文本为英文（"Routing Code"、"Add"、"Delete" 等）
    • 切换瞬间不需要刷新页面即生效
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

3.2 新增

T-11：打开新增弹窗

  • 操作步骤
    1. 点击工具栏的「新增」按钮
  • 预期结果
    • 弹出标题为「新增工艺流程」的对话框（宽 40%）
    • 表单为空且编码字段可编辑
    • 默认值：版本 = 1.0、状态 = 启用
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-12：新增必填校验 — 编码

  • 操作步骤
    1. 打开新增弹窗
    2. 编码留空，其它字段填写完整
    3. 点击「确定」
  • 预期结果
    • 编码输入框下方红色提示「请输入工艺流程编码」
    • 接口未发起，弹窗保持打开
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-13：新增必填校验 — 名称

  • 操作步骤
    1. 打开新增弹窗
    2. 名称留空，其它字段填写完整
    3. 点击「确定」
  • 预期结果
    • 名称输入框下方红色提示「请输入工艺流程名称」
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-14：新增必填校验 — 流程类别

  • 操作步骤
    1. 打开新增弹窗
    2. 不选择「流程类别」
    3. 点击「确定」
  • 预期结果
    • 流程类别下拉框下方红色提示「请选择流程类别」
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-15：新增必填校验 — 版本

  • 操作步骤
    1. 打开新增弹窗
    2. 清空「版本」（默认 1.0）
    3. 点击「确定」
  • 预期结果
    • 版本输入框下方红色提示「请输入版本号」
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-16：新增字段长度校验

  • 操作步骤
    1. 打开新增弹窗
    2. 在「编码」输入超过 100 个字符
    3. 点击「确定」
  • 预期结果
    • 编码输入框下方红色提示「长度在 1 到 100 个字符」
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-17：新增成功

  • 操作步骤
    1. 打开新增弹窗
    2. 填写完整有效数据：编码、名称、流程类别、关联产品、版本、状态、备注
    3. 点击「确定」
  • 预期结果
    • 接口请求 POST production_configuration/technology_model/technology_flow/create 状态码 200，code=0
    • 页面弹出绿色提示「操作成功」
    • 弹窗自动关闭
    • 列表自动刷新，新数据展示在表格中
    • 页码回到第 1 页
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-18：新增重复编码

  • 操作步骤
    1. 准备一个已存在的编码
    2. 在新增弹窗中输入相同编码
    3. 点击「确定」
  • 预期结果
    • 后端返回业务错误
    • 页面弹出红色错误提示（如「编码已存在」）
    • 弹窗保持打开，用户可修改后重试
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-19：取消新增

  • 操作步骤
    1. 打开新增弹窗，填写部分数据
    2. 点击「取消」按钮或右上角 X
  • 预期结果
    • 弹窗关闭
    • 不发起任何接口请求
    • 再次打开新增弹窗，表单恢复为空（默认值除外）
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-20：新增提交中重复点击防护

  • 操作步骤
    1. 打开新增弹窗，填写有效数据
    2. 连续快速点击「确定」两次
  • 预期结果
    • 第一次点击后按钮进入 loading 状态，禁用重复提交
    • 接口仅被调用 1 次
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

3.3 编辑

T-21：打开编辑弹窗

  • 操作步骤
    1. 在列表中点击某行的「编辑」按钮
  • 预期结果
    • 弹出标题为「编辑工艺流程」的对话框
    • 表单自动回填该行数据
    • 「编码」字段为禁用状态（不可编辑）
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-22：编辑必填校验

  • 操作步骤
    1. 打开编辑弹窗
    2. 清空「名称」
    3. 点击「确定」
  • 预期结果
    • 名称输入框下方红色提示「请输入工艺流程名称」
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-23：编辑成功

  • 操作步骤
    1. 打开编辑弹窗
    2. 修改名称、流程类别、版本、状态、备注等字段
    3. 点击「确定」
  • 预期结果
    • 接口请求 PUT production_configuration/technology_model/technology_flow/edit 状态码 200，code=0
    • 页面弹出绿色提示「操作成功」
    • 弹窗关闭
    • 列表自动刷新，目标行显示新值
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-24：编辑时编码不可修改

  • 操作步骤
    1. 打开编辑弹窗
    2. 尝试修改「编码」字段
  • 预期结果
    • 编码字段处于禁用状态，无法输入
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-25：取消编辑

  • 操作步骤
    1. 打开编辑弹窗，修改若干字段
    2. 点击「取消」按钮
  • 预期结果
    • 弹窗关闭
    • 不发起任何接口请求
    • 列表数据保持原样
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

3.4 删除

T-26：删除二次确认弹窗

  • 操作步骤
    1. 点击某行的「删除」按钮
  • 预期结果
    • 弹出警告提示「确定要删除该工艺流程吗?」
    • 提示框有「确定」与「取消」两个按钮
    • 列表中的该行仍存在
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-27：删除 — 取消

  • 操作步骤
    1. 点击「删除」按钮
    2. 在确认弹窗中点击「取消」
  • 预期结果
    • 弹窗关闭
    • 不发起删除接口
    • 数据行保持原样
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-28：删除成功

  • 操作步骤
    1. 点击「删除」按钮
    2. 在确认弹窗中点击「确定」
  • 预期结果
    • 接口请求 DELETE production_configuration/technology_model/technology_flow/delete 状态码 200，code=0
    • 页面弹出绿色提示「操作成功」
    • 列表自动刷新，目标行消失
    • 删除当前页最后一行时，自动跳转到合理页码
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-29：删除 — 关联数据拒绝

  • 操作步骤
    1. 准备一条已被产品、批次或其它模块引用的工艺流程
    2. 尝试删除
  • 预期结果
    • 后端返回业务错误
    • 页面弹出红色错误提示（如「该工艺流程已被引用，不可删除」）
    • 列表数据保持原样
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

3.5 流程卡管理入口

T-30：流程卡管理按钮存在

  • 操作步骤
    1. 在列表中查看任意一行的操作列
  • 预期结果
    • 操作列包含「编辑」、「流程卡管理」、「删除」3 个按钮
    • 「流程卡管理」按钮为黄色文字 + el-icon-tickets 图标
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-31：点击流程卡管理

  • 操作步骤
    1. 点击某行的「流程卡管理」按钮
  • 预期结果
    • 当前阶段：弹出信息提示「流程卡管理: <工艺流程名称>」（占位实现）
    • 后续阶段：应打开独立的流程卡管理抽屉 / 弹窗
    • 不影响列表状态
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

3.6 权限控制

T-32：无「新增」权限

  • 操作步骤
    1. 使用无 /production_configuration/technology_model/technology_flow/create 权限的账号登录
    2. 访问工艺流程页面
  • 预期结果
    • 工具栏不显示「新增」按钮
    • 列表正常加载
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-33：无「编辑」权限

  • 操作步骤
    1. 使用无 …/edit 权限的账号登录
    2. 访问工艺流程页面
  • 预期结果
    • 行内「编辑」按钮不显示
    • 「新增」与「删除」按钮仍可正常显示（按权限配置）
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-34：无「删除」权限

  • 操作步骤
    1. 使用无 …/delete 权限的账号登录
    2. 访问工艺流程页面
  • 预期结果
    • 行内「删除」按钮不显示
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-35：未登录访问

  • 操作步骤
    1. 退出登录后，直接在地址栏访问 /production_configuration/technology_model/technology_flow
  • 预期结果
    • 自动跳转到登录页
    • 不会出现 404 或白屏
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

3.7 错误处理

T-36：网络异常

  • 操作步骤
    1. 在浏览器开发者工具 Network 面板中，离线（Offline）
    2. 刷新工艺流程页面
  • 预期结果
    • 页面顶部红色错误提示（如「请求超时」或「网络异常」）
    • loading 状态关闭
    • 表格维持之前的数据或显示空数据
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-37：后端 500 错误

  • 操作步骤
    1. 模拟后端列表接口返回 500
    2. 刷新工艺流程页面
  • 预期结果
    • 拦截器统一弹出红色错误提示
    • 表格显示空数据
    • 控制台无未捕获异常
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

T-38：参数缺失

  • 操作步骤
    1. 模拟后端创建接口缺参返回 code=500
    2. 在新增弹窗点击「确定」
  • 预期结果
    • 拦截器弹出后端返回的错误信息
    • 弹窗不关闭
    • 表单数据保持原样
  • 实际结果：__________
  • 测试状态：☐ 通过 ☐ 失败
  • 问题描述：__________

4. 测试总结

维度 统计
用例总数 38
通过数 __________
失败数 __________
阻塞数 __________
跳过数 __________
整体结论 ☐ 通过 ☐ 有条件通过 ☐ 不通过

4.1 遗留问题清单

编号 用例编号 严重程度 描述 负责人 计划修复日期
1
2
3

4.2 测试执行信息

  • 测试执行人：__________
  • 测试起止时间：__________
  • 测试环境版本：Node 18.16.0 / pnpm 10.33.0 / 浏览器 __________
  • 后端版本 / 提交：__________
  • 测试账号：__________

5. 附录

5.1 关键文件

类型 路径
主页面 process-routing/index.vue
API 文件 process-routing.js
路由模块 production-master-data.js
中文语言包 zh-chs.json#process_routing
英文语言包 en.json#process_routing

5.2 关键接口

操作 Method URL
查询列表 GET production_configuration/technology_model/technology_flow/list
新增 POST production_configuration/technology_model/technology_flow/create
编辑 PUT production_configuration/technology_model/technology_flow/edit
删除 DELETE production_configuration/technology_model/technology_flow/delete

公共参数：method=production_master_data_process_model_process_routing_<action>，platform=background

5.3 字段说明

字段 类型 必填 说明
code string 是 工艺流程编码，唯一，创建后不可修改
name string 是 工艺流程名称
category_id int 是 流程类别 ID（关联工艺流程类别）
product_id int 否 关联产品 ID（关联产品列表）
version string 是 版本号，默认 1.0
status int 是 1=启用，0=禁用
remark string 否 备注