feat: 同步全部系统改动与文档
This commit is contained in:
274
doc/MES后台网页版用户操作手册_V1.0_20260725.md
Normal file
274
doc/MES后台网页版用户操作手册_V1.0_20260725.md
Normal file
@@ -0,0 +1,274 @@
|
||||
# 大连元利流体技术有限公司 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 登录
|
||||
|
||||
1. 打开测试前端地址。
|
||||
2. 输入账号和密码，点击“登录”。
|
||||
3. 登录成功后进入首页；系统按角色加载菜单和按钮权限。
|
||||
4. “记住账号”只保存账号，不保存密码；离开共享电脑时不要勾选。
|
||||
|
||||
### 2.2 列表查询
|
||||
|
||||
1. 先填写必要筛选条件，日期条件使用页面提供的日期选择器。
|
||||
2. 点击“查询”，等待表格刷新。
|
||||
3. 使用分页、每页条数、排序和导出功能核对结果。
|
||||
4. 查询结果为空时先清空筛选条件，再判断是否确实没有数据。
|
||||
|
||||
### 2.3 新增、编辑、删除与状态操作
|
||||
|
||||
1. 新增前确认必填字段、编码唯一性和关联对象。
|
||||
2. 编辑前先选中正确记录，核对订单、合同、工位或人员。
|
||||
3. 删除、关闭、完成、启用、禁用、排产、派工和报工属于状态性操作，执行前必须二次确认。
|
||||
4. 保存后重新查询并核对操作时间、编辑人和状态。
|
||||
|
||||
### 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 排产与装配任务
|
||||
|
||||
1. 在“机加件排产”或“装配件排产”按订单、物料、日期和状态查询。
|
||||
2. 选择任务后执行排产、派工、优先级或计划时间调整；批量操作前核对选择行。
|
||||
3. 到“已排产”“工位任务汇总”或“及时齐套跟踪结果”复核状态。
|
||||
4. 在“系统类装配任务”“阀类装配任务”维护预算装配工时和合同预算测试工时，进度字段由系统计算。
|
||||
|
||||
### 5.2 工艺维护与工艺下发
|
||||
|
||||
1. 在“工序管理”维护工序基础信息。
|
||||
2. 在“制定标准工艺”维护准备工时、标准工时、工装量具、机床和车间。
|
||||
3. 在“生产工艺”查询订单并生成/编辑工艺，确认工序顺序和工时。
|
||||
4. 需要下发生产任务时，确认订单、工艺版本和目标工序后执行下发。
|
||||
|
||||
### 5.3 加工中心与装配中心
|
||||
|
||||
1. 按工位、人员、班次和任务状态查询待处理任务。
|
||||
2. 按业务顺序执行收料、开工、暂停/恢复、报工、送检和异常处理。
|
||||
3. 质检数据录入前核对检测项目、理论值、上下限、实测值和判定。
|
||||
4. 操作完成后检查任务状态、工时、数量和最后编辑人。
|
||||
|
||||
### 5.4 质量检验与不合格品
|
||||
|
||||
1. 根据业务节点进入终检、序检、收检、采购入库检、销售退货检、原材料退库检或其他入库检。
|
||||
2. 选择任务和检测项目，录入检验数量、合格数、不合格数和实测值。
|
||||
3. 不合格结果进入“不合格品处置”，填写处置结论并保留审批/操作记录。
|
||||
4. 使用“质检明细”“及时检验报表”“产品合格率”进行追溯和统计。
|
||||
|
||||
### 5.5 人员、角色、菜单和工位
|
||||
|
||||
1. 先新增或维护人员，再配置角色。
|
||||
2. 在角色管理为角色分配模块和操作权限。
|
||||
3. 在菜单管理维护模块路径和层级；变更菜单前先确认路由组件存在。
|
||||
4. 在工位管理维护工位号、名称和关联信息。
|
||||
5. 权限修改后使用目标账号重新登录验证，不以管理员账号代替验收。
|
||||
|
||||
## 6. 权限与数据安全
|
||||
|
||||
- 菜单权限来自数据库角色菜单过程；页面按钮受 AddData、DeleteData、EditData、SearchData 等权限控制。
|
||||
- 测试前端配置 `externalReadOnly=true` 时，B1/TM 语义 POST/PATCH 在网络请求前被拦截。
|
||||
- 不要在浏览器开发者工具中手工重放生产接口或外部系统写请求。
|
||||
- 不要把账号、密码、Token、业务数据或导出文件提交到代码仓库。
|
||||
- 发现数据异常时保留页面、筛选条件、时间、账号、响应状态和操作记录，不要先删除数据。
|
||||
|
||||
## 7. 功能定位与新增需求说明
|
||||
|
||||
### 7.1 页面问题定位
|
||||
|
||||
1. 先从菜单路径定位页面源码：`src/views/<模块>/<页面>/index.vue`，特殊页面以菜单组件路径为准。
|
||||
2. 在页面中查找 `CreateData`，确认过程名、调用类型和参数名。
|
||||
3. 通用接口入口位于 `src/utils/request.js` 和 `src/utils/curd.js`；动态菜单由 `src/router/getTreeData.js` 和 `src/router/menuComponentModule.js` 生成。
|
||||
4. B1/TM 封装分别位于 `src/api/b1s.js`、`src/api/tm.js`；测试环境不要绕过只读保护。
|
||||
5. 到数据库过程清单中确认过程存在、参数数量、写入特征和外部依赖，再决定改前端、改过程还是补充对象。
|
||||
|
||||
### 7.2 新增需求的推荐顺序
|
||||
|
||||
1. 明确页面角色、数据范围、查询条件、字段口径和读写边界。
|
||||
2. 先确认现有过程是否可复用，避免新增同义过程。
|
||||
3. 测试库新增/修改过程时编写前置校验、事务、验证 SQL 和回滚脚本。
|
||||
4. 前端实现表格、表单、权限按钮、加载/空结果/错误状态和分页。
|
||||
5. 先做只读回归，再用隔离数据做写流程回归，最后更新菜单、手册和变更记录。
|
||||
|
||||
## 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.vue
|
||||
- `Prog_MES_SingleTaskPlanned`：src/views/ProductionManagement/ProductionTaskManage/index.vue
|
||||
- `WEB_报警查询_未读报警记录_查询`：src/views/layout/components/Navbar.vue
|
||||
- `WEB_报警查询_未读报警记录_未读条数查询`：src/views/layout/components/Navbar.vue
|
||||
- `WEB_基本表_产品结构_查询`：src/views/CraftManagement/CraftMaintain/index.vue
|
||||
- `WEB_基本表_产品结构_删除`：src/views/CraftManagement/CraftMaintain/index.vue
|
||||
- `WEB_基本表_产品结构_新增`：src/views/CraftManagement/CraftMaintain/index.vue
|
||||
- `WEB_基本表_产品结构_修改`：src/views/CraftManagement/CraftMaintain/index.vue
|
||||
- `WEB_人员设备查看权限_查询`：src/views/SystemMaintenance/PersonnelManagement/index.vue
|
||||
- `WEB_人员设备查看权限_权限切换`：src/views/SystemMaintenance/PersonnelManagement/index.vue
|
||||
- `WEB_人员摄像头查看权限_权限切换`：src/views/SystemMaintenance/PersonnelManagement/index.vue
|
||||
- `WEB_摄像头查看权限_查询`：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`
|
||||
|
||||
> 手册首版基于源码、菜单和存储过程静态盘点；涉及真实业务写入的页面仍需在隔离数据上完成业务负责人验收后，才能标记为生产可用。
|
||||
Reference in New Issue
Block a user