feat: 移除工艺物料与混产模板实体、新增产线清线与 PLC 监控实时推送、看板双屏增强

- 移除实体:MES 删除 FlowMaterial(工艺物料)与 MixProductionTemplate(混产模板)全套(schema/ent 生成码/handler/logic),清理关联路由与种子
- 新增功能:产线清线(line_clearance handler + logic)、PLC 监控 WebSocket 实时推送(ws/plc_monitor_hub + handler)
- 看板增强:新增管理屏与 KPI 组件(BoardManage/BoardKpi),调整演示屏 Mock 与各看板面板
- MES 完善:PLC 匹配/扭矩扫描/签收、工艺卡 PDF 与工单、AGV 链路、叫料/备料/在制品/短料预测等逻辑与前端调整
- 工位终端:删除离线面板 OfflinePanel,调整主界面/物料面板与 api/store/handler/路由
- WMS:AGV 托盘、物料与 MES 客户端调整及前端帮助/基础数据/叫料/托盘页
- 文档:更新产线API/客户问题/案例/部署手册/问题记录
This commit is contained in:
SunYF
2026-11-19 08:31:05 +08:00
parent f8482b18f6
commit 4c4cda1d41
148 changed files with 2511 additions and 9735 deletions
+15 -17
View File
@@ -585,7 +585,7 @@
| 方法 | 路径 | 用途 |
|---|---|---|
| POST / PUT | /api/v1/daily-plans | 保存日计划 |
| POST / PUT | /api/v1/daily-plans | 保存日计划。新建带 `planRange` 为批量排产:可传 `items:[{date,qty}]` 逐日自定义数量(Σ 必须等于 `planQty`、日期落在区间内不重复,否则整批拒绝);不传则按 `mode`(AVG 平均分摊余数排前 / FIXED 固定日产)自动分摊。改动逐日数量写操作日志(mode=逐日手改) |
| GET | /api/v1/daily-plans | 日计划列表 |
| GET | /api/v1/daily-plans/unplanned | 未排产工单 |
| DELETE | /api/v1/daily-plans/:id | 删除日计划 |
@@ -699,13 +699,13 @@
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /api/v1/workpiece/online | 工件上线建档(body `{sn,orderNo,operator}`) |
| POST | /api/v1/workpiece/done | 工件完工下线(body `{sn,operator}`) |
| GET | /api/v1/workpieces | 工件列表 |
| GET | /api/v1/workpieces/in-process | 在制品列表 |
| GET | /api/v1/workpieces/in-process | 在制品列表(`?status=SEMI_STORED` 半成品视图) |
| POST | /api/v1/workpieces/force-complete | 强行完工(body `{sn}`,半成品/滞留在制件均可,异常补偿入口) |
| GET | /api/v1/trace | SN 维度全链路追溯 |
| GET | /api/v1/process-steps | 工艺步骤清单 |
>成品无 SN 时由系统兜底随机生成,确保追溯完整。
>成品无 SN 时由系统兜底随机生成,确保追溯完整。**报完最后一道工艺即自动完工**(与报工同一数据库事务同步落库;齐套兜底校验不过则报工照常提交、暂不完工并落预警),无人工完工接口;异常件补偿出路=管理后台「在制品追踪」「强行完工」(半成品/滞留在制件均可,留痕)。
### 2.2.11 在制品流向
@@ -766,7 +766,7 @@
| GET | /api/v1/inspections | 检验列表 |
| GET | /api/v1/inspections/binds | 检验绑定明细 |
| POST | /api/v1/inspections/upload | 检验照片上传 |
| POST | /api/v1/inspections/generate-inter-process | 一键生成《工序间检验记录》 |
| POST | /api/v1/inspections/generate-inter-process | 一键生成《工艺间检验记录》 |
| GET | /api/v1/quality/finished-pending | 待完工检列表 |
| POST | /api/v1/quality/disposal | 不合格处置 |
| GET | /api/v1/quality/unqualified-report | 不合格报表 |
@@ -798,11 +798,11 @@
| POST | /api/v1/product-boms/save | 保存成品物料总账(整表覆盖,回校已有分账) |
| POST | /api/v1/product-boms/reallocate-preview | 一键重分配预览(body `{productCode,rows}`,不改库,逐工艺逐行出原量→建议量) |
| POST | /api/v1/product-boms/reallocate | 按确认方案落库(body `{productCode,rows,plans}`,跳过被未完成工单锁定的工艺,整批校验守恒后写) |
| GET | /api/v1/product-process-materials | 工序分账列表(`?productProcessId=`) |
| POST | /api/v1/product-process-materials/save | 保存工序分账(同一物料可多行、每行不同工序) |
| GET | /api/v1/product-process-materials | 工艺分账列表(`?productProcessId=`) |
| POST | /api/v1/product-process-materials/save | 保存工艺分账(同一物料可多行、每行不同工艺) |
| GET | /api/v1/line/points | 产线点位列表 |
> 总分账:总账按成品编码隔离、产品工艺页只读引用;分账按产品工艺隔离,同一物料可对应多道工序(逐行存),Σ 分账必须等于总账。建成品建档时自动生成一套启用占位工艺,产品工艺无「新增」接口入口。
> 总分账:总账按成品编码隔离、产品工艺页只读引用;分账按产品工艺隔离,同一物料可对应多道工艺(逐行存),Σ 分账必须等于总账。建成品建档时自动生成一套启用占位工艺,产品工艺无「新增」接口入口。
### 2.2.15 预警中心
@@ -839,8 +839,6 @@
| GET | /api/v1/process-card/list | 流程卡列表 |
| GET | /api/v1/performance | 工作量 / 绩效报表 |
| GET | /api/v1/performance/export | 导出绩效报表 |
| GET | /api/v1/station/task | 虚拟工位任务(管理后台,与终端同逻辑) |
| POST | /api/v1/station/report | 虚拟工位报工 |
| GET | /api/v1/workpiece/bind-panel | 绑定面板 |
| GET / PUT | /api/v1/settings | 系统基础设置读 / 写(保存即生效) |
| GET | /api/v1/settings/wms-test | WMS 连通性测试 |
@@ -900,7 +898,7 @@
#### POST /api/report/process-done
工序报工完成。
工艺报工完成。
**请求体字段**
@@ -910,7 +908,7 @@
| orderNo | 字符串 | 是 | 工单号 |
| flowId | 整数 | 是 | 工艺流程 ID |
| stationNo | 整数 | 是 | 工位号 |
| steps | 对象数组 | 是 | 工序数据集合 |
| steps | 对象数组 | 是 | 工艺数据集合 |
| steps[].stepId | 整数 | 是 | 步骤 ID |
| steps[].name | 字符串 | 是 | 步骤名称 |
| steps[].value | 数值 | 否 | 采集值 |
@@ -971,7 +969,8 @@
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /api/workpiece/online | 工件上线建档(body `{sn,orderNo,operator}`) |
| POST | /api/workpiece/done | 工件完工(body `{sn,operator}`) |
>下线完工接口已删除:报完最后一道工艺由 MES 自动完工。
### 2.3.6 叫料(代理 MES)
@@ -1096,9 +1095,8 @@
| POST / PUT | /api/internal/materials | 物料同步落点(按编码幂等 upsert) |
| GET | /api/internal/dashboard/snapshot | 大屏快照数据 |
| GET | /api/internal/dashboard/stream | 大屏 SSE 实时推送(长连接) |
| GET | /api/internal/workpieces/in-process | 在制品 |
| GET | /api/internal/workpieces/in-process | 在制品(`?status=SEMI_STORED` 半成品) |
| POST | /api/internal/workpiece/online | 工件上线 |
| POST | /api/internal/workpiece/done | 工件完工 |
| GET | /api/internal/order-usage | 工单用料 |
| GET | /api/internal/material-requests | 叫料单列表 |
| GET | /api/internal/dock/pallet | 接驳台托盘 |
@@ -1324,8 +1322,8 @@ curl -X POST http://10.10.10.10:8892/api/report/process-done \
1. `POST /api/workpiece/online` 建档(sn + 工单;无 SN 由系统兜底生成)。
2. 工位任务 `GET /api/task/current`;装配绑定 `POST /api/bind/record`。
3. 拧紧枪实时数据 `GET /api/tightening/live` → `POST /api/tightening/record`。
4. 工序报工 `POST /api/report/process-done`(steps + 检测确认)。
5. `POST /api/workpiece/done` 完工;完工检合格 → MES 回流 WMS `POST /api/internal/finished/inbound` 入成品库。
4. 工艺报工 `POST /api/report/process-done`(steps + 检测确认);报完最后一道工艺 MES 自动完工并下发完工件到末端下料检测位。
5. 完工检合格 → MES 回流 WMS `POST /api/internal/finished/inbound` 入成品库。
6. 全链路追溯 `GET /api/v1/trace`(SN 维度:装机绑定 + 检验记录 + 拧紧记录)。
## 4.4 PLC 工艺流程下发与对账