From d21f05eca68a518409357afab2eff61c2d43db6b Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期一, 07 九月 2026 16:07:03 +0800
Subject: [PATCH] docs(wm): 添加仓储单据BPM审批与设备联动实施进度文档

---
 docs/wm_bpm_progress.md |   53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 53 insertions(+), 0 deletions(-)

diff --git a/docs/wm_bpm_progress.md b/docs/wm_bpm_progress.md
new file mode 100644
index 0000000..cb115ad
--- /dev/null
+++ b/docs/wm_bpm_progress.md
@@ -0,0 +1,53 @@
+# WM 浠撳偍鍗曟嵁 BPM 瀹℃壒 + 璁惧鑱斿姩 - 瀹炴柦杩涘害
+
+> 璁板綍鏃ユ湡锛�2026-09-07
+> 鐘舵�侊細闃舵1 鍒嗘瀽瀹屾垚锛屽皻鏈敼鐮侊紱闃舵2/3 灏氭湭寮�濮�
+
+## 闇�姹�
+
+1. 璁惧鍏ュ簱銆佸簾鏃х墿璧勫嚭鍏ュ簱锛堟潅椤瑰嚭鍏ュ簱锛夈�佺墿璧勯��璐э紙渚涘簲鍟嗛��璐э級绛夊叏绫诲瀷鍗曟嵁锛屽疄鐜扮嚎涓婂垱寤恒�佸鎵广�佹煡璇紝**鍏ㄩ儴鎺ュ叆鐪熷疄 BPM 瀹℃壒**銆�
+2. 璁惧绠＄悊锛堣澶囧彴璐︼級鍒涘缓鏃惰嚜鍔ㄥ叆搴撹澶囦粨锛屼笌搴撳瓨鑱斿姩銆�
+3. 璁惧**澶嶇敤鐗╂枡涓绘暟鎹ā鍨�**锛堝凡纭锛夈��
+
+## 闃舵1锛氫笁澶у崟鎹ˉ榻� BPM 瀹℃壒闂幆 鈥斺�� 鍒嗘瀽瀹屾垚锛屾湭鏀圭爜
+
+### 宸茬‘璁ょ幇鐘讹紙鍙洿鎺ラ噰淇★級
+
+- `MesOrderStatusConstants`锛歅REPARE=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锛歮iscreceipt銆乵iscissue 鐨� `submit*` 鐩存帴 PREPARE鈫扐PPROVED锛堟棤 BPM锛夛紱returnvendor 宸叉湁 APPROVING鈫�(stock)鈫扐PPROVED鈫�(finish)鈫扚INISHED銆備笁鑰呭潎宸叉湁瀹屾暣搴撳瓨娴佹按 `MesWmTransactionService.createTransactionList`锛屽簱瀛樺彧鍦� finish 涓墽琛屻��
+- Controller锛歮iscreceipt 鏈� `/submit`(浠� id)/`/finish`/`/cancel`锛屾棤 submit-approval/process-list銆�
+
+### 鏍囧噯 BPM 妯℃澘锛堝鐢級
+
+- `MesWmItemReceiptController`锛歚/submit-approval?id=&processDefinitionKey=`銆�
+- `MesWmItemReceiptService.submitItemReceiptApproval(id, key)` + `updateItemReceiptAuditStatus(id, bpmResult)`锛圓PPROVE鈫扐PPROVED, REJECT鈫扨REPARE, CANCEL鈫扖ANCELED锛夈��
+- `MesWmItemReceiptStatusListener`锛氱洃鍚� `BpmProcessInstanceStatusEvent`锛屽垎绫� `item_receipt_approve`銆�
+
+### 涓嬩竴姝ヨ鏀癸紙鏈紑濮嬶級
+
+1. 鏋氫妇锛歮iscreceipt/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` 鍏ヨ澶囦粨锛圛N, qty=1锛夈�傛洿鏂�/鍒犻櫎/瀵煎叆璺緞鍚屾銆�
+
+## 闃舵3锛氱嫭绔嬭澶囧叆搴撳崟锛堟湭寮�濮嬶級
+
+- 鏂板 `mes_wm_equipment_receipt` 涓昏〃+鏄庣粏琛ㄣ�丏O/Mapper/Service/VO/Controller/鏋氫妇/涓氬姟甯搁噺锛孊PM 闂幆锛屽畬鎴愬叆搴撳啓璁惧浠撱��
+
+## 娉ㄦ剰
+
+- 鍓嶇 `mom-pro2-before` 鍙锛屽彧杈撳嚭 `docs/` 鑱旇皟鏂规鏂囨。銆�
+- 璺ㄦā鍧楁敼鍔ㄥ悗锛歚mvn compile -pl yudao-module-mes -am -q`銆�
+- 璇︽儏瑙佽鍒掓枃浠讹細`C:\Users\浜慭.claude\plans\optimized-honking-pearl.md`

--
Gitblit v1.9.3