# 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 出库（重上线）。
- **查询页**：按物料编码 / 状态（在库/出库）查半成品库存。
- 帮助按钮（右上角）→ 本页有完整字段说明与数据链路。