From 4c4f4de76d118f0f66f3f1d9510b6e6199574318 Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期一, 30 三月 2026 09:30:52 +0800
Subject: [PATCH] docs: 添加 MES 电芯绑定解绑集成设计

---
 Code/WMS/docs/superpowers/specs/2026-03-30-MES电芯绑定解绑集成设计.md |   95 +++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 95 insertions(+), 0 deletions(-)

diff --git "a/Code/WMS/docs/superpowers/specs/2026-03-30-MES\347\224\265\350\212\257\347\273\221\345\256\232\350\247\243\347\273\221\351\233\206\346\210\220\350\256\276\350\256\241.md" "b/Code/WMS/docs/superpowers/specs/2026-03-30-MES\347\224\265\350\212\257\347\273\221\345\256\232\350\247\243\347\273\221\351\233\206\346\210\220\350\256\276\350\256\241.md"
new file mode 100644
index 0000000..a1fa2d0
--- /dev/null
+++ "b/Code/WMS/docs/superpowers/specs/2026-03-30-MES\347\224\265\350\212\257\347\273\221\345\256\232\350\247\243\347\273\221\351\233\206\346\210\220\350\256\276\350\256\241.md"
@@ -0,0 +1,95 @@
+# MES 鐢佃姱缁戝畾瑙g粦闆嗘垚璁捐
+
+## 姒傝堪
+
+鍦� `StockService` 鐨勭粍鐩樸�佹崲鐩樸�佹媶鐩樻搷浣滀腑锛屽皢 MES 鐢佃姱缁戝畾/瑙g粦璋冪敤绾冲叆 WMS 浜嬪姟鍐咃紝纭繚搴撳瓨鏁版嵁涓� MES 鐘舵�佷竴鑷淬��
+
+## 浜嬪姟绛栫暐
+
+**MES 璋冪敤绾冲叆 WMS 浜嬪姟鍐�** 鈥� 濡傛灉 MES 璋冪敤澶辫触锛屾暣涓簨鍔″洖婊氾紝WMS 搴撳瓨鏁版嵁涓嶄細鍙樺寲銆�
+
+## 鏁版嵁娴�
+
+| 鎿嶄綔 | MES 璋冪敤 | 鏃舵満 |
+|------|----------|------|
+| **缁勭洏** | `BindContainer` | WMS 搴撳瓨鍐欏叆鍚� |
+| **鎹㈢洏** | `UnBindContainer` 鈫� `BindContainer` | 瑙g粦鍦ㄦ崲鍑哄墠锛岀粦瀹氬湪鎹㈠叆鍚� |
+| **鎷嗙洏** | `UnBindContainer` | 搴撳瓨鏄庣粏鍒犻櫎鍓� |
+
+## 娑夊強鏂囦欢
+
+- `WIDESEA_StockService/StockSerivce.cs`
+
+## 璇︾粏璁捐
+
+### 1. 缁勭洏 (GroupPalletAsync)
+
+**鐜版湁閫昏緫锛�**
+- 鍦ㄤ簨鍔″唴鎵ц WMS 搴撳瓨鍐欏叆
+- 绗� 166 琛屽凡瀛樺湪 `_mesService.BindContainer()` 璋冪敤锛屼絾缂哄皯 `await` 鍜岀粨鏋滃鐞�
+
+**淇敼鍚庯細**
+- 淇涓� `await _mesService.BindContainer(bindRequest)`
+- 妫�鏌ヨ繑鍥炵粨鏋滐紝`result.Success == false` 鏃朵簨鍔″洖婊�
+- 閿欒杩斿洖锛歚"缁勭洏鎴愬姛锛屼絾MES璋冪敤澶辫触: {MES閿欒}"`
+
+### 2. 鎹㈢洏 (ChangePalletAsync)
+
+**鐜版湁閫昏緫锛�**
+- 浜嬪姟鍐咃細鏌ヨ婧愭墭鐩樺拰鐩爣鎵樼洏 鈫� 鏇存柊搴撳瓨鏄庣粏鐨� `StockId`
+
+**淇敼鍚庯細**
+- 鍦ㄦ洿鏂板簱瀛樻槑缁嗗墠锛岃皟鐢� `UnBindContainer` 瑙g粦婧愭墭鐩樼數鑺�
+- 鍦ㄦ洿鏂板簱瀛樻槑缁嗗悗锛岃皟鐢� `BindContainer` 缁戝畾鍒扮洰鏍囨墭鐩�
+- MES 澶辫触 鈫� 浜嬪姟鍥炴粴
+
+**UnBindContainer 璇锋眰鏋勫缓锛�**
+```csharp
+var unbindRequest = new UnBindContainerRequest
+{
+    EquipmentCode = "STK-GROUP-001",
+    ResourceCode = "STK-GROUP-001",
+    LocalTime = DateTime.Now,
+    ContainCode = stock.SourcePalletNo,
+    SfcList = detailEntities.Select(d => d.SerialNumber).ToList()
+};
+```
+
+### 3. 鎷嗙洏 (SplitPalletAsync)
+
+**鐜版湁閫昏緫锛�**
+- 浜嬪姟鍐咃細鏌ヨ搴撳瓨鏄庣粏 鈫� 鍒犻櫎鏄庣粏璁板綍
+
+**淇敼鍚庯細**
+- 鍒犻櫎鍓嶏紝璋冪敤 `UnBindContainer` 瑙g粦鐢佃姱
+- MES 澶辫触 鈫� 浜嬪姟鍥炴粴
+
+**UnBindContainer 璇锋眰鏋勫缓锛�**
+```csharp
+var unbindRequest = new UnBindContainerRequest
+{
+    EquipmentCode = "STK-GROUP-001",
+    ResourceCode = "STK-GROUP-001",
+    LocalTime = DateTime.Now,
+    ContainCode = stock.SourcePalletNo,
+    SfcList = detailEntities.Select(d => d.SerialNumber).ToList()
+};
+```
+
+## 閿欒澶勭悊
+
+缁熶竴閿欒澶勭悊绛栫暐锛�
+- MES 璋冪敤澶辫触鏃讹紝浜嬪姟鍥炴粴
+- 杩斿洖锛歚"{鎿嶄綔}鎴愬姛锛屼絾MES璋冪敤澶辫触: {MES閿欒}"`
+
+鍏朵腑 `{MES閿欒}` 鏉ヨ嚜 `result.Message`銆�
+
+## 璁惧缂栫爜
+
+纭紪鐮� `EquipmentCode = "STK-GROUP-001"` 鍜� `ResourceCode = "STK-GROUP-001"`锛屼笌缁勭洏鐜版湁閫昏緫淇濇寔涓�鑷淬��
+
+## 瀹炵幇瑕佺偣
+
+- 鎵�鏈� MES 璋冪敤浣跨敤 `await`
+- 妫�鏌� `HttpResponseResult<MesResponse>` 鐨� `Success` 灞炴��
+- MES 璋冪敤澶辫触鏃惰繑鍥為敊璇俊鎭紝浜嬪姟鑷姩鍥炴粴锛坄ExecuteWithinTransactionAsync` 鍦� `result.Status != true` 鏃跺洖婊氾級

--
Gitblit v1.9.3