# WM 仓储单据 BPM 审批 + 设备联动 - 实施进度

> 记录日期：2026-09-07
> 状态：阶段1 分析完成，尚未改码；阶段2/3 尚未开始

## 需求

1. 设备入库、废旧物资出入库（杂项出入库）、物资退货（供应商退货）等全类型单据，实现线上创建、审批、查询，**全部接入真实 BPM 审批**。
2. 设备管理（设备台账）创建时自动入库设备仓，与库存联动。
3. 设备**复用物料主数据模型**（已确认）。

## 阶段1：三大单据补齐 BPM 审批闭环 —— 分析完成，未改码

### 已确认现状（可直接采信）

- `MesOrderStatusConstants`：PREPARE=0, APPROVING=2, APPROVED=3, FINISHED=4, CANCELLED=5。
- 状态枚举：
  - `MesWmMiscReceiptStatusEnum` / `MesWmMiscIssueStatusEnum`：只有 PREPARE/APPROVED/FINISHED/CANCELED，**缺 APPROVING，需新增**。
  - `MesWmReturnVendorStatusEnum`：已有 APPROVING（待拣货）。
- 三个 DO（`MesWmMiscReceiptDO`/`MesWmMiscIssueDO`/`MesWmReturnVendorDO`）：均无 `processInstanceId` 字段，需新增。
- 三个 Service/Impl：miscreceipt、miscissue 的 `submit*` 直接 PREPARE→APPROVED（无 BPM）；returnvendor 已有 APPROVING→(stock)→APPROVED→(finish)→FINISHED。三者均已有完整库存流水 `MesWmTransactionService.createTransactionList`，库存只在 finish 中执行。
- Controller：miscreceipt 有 `/submit`(仅 id)/`/finish`/`/cancel`，无 submit-approval/process-list。

### 标准 BPM 模板（复用）

- `MesWmItemReceiptController`：`/submit-approval?id=&processDefinitionKey=`。
- `MesWmItemReceiptService.submitItemReceiptApproval(id, key)` + `updateItemReceiptAuditStatus(id, bpmResult)`（APPROVE→APPROVED, REJECT→PREPARE, CANCEL→CANCELED）。
- `MesWmItemReceiptStatusListener`：监听 `BpmProcessInstanceStatusEvent`，分类 `item_receipt_approve`。

### 下一步要改（未开始）

1. 枚举：miscreceipt/miscissue 各加 `APPROVING(MesOrderStatusConstants.APPROVING, "审批中")`。
2. DO：三个 DO 各加 `processInstanceId`。
3. Service 接口 + Impl：各加 `submit<Biz>Approval(id, key)`、`update<Biz>AuditStatus(id, bpmResult)`、`get<Biz>ApprovalProcessDefinitionList()`；改 `submit<Biz>` 不再伪造已审批。
4. Controller：各加 `get-approval-process-list`、`submit-approval`。
5. RespVO：各加 `processInstanceId`（前端据此判"未提交审批"）。
6. 新增 3 个监听器：`MesWmMiscReceiptStatusListener`/`MesWmMiscIssueStatusListener`/`MesWmReturnVendorStatusListener`，分类 `misc_receipt_approve`/`misc_issue_approve`/`return_vendor_approve`。
7. 数据库：三个表各加 `process_instance_id VARCHAR(64)`（遵守 sql-syntax/sql-script 规范）。

## 阶段2：设备台账联动设备仓（未开始改码）

- 关键事实：`MdmItemApi.createItem(MdmItemCreateReqDTO)` 可建物料（必填 code/name/categoryId/unitMeasureId/itemType）；`MesDvMachineryDO` 无 item_id；内置设备仓 id=5 / 库区 SYS-EQUIP-LOC-01(id=11) / 库位 SYS-EQUIP-BIN-01(id=10)。
- 方案：`createMachinery` 加事务 → 建 MDM 物料 → 插设备台账(item_id) → 自动生成条码 → `MesWmTransactionService` 入设备仓（IN, qty=1）。更新/删除/导入路径同步。

## 阶段3：独立设备入库单（未开始）

- 新增 `mes_wm_equipment_receipt` 主表+明细表、DO/Mapper/Service/VO/Controller/枚举/业务常量，BPM 闭环，完成入库写设备仓。

## 注意

- 前端 `mom-pro2-before` 只读，只输出 `docs/` 联调方案文档。
- 跨模块改动后：`mvn compile -pl yudao-module-mes -am -q`。
- 详情见计划文件：`C:\Users\云\.claude\plans\optimized-honking-pearl.md`