13 KiB
13 KiB
大连元利流体技术有限公司 MES 后台网页版用户操作手册
文档版本:V1.0 | 适用环境:MES 测试环境 | 日期:2026-07-25
本手册基于测试环境角色 1 的 84 条菜单、75 个可进入页面、前端代码静态扫描和测试数据库对象盘点生成。不同角色的菜单、按钮和数据范围以实际权限为准。
1. 使用前说明
- 测试前端地址:
http://124.220.15.242:10012/。 - MES 接口由前端自动调用,用户不需要手工拼接接口地址。
- 测试环境 B1/TM 只允许登录与只读 GET;语义 POST/PATCH 会在前端拦截,不要用写操作验证连通性。
- 页面按钮和数据范围由角色权限控制;看不到某个菜单或按钮时先联系系统管理员,不要直接修改浏览器参数。
- 涉及新增、编辑、删除、排产、派工、报工、质检、入库和状态切换的操作,必须先确认业务单据、操作人和回滚方式。
2. 登录与通用操作
2.1 登录
- 打开测试前端地址。
- 输入账号和密码,点击“登录”。
- 登录成功后进入首页;系统按角色加载菜单和按钮权限。
- “记住账号”只保存账号,不保存密码;离开共享电脑时不要勾选。
2.2 列表查询
- 先填写必要筛选条件,日期条件使用页面提供的日期选择器。
- 点击“查询”,等待表格刷新。
- 使用分页、每页条数、排序和导出功能核对结果。
- 查询结果为空时先清空筛选条件,再判断是否确实没有数据。
2.3 新增、编辑、删除与状态操作
- 新增前确认必填字段、编码唯一性和关联对象。
- 编辑前先选中正确记录,核对订单、合同、工位或人员。
- 删除、关闭、完成、启用、禁用、排产、派工和报工属于状态性操作,执行前必须二次确认。
- 保存后重新查询并核对操作时间、编辑人和状态。
2.4 页面常见问题
| 现象 | 处理顺序 |
|---|---|
| 登录成功但没有菜单 | 退出重新登录;确认角色是否启用、菜单是否分配、接口是否返回菜单数据。 |
| 查询很慢 | 缩小日期和订单范围;记录页面、条件和耗时,交给运维分析存储过程和执行计划。 |
| 按钮不存在 | 检查角色 AddData/DeleteData/EditData/SearchData 权限,不要直接改前端隐藏逻辑。 |
| B1/TM 操作失败 | 测试环境先确认是否为被保护的 POST/PATCH;写操作不会为了测试而放开。 |
| 保存后页面没有变化 | 重新查询并查看接口返回;确认过程是否存在、参数名和业务状态是否满足。 |
3. 菜单与页面总览
当前角色菜单共 84 条,其中模块 9 个、可进入页面 75 个。
系统管理
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
计划排产
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
生产管理
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
质量管理
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
工艺管理
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
设备管理
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
销售订单管理
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
异常提醒
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
研发管理
用途:用于 MES 业务管理和查询。
| 页面 | 路径 | 主要操作 | 关键字段/内容 |
|---|
4. 各模块操作流程
4.1 系统管理
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
4.2 计划排产
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
4.3 生产管理
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
4.4 质量管理
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
4.5 工艺管理
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
4.6 设备管理
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
4.7 销售订单管理
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
4.8 异常提醒
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
4.9 研发管理
模块定位:用于 MES 业务管理和查询。
- 按页面筛选条件查询数据,选择记录后执行页面提供的操作。
- 涉及保存、删除、状态切换的操作必须先确认权限和回滚方式。
5. 重点业务流程
5.1 排产与装配任务
- 在“机加件排产”或“装配件排产”按订单、物料、日期和状态查询。
- 选择任务后执行排产、派工、优先级或计划时间调整;批量操作前核对选择行。
- 到“已排产”“工位任务汇总”或“及时齐套跟踪结果”复核状态。
- 在“系统类装配任务”“阀类装配任务”维护预算装配工时和合同预算测试工时,进度字段由系统计算。
5.2 工艺维护与工艺下发
- 在“工序管理”维护工序基础信息。
- 在“制定标准工艺”维护准备工时、标准工时、工装量具、机床和车间。
- 在“生产工艺”查询订单并生成/编辑工艺,确认工序顺序和工时。
- 需要下发生产任务时,确认订单、工艺版本和目标工序后执行下发。
5.3 加工中心与装配中心
- 按工位、人员、班次和任务状态查询待处理任务。
- 按业务顺序执行收料、开工、暂停/恢复、报工、送检和异常处理。
- 质检数据录入前核对检测项目、理论值、上下限、实测值和判定。
- 操作完成后检查任务状态、工时、数量和最后编辑人。
5.4 质量检验与不合格品
- 根据业务节点进入终检、序检、收检、采购入库检、销售退货检、原材料退库检或其他入库检。
- 选择任务和检测项目,录入检验数量、合格数、不合格数和实测值。
- 不合格结果进入“不合格品处置”,填写处置结论并保留审批/操作记录。
- 使用“质检明细”“及时检验报表”“产品合格率”进行追溯和统计。
5.5 人员、角色、菜单和工位
- 先新增或维护人员,再配置角色。
- 在角色管理为角色分配模块和操作权限。
- 在菜单管理维护模块路径和层级;变更菜单前先确认路由组件存在。
- 在工位管理维护工位号、名称和关联信息。
- 权限修改后使用目标账号重新登录验证,不以管理员账号代替验收。
6. 权限与数据安全
- 菜单权限来自数据库角色菜单过程;页面按钮受 AddData、DeleteData、EditData、SearchData 等权限控制。
- 测试前端配置
externalReadOnly=true时,B1/TM 语义 POST/PATCH 在网络请求前被拦截。 - 不要在浏览器开发者工具中手工重放生产接口或外部系统写请求。
- 不要把账号、密码、Token、业务数据或导出文件提交到代码仓库。
- 发现数据异常时保留页面、筛选条件、时间、账号、响应状态和操作记录,不要先删除数据。
7. 功能定位与新增需求说明
7.1 页面问题定位
- 先从菜单路径定位页面源码:
src/views/<模块>/<页面>/index.vue,特殊页面以菜单组件路径为准。 - 在页面中查找
CreateData,确认过程名、调用类型和参数名。 - 通用接口入口位于
src/utils/request.js和src/utils/curd.js;动态菜单由src/router/getTreeData.js和src/router/menuComponentModule.js生成。 - B1/TM 封装分别位于
src/api/b1s.js、src/api/tm.js;测试环境不要绕过只读保护。 - 到数据库过程清单中确认过程存在、参数数量、写入特征和外部依赖,再决定改前端、改过程还是补充对象。
7.2 新增需求的推荐顺序
- 明确页面角色、数据范围、查询条件、字段口径和读写边界。
- 先确认现有过程是否可复用,避免新增同义过程。
- 测试库新增/修改过程时编写前置校验、事务、验证 SQL 和回滚脚本。
- 前端实现表格、表单、权限按钮、加载/空结果/错误状态和分页。
- 先做只读回归,再用隔离数据做写流程回归,最后更新菜单、手册和变更记录。
8. 全量扫描结果与已知风险
- 前端源码:185 个源码文件,其中 108 个 Vue、77 个 JS。
- CreateData:772 次调用,766 次字面量过程调用,281 个唯一字面量过程名,另有 6 次动态调用需人工复核。
- 外部集成调用:B1 GET/POST/PATCH = 18/20/18;TM GET/POST/PATCH = 1/7/1。
- 测试数据库:432 个存储过程、63 张表、27 个视图;过程定义中包含明显写关键字的约 187 个。
- 数据库表达式依赖:836 条,其中跨服务器依赖 75 条,跨库依赖 106 条。
- 前端调用但测试库找不到同名过程:14 个,属于重点风险,不代表全部页面不可用,需按部署版本、动态过程或历史页面逐项确认。
缺失过程清单:
查询零件号:src/views/QualityManagement/QualityStandardQuery/index copy.vue产品关系_变更节点排序:src/views/CraftManagement/CraftMaintain/index.vue登录基础数据_人员信息_切换是否用户:src/views/SystemMaintenance/PersonnelManagement/index.vueProg_MES_SingleTaskPlanned:src/views/ProductionManagement/ProductionTaskManage/index.vueWEB_报警查询_未读报警记录_查询:src/views/layout/components/Navbar.vueWEB_报警查询_未读报警记录_未读条数查询:src/views/layout/components/Navbar.vueWEB_基本表_产品结构_查询:src/views/CraftManagement/CraftMaintain/index.vueWEB_基本表_产品结构_删除:src/views/CraftManagement/CraftMaintain/index.vueWEB_基本表_产品结构_新增:src/views/CraftManagement/CraftMaintain/index.vueWEB_基本表_产品结构_修改:src/views/CraftManagement/CraftMaintain/index.vueWEB_人员设备查看权限_查询:src/views/SystemMaintenance/PersonnelManagement/index.vueWEB_人员设备查看权限_权限切换:src/views/SystemMaintenance/PersonnelManagement/index.vueWEB_人员摄像头查看权限_权限切换:src/views/SystemMaintenance/PersonnelManagement/index.vueWEB_摄像头查看权限_查询:src/views/SystemMaintenance/PersonnelManagement/index.vue- 数据库存在但静态前端未调用的过程可能来自事件、定时任务、接口内部调用、历史功能或未授权菜单,不能仅凭“未调用”判定为废弃。
- 当前测试环境的核心外部依赖、证书、后端高权限账号和写流程验收仍按接管报告中的限制执行。
9. 交付清单
- 本用户手册:
doc/MES后台网页版用户操作手册_V1.0_20260725.docx - Markdown 版:
doc/MES后台网页版用户操作手册_V1.0_20260725.md - 菜单清单:
work/menu_inventory_role1.csv - 页面 UI 清单:
work/page_ui_inventory_role1_20260725.csv - 前端过程调用清单:
work/frontend_procedure_call_inventory_20260725.csv - 数据库过程清单:
work/database_procedure_inventory_20260725.csv - 前端/数据库差异清单:
work/frontend_calls_missing_db_procedure_20260725.csv - 全量过程扫描脚本:
work/scan-frontend-function-inventory.js - 页面扫描脚本:
work/scan-page-ui-inventory.js
手册首版基于源码、菜单和存储过程静态盘点;涉及真实业务写入的页面仍需在隔离数据上完成业务负责人验收后,才能标记为生产可用。