SunYF
47573e44b0
1. 调整物料编码字段为可空，优化注释说明 2. 修复Vite构建自动清空产物目录冲突问题 3. 优化前端提示文案与表单占位符 4. 为各前端项目添加内联SVG图标 5. 重构MES半成品流转逻辑，不再静默吞掉WMS错误并记录日志 6. 生成并添加空的WMS客户端静态文件 7. 完善Ent ORM模型的空值支持与查询谓词 8. 优化半成品入库接口，支持doneProcessCodes数组格式，新增SN反查物料编码逻辑 9. 更新帮助文档与操作手册
11 KiB
11 KiB
MES 产线控制 · 操作手册
面向产线管理人员、生产操作员、质检员、库房保管员。本文档说明「做什么、按什么顺序做、每个字段怎么填」。页面右上角「帮助」按钮或点击页面标题，也可弹出对应页面的在线帮助。
一、系统概述
MES 是装配线的控制中心：从「产品类型 → 工单 → 物料清单 → 日排产 → 备料 → 工位组合下发 → 工位报工 → 完工追溯」一条链路串起整条产线。
产线共 12 个固定工位（工位1 ~ 工位12），设备只有「扫码枪 + 拧紧枪」，其余为人工操作。传送带单向流转（工位 1 → 2 → … → 12），不会往回走。
统一概念（避免混淆）：
- 工位：产线固定的 12 个物理位置，编号 1~12。
- 工艺流程：服务于某个固定工位的作业指导（含工位号、PDF、工序步骤）。一个工位只能有一个「启用」的工艺流程。
- 工序步骤：工艺流程内的具体作业/采集项（如 装配完成、拧紧扭矩）。
五个系统分工：
| 系统 | 用途 |
|---|---|
| MES（本项目） | 生产主数据、工单、排产、工艺流程、报工、追溯 |
| WMS | 仓库库存、出入库、物料档案（独立数据库） |
| WMS 客户端 | 库房出/入库操作台（带扫码枪） |
| 工位终端 | 12 个工位的触控一体机，扫码报工、采集拧紧数据 |
| 看板 | 厂房大屏，展示产线状态（数据来自 MES） |
二、登录
- 浏览器打开 MES 地址，输入账号密码登录。
- 内置超级管理员：
admin/123456。 - 密码要求：至少 6 位，不能是纯数字。若为纯数字密码，登录时会提示「安全级别低」，但仍可继续登录，建议登录后立即修改。
- 修改密码：点击右上角自己的用户名 → 「修改密码」。
三、主数据操作顺序（首次上线务必按顺序）
- 产品类型：建立「生产什么」的档案（名称 + 编码）。
- 工艺流程：为每个工位维护流程（选工位号）+ 工序步骤 + 考核标准 + 作业指导 PDF；启用后自动绑定到该工位。
- 关联工位：查看 12 个工位的绑定总览（绑定由工艺流程自动建立），可改工位名称。
- 工单管理：建工单，勾选要经过的工位组合。
- 物料清单：给工单对应的产品配置 BOM。
- 日排产：安排哪天生产多少（合计不得超过工单总数）。
- 备料单：按日排产自动算料，供仓库备料。
- 工位组合下发：工件上线时把工位组合下发给 PLC。
- 手动报工 / 工位终端：选工位 → 自动载入该工位工序步骤 → 采集数据、判合格。
- 工件追溯 / 绩效报表：查看结果。
四、菜单操作说明
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 是唯一追溯锚点，两系统尽量解耦。
闭环流程
- 暂存退库（MES 工位终端）
工位做到第 N 道工序后暂存退出 → 工位终端调 MES 工序流转接口（
action=INBOUND）→ MES 本地记一条semi_flow，并自动调用 WMS 内部接口/api/internal/semi/inbound，带上：sn、orderNo、已完成的工序码doneProcessCodes、操作人。 - WMS 入库建账
WMS 生成一条「半成品库存」记录（状态=在库），并同步写入 SN 台账。
- 物料编码（materialCode）不强制：MES 调用时不传，WMS 优先用请求里的、其次按 SN 反查序列号台账，都没有则留空，不影响闭环。
- 已完成工序：MES 传
doneProcessCodes（如[1,3,5]），WMS 存为逗号串1,3,5。
- 重上线（续做）
该件后续要接着做时，在本页「半成品出库」或 MES 侧触发 → WMS
/api/internal/semi/outbound把该 SN 状态置为出库。 - MES 续做至完工 MES 已知该件已完成的工序，下发下一工序 → 工位继续装配 → 直至完工、生成追溯。
也支持倒序：工单只建 1、3 序先做成半成品入库；新建另一个工单只勾 2 序，把半成品出库重上线，补齐中间工序变成成品。
同步失败怎么办
- MES 调 WMS 若失败（WMS 不可达 / 校验不通过），不再静默吞掉：MES 会写一条
semi.flow.wms_error操作日志并返回错误，工位终端/接口会提示「WMS 同步失败」。 - 本地
semi_flow记录已保存，待 WMS 恢复后重试流转即可补齐闭环。
在 WMS 客户端怎么看
- 半成品/成品入库页：手工录入时选物料、填已完成工序（逗号分隔）、扫 SN 提交。
- 半成品出库页：扫 SN 出库（重上线）。
- 查询页：按物料编码 / 状态（在库/出库）查半成品库存。
- 帮助按钮（右上角）→ 本页有完整字段说明与数据链路。