SunYF
47573e44b0
1. 调整物料编码字段为可空，优化注释说明 2. 修复Vite构建自动清空产物目录冲突问题 3. 优化前端提示文案与表单占位符 4. 为各前端项目添加内联SVG图标 5. 重构MES半成品流转逻辑，不再静默吞掉WMS错误并记录日志 6. 生成并添加空的WMS客户端静态文件 7. 完善Ent ORM模型的空值支持与查询谓词 8. 优化半成品入库接口，支持doneProcessCodes数组格式，新增SN反查物料编码逻辑 9. 更新帮助文档与操作手册
170 lines
11 KiB
Markdown
170 lines
11 KiB
Markdown
# MES 产线控制 · 操作手册
|
||
|
||
> 面向产线管理人员、生产操作员、质检员、库房保管员。本文档说明「做什么、按什么顺序做、每个字段怎么填」。页面右上角「帮助」按钮或点击页面标题，也可弹出对应页面的在线帮助。
|
||
|
||
## 一、系统概述
|
||
|
||
MES 是装配线的控制中心：从「产品类型 → 工单 → 物料清单 → 日排产 → 备料 → 工位组合下发 → 工位报工 → 完工追溯」一条链路串起整条产线。
|
||
|
||
产线共 12 个固定工位（工位1 ~ 工位12），设备只有「扫码枪 + 拧紧枪」，其余为人工操作。传送带单向流转（工位 1 → 2 → … → 12），不会往回走。
|
||
|
||
**统一概念**（避免混淆）：
|
||
- **工位**：产线固定的 12 个物理位置，编号 1~12。
|
||
- **工艺流程**：服务于某个固定工位的作业指导（含工位号、PDF、工序步骤）。一个工位只能有一个「启用」的工艺流程。
|
||
- **工序步骤**：工艺流程内的具体作业/采集项（如 装配完成、拧紧扭矩）。
|
||
|
||
五个系统分工：
|
||
|
||
| 系统 | 用途 |
|
||
|------|------|
|
||
| MES（本项目） | 生产主数据、工单、排产、工艺流程、报工、追溯 |
|
||
| WMS | 仓库库存、出入库、物料档案（独立数据库） |
|
||
| WMS 客户端 | 库房出/入库操作台（带扫码枪） |
|
||
| 工位终端 | 12 个工位的触控一体机，扫码报工、采集拧紧数据 |
|
||
| 看板 | 厂房大屏，展示产线状态（数据来自 MES） |
|
||
|
||
---
|
||
|
||
## 二、登录
|
||
|
||
1. 浏览器打开 MES 地址，输入账号密码登录。
|
||
2. 内置超级管理员：`admin` / `123456`。
|
||
3. 密码要求：至少 6 位，不能是纯数字。若为纯数字密码，登录时会提示「安全级别低」，但仍可继续登录，建议登录后立即修改。
|
||
4. 修改密码：点击右上角自己的用户名 → 「修改密码」。
|
||
|
||
---
|
||
|
||
## 三、主数据操作顺序（首次上线务必按顺序）
|
||
|
||
1. **产品类型**：建立「生产什么」的档案（名称 + 编码）。
|
||
2. **工艺流程**：为每个工位维护流程（选工位号）+ 工序步骤 + 考核标准 + 作业指导 PDF；**启用后自动绑定到该工位**。
|
||
3. **关联工位**：查看 12 个工位的绑定总览（绑定由工艺流程自动建立），可改工位名称。
|
||
4. **工单管理**：建工单，勾选要经过的**工位组合**。
|
||
5. **物料清单**：给工单对应的产品配置 BOM。
|
||
6. **日排产**：安排哪天生产多少（合计不得超过工单总数）。
|
||
7. **备料单**：按日排产自动算料，供仓库备料。
|
||
8. **工位组合下发**：工件上线时把工位组合下发给 PLC。
|
||
9. **手动报工 / 工位终端**：选工位 → 自动载入该工位工序步骤 → 采集数据、判合格。
|
||
10. **工件追溯 / 绩效报表**：查看结果。
|
||
|
||
---
|
||
|
||
## 四、菜单操作说明
|
||
|
||
### 1. 产品类型
|
||
- 维护产品的名称、编码、类别、启用状态、备注。
|
||
- 编码自动生成（`PROD-YYYYMMDD-序号`），可修改。
|
||
- **关系**：产品类型 ↔ 工单 = 1 对 N（同型号可多工单）；产品类型 ↔ 物料清单 = 按产品编码 1 对 1；备料单由「日排产 × BOM」间接产生。
|
||
- 产品编码与 WMS 是两套系统、互相解耦，成品入库时由操作人员把该编码**手动录入 WMS** 对齐。
|
||
|
||
### 2. 工单管理
|
||
- **新建工单**：自动生成工单号；选择产品类型（未选时显示"请选择"）；填产品编码/名称、数量；**勾选工位组合**。
|
||
- **查询**：支持 工单号 / 产品编码 / 产品名称（模糊）/ 状态 组合筛选。
|
||
- **工位组合**：勾选本工单要经过的工位（1~12），系统自动按 `1 → 2 → … → 12` 顺序执行。全选 = 全部工位；只走部分工位就只勾那几道。半成品再上线时，可只勾「漏掉的工位」完成闭环。
|
||
- **状态流转**：列表操作列「状态」按钮，按 已创建 → 发布 → 开工 → 完工 推进。
|
||
- **删除**：仅「已创建 / 待排产 / 已发布」且无排产、备料、生产数据的工单可删除（操作列「删除」按钮）。
|
||
- 工单号贯穿备料、报工、追溯、日志全链路。
|
||
|
||
### 3. 日排产
|
||
- 按「工单号 + 日期」排哪天生产多少。
|
||
- 同一工单多天排产的**合计数量不能超过工单总数量**（系统强校验，已修复重复累计 bug）。
|
||
- 已完成/关闭的工单不能再排产；某天已有完工数量的排产不能改数量。
|
||
- 排产是仓库备料的触发依据。
|
||
|
||
### 4. 物料清单（BOM）
|
||
- 维护「生产 1 台产品需要哪些物料、各用多少」，按产品编码归类。
|
||
- **与 WMS 的关系**：本页只维护「产品由哪几种料、各用几个」；物料名称/规格/库存统一在 WMS 的「物料档案」维护。两系统靠**物料编码**对齐。
|
||
- **编码对应**：本页「物料编码」必须与 WMS 物料档案的「编码」完全一致，否则仓库无法备料/出库。
|
||
- **管理方式**：精密件 = 按 SN 逐件；结构件 = 按批次。
|
||
- 添加物料：点「添加物料」→ 在弹窗里选产品编码、填物料信息、保存。
|
||
|
||
### 5. 备料单
|
||
- ① 先到「日排产」排好某天计划；② 回本页选该「日期」；③ 点「按日排产生成备料」，系统按各产品 BOM 自动算料生成备料单；④ 仓库据此备料出库。
|
||
|
||
### 6. 工位组合下发
|
||
- 把工单/工件的**工位组合**写入西门子 S7-1214 PLC，传送带据此只停靠勾选的工位。
|
||
- 工件上线、或半成品补工位时，人工在此下发。
|
||
- 约束：上一条未收到完成信号，不下发下一条，防止串序。
|
||
|
||
### 7. 工艺流程
|
||
- 每个流程服务于一个**固定工位（1~12）**，一个工位可有多个流程版本，但**只能有一个「启用」的流程**。
|
||
- 流程内容：名称、工位号、状态（启用/停用）、作业指导 PDF、**工序步骤**。
|
||
- **工序步骤**：每步设「采集方式」（拧紧枪自动 / 手填 / 仅记录）和「考核标准」。
|
||
- **考核标准**：在步骤行点「考核标准」弹出独立窗口，设指标名/单位/逻辑/目标值或区间；报工时按此自动判合格/不合格。未设标准 = 仅记录不判定。
|
||
- **启用/停用**：列表操作列点「启用/停用」。**启用 = 自动绑定到该工位；停用 = 自动解绑该工位**。同一工位已有启用流程时，新流程无法启用，需先停用旧流程。
|
||
|
||
### 8. 关联工位
|
||
- 产线固定 12 个工位，本页是工位总览：查看每个工位绑定的工艺流程、修改工位名称。
|
||
- 绑定关系由「工艺流程」页自动建立（流程选工位号并启用即绑定），本页不需要手动选流程。
|
||
|
||
### 9. 拧紧查询
|
||
- 查询/补录拧紧数据（扭矩、角度、结果、操作人），用于质量追溯。
|
||
|
||
### 10. 手动报工
|
||
- 选**工位**、扫工件 SN → 系统自动载入该工位启用工艺流程的**工序步骤** → 逐条填采集值 → 提交。
|
||
- 系统按考核标准自动判定合格/不合格（OK/NG）。
|
||
- 若提示未配置工序步骤：请到「工艺流程」为该工位启用流程并维护工序步骤。
|
||
|
||
### 11. 工件追溯
|
||
- 输入 SN 查完整履历：各工位时间线、步骤考核数据、拧紧记录、用了哪些批次/SN。
|
||
|
||
### 12. 绩效报表
|
||
- 按 操作人 × 日期 × 工位 统计完成数、合格数、NG 数、合格率。
|
||
|
||
### 13. 巡检终端
|
||
- 检验员/线长用平板或电脑做：开工签到、工位点检、过程巡检、完工确认、异常上报、记录查看。
|
||
|
||
### 14. 操作日志
|
||
- 记录所有关键操作，按工单号、操作人、类型可追溯，只读。
|
||
|
||
### 15. 角色权限管理
|
||
- 管理用户/角色/权限。**角色不可删除、编辑；管理员至少保留一个**。
|
||
|
||
---
|
||
|
||
## 五、常见问题
|
||
|
||
| 问题 | 解决 |
|
||
|------|------|
|
||
| 工艺流程无法启用 | 该工位已存在其他启用的流程，先停用旧流程 |
|
||
| 停用流程后工位没流程了 | 正常，停用即解绑；再到「工艺流程」为该工位启用另一个流程 |
|
||
| 关联工位显示"未绑定" | 到「工艺流程」为该工位号启用一个流程 |
|
||
| 备料/出库提示物料不存在 | 物料清单里的「物料编码」与 WMS 物料档案不一致，核对编码 |
|
||
| 报工页没有采集框 | 该工位未启用流程，或流程没维护工序步骤；到「工艺流程」处理 |
|
||
| 排产保存失败 | 多天排产合计超过工单总数量，或该工单已完成/关闭 |
|
||
| 工单删不掉 | 仅「已创建/待排产/已发布」且无排产、备料、生产数据的工单可删除 |
|
||
| 修改密码后要重新登录 | 正常现象，密码变更即失效当前登录 |
|
||
|
||
---
|
||
|
||
## 六、半成品闭环逻辑（MES ↔ WMS 重上线）
|
||
|
||
**结论：能闭环。** 半成品（或完工成品）在产线中途暂存、或需跨工单续做时，通过 MES 与 WMS 的内部接口打通，SN 是唯一追溯锚点，两系统尽量解耦。
|
||
|
||
### 闭环流程
|
||
|
||
1. **暂存退库（MES 工位终端）**
|
||
工位做到第 N 道工序后暂存退出 → 工位终端调 MES 工序流转接口（`action=INBOUND`）→ MES 本地记一条 `semi_flow`，并**自动**调用 WMS 内部接口 `/api/internal/semi/inbound`，带上：`sn`、`orderNo`、已完成的工序码 `doneProcessCodes`、操作人。
|
||
2. **WMS 入库建账**
|
||
WMS 生成一条「半成品库存」记录（状态=在库），并同步写入 SN 台账。
|
||
- 物料编码（materialCode）**不强制**：MES 调用时不传，WMS 优先用请求里的、其次按 SN 反查序列号台账，都没有则留空，不影响闭环。
|
||
- 已完成工序：MES 传 `doneProcessCodes`（如 `[1,3,5]`），WMS 存为逗号串 `1,3,5`。
|
||
3. **重上线（续做）**
|
||
该件后续要接着做时，在本页「半成品出库」或 MES 侧触发 → WMS `/api/internal/semi/outbound` 把该 SN 状态置为出库。
|
||
4. **MES 续做至完工**
|
||
MES 已知该件已完成的工序，下发下一工序 → 工位继续装配 → 直至完工、生成追溯。
|
||
|
||
> 也支持倒序：工单只建 1、3 序先做成半成品入库；新建另一个工单只勾 2 序，把半成品出库重上线，补齐中间工序变成成品。
|
||
|
||
### 同步失败怎么办
|
||
|
||
- MES 调 WMS 若失败（WMS 不可达 / 校验不通过），**不再静默吞掉**：MES 会写一条 `semi.flow.wms_error` 操作日志并返回错误，工位终端/接口会提示「WMS 同步失败」。
|
||
- 本地 `semi_flow` 记录已保存，待 WMS 恢复后重试流转即可补齐闭环。
|
||
|
||
### 在 WMS 客户端怎么看
|
||
|
||
- **半成品/成品入库页**：手工录入时选物料、填已完成工序（逗号分隔）、扫 SN 提交。
|
||
- **半成品出库页**：扫 SN 出库（重上线）。
|
||
- **查询页**：按物料编码 / 状态（在库/出库）查半成品库存。
|
||
- 帮助按钮（右上角）→ 本页有完整字段说明与数据链路。
|