From ce1292c9cf37195b6abd2699dfc5d6cb3e143c9b Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期日, 12 四月 2026 23:38:19 +0800
Subject: [PATCH] feat(MES): 添加MES接口相关实体和DTO JS扩展文件至JSX格式并更新配置
---
Code/docs/superpowers/specs/2026-04-11-manual-task-creation-design.md | 151 ++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 151 insertions(+), 0 deletions(-)
diff --git a/Code/docs/superpowers/specs/2026-04-11-manual-task-creation-design.md b/Code/docs/superpowers/specs/2026-04-11-manual-task-creation-design.md
new file mode 100644
index 0000000..a2a07aa
--- /dev/null
+++ b/Code/docs/superpowers/specs/2026-04-11-manual-task-creation-design.md
@@ -0,0 +1,151 @@
+# 鎵嬪姩鍒涘缓浠诲姟鍔熻兘璁捐
+
+## 1. 闇�姹傛杩�
+
+鍦� WMS 鐣岄潰涓婃坊鍔犳墜鍔ㄥ垱寤轰换鍔″姛鑳姐�傜敤鎴疯緭鍏ヨ捣鐐广�佺粓鐐广�佹潯鐮併�佷粨搴揑D锛岀郴缁熻嚜鍔ㄧ敓鎴愪换鍔″彿绛夊瓧娈碉紝鍙戦�佺粰 WCS銆俉CS 鏍规嵁璧风偣鏄惁涓虹嚎浣撶偣浣�(11068/11010/11001)鍒ゆ柇鏄惁闇�瑕佸啓鍏ヨ緭閫佺嚎浠诲姟銆�
+
+## 2. 鏁翠綋娴佺▼
+
+```
+鐢ㄦ埛(WMS鐣岄潰)
+ 鈫� 杈撳叆锛氫换鍔＄被鍨�/璧风偣/缁堢偣/鏉＄爜/浠撳簱ID
+WMS鍚庣
+ 鈫� 璋冪敤 BaseDal.GetTaskNo() 鐢熸垚 TaskNum
+ 鈫� 鏍规嵁浠诲姟绫诲瀷璁剧疆鐘舵��
+ 鈫� 璋冪敤 WCS ReceiveTask
+WCS鍚庣
+ 鈫� 鍒ゆ柇璧风偣鏄惁涓虹嚎浣撶偣浣�(11068/11010/11001)
+ 鈫� 鏄� 鈫� 鏌� Storage.Devices 鑾峰彇杈撻�佺嚎瀹炰緥
+ 鈫� 鍐欏叆杈撻�佺嚎浠诲姟(璧风偣/缁堢偣/浠诲姟鍙风瓑)
+ 鈫� 杩斿洖鎴愬姛
+```
+
+## 3. WMS 鍓嶇鏀瑰姩
+
+### 3.1 浠诲姟椤甸潰 (`task.vue`)
+
+鍦ㄧ幇鏈変换鍔＄鐞嗛〉闈㈡坊鍔�**鎵嬪姩鍒涘缓浠诲姟**鎸夐挳锛屽脊鍑哄璇濇銆�
+
+### 3.2 瀵硅瘽妗嗗瓧娈�
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| 浠诲姟绫诲瀷 | 涓嬫媺妗� | 鍏ュ簱 / 鍑哄簱 / 绉诲簱 |
+| 璧风偣鍦板潃 | 杈撳叆妗� | 鐢ㄦ埛杈撳叆锛屽 11068 |
+| 缁堢偣鍦板潃 | 杈撳叆妗� | 鐢ㄦ埛杈撳叆 |
+| 鏉＄爜 | 杈撳叆妗� | 鐢ㄦ埛杈撳叆 |
+| 浠撳簱ID | 杈撳叆妗� | 鐢ㄦ埛杈撳叆 |
+| 浼樺厛绾� | 鍙 | 榛樿鍊� 1 |
+
+## 4. WMS 鍚庣鏀瑰姩
+
+### 4.1 鏂板鎺ュ彛
+
+**Controller:** `TaskController.cs`
+```
+POST /api/Task/CreateManualTask
+```
+
+### 4.2 Service 鏂规硶
+
+**TaskService.cs** 鏂板 `CreateManualTaskAsync` 鏂规硶锛�
+
+```csharp
+public async Task<WebResponseContent> CreateManualTaskAsync(CreateManualTaskDto dto)
+{
+ // 1. 璋冪敤 BaseDal.GetTaskNo() 鐢熸垚 TaskNum
+ // 2. 鏍规嵁浠诲姟绫诲瀷璁剧疆鐘舵��
+ // - 鍏ュ簱 鈫� InNew (200)
+ // - 鍑哄簱 鈫� OutNew (100)
+ // - 绉诲簱 鈫� RelocationNew (300)
+ // 3. 鏋勫缓 Dt_Task 瀹炰綋
+ // 4. 璋冪敤 WCS ReceiveTask (POST /api/Task/ReceiveTask)
+ // 5. 杩斿洖缁撴灉
+}
+```
+
+### 4.3 DTO 瀹氫箟
+
+```csharp
+public class CreateManualTaskDto
+{
+ public int TaskType { get; set; } // 1=鍏ュ簱, 2=鍑哄簱, 3=绉诲簱
+ public string SourceAddress { get; set; }
+ public string TargetAddress { get; set; }
+ public string Barcode { get; set; }
+ public int WarehouseId { get; set; }
+ public int Grade { get; set; } = 1; // 榛樿浼樺厛绾�1
+}
+```
+
+## 5. WCS 鍚庣鏀瑰姩
+
+### 5.1 宸叉湁閫昏緫澶嶇敤
+
+`ReceiveWMSTask` 鏂规硶宸叉敮鎸佹帴鏀� WMS 浠诲姟骞跺垎鍙戝埌瀵瑰簲 FlowService锛�
+- 鍏ュ簱浠诲姟 鈫� `InboundTaskFlowService.InitializeOnReceive()`
+- 鍑哄簱浠诲姟 鈫� `OutboundTaskFlowService.InitializeOnReceive()`
+- 绉诲簱浠诲姟 鈫� `RelocationTaskFlowService.InitializeOnReceive()`
+
+### 5.2 绾夸綋鐐逛綅鍒ゆ柇
+
+鍦� `InboundTaskFlowService.InitializeOnReceive()` 涓紝鍒ゆ柇 `SourceAddress` 鏄惁涓虹嚎浣撶偣浣�(11068/11010/11001)銆傝繖涓変釜鐐逛綅鍧囦负**鍏ュ簱绾夸綋鐐逛綅**銆�
+
+### 5.3 鑾峰彇杈撻�佺嚎瀹炰緥
+
+```csharp
+var conveyorLine = Storage.Devices
+ .FirstOrDefault(x => x.DeviceProDTOs.Any(d => d.DeviceChildCode == sourceAddress));
+```
+
+### 5.4 鏂板锛氬啓鍏ヨ緭閫佺嚎浠诲姟
+
+**姝ら�昏緫涓烘柊澧�**锛岀洰鍓� FlowService 涓笉瀛樺湪鍐欏叆杈撻�佺嚎鐨勯�昏緫锛岄渶瑕佸湪鍒ゆ柇涓虹嚎浣撶偣浣嶅悗鏂板锛�
+
+1. 鑾峰彇杈撻�佺嚎瀹炰緥鎴愬姛鍚庯紝璇诲彇婧愮嚎浣撳彿
+2. 鏋勯�� `ConveyorLineTaskCommandNew` 瀵硅薄
+3. 璋冪敤 `conveyorLine.WriteCustomer(sourceLineNo, command)` 鍐欏叆 PLC
+
+鍐欏叆瀛楁锛�
+- `TaskNo` = WCS 鍒嗛厤鐨勪换鍔″彿
+- `Source` = 璧风偣鍦板潃
+- `Target` = 缁堢偣鍦板潃
+- `Barcode` = 鏉＄爜
+- `WCS_STB` = 1 (鏍囪WCS宸插彂閫�)
+
+### 5.5 閲嶅浠诲姟澶勭悊
+
+`ReceiveWMSTask` 涓凡鏈夐噸澶嶄换鍔℃鏌ラ�昏緫锛堟牴鎹� TaskNum 鎴� PalletCode锛夛紝鎵嬪姩鍒涘缓鏃跺閬囬噸澶嶈繑鍥為敊璇��
+
+## 6. 浠诲姟鐘舵�佹灇涓�
+
+| 绫诲瀷 | 鏂板缓鐘舵�� | 鐘舵�佸�� |
+|------|----------|--------|
+| 鍏ュ簱 | InNew | 200 |
+| 鍑哄簱 | OutNew | 100 |
+| 绉诲簱 | RelocationNew | 300 |
+
+## 7. 閿欒澶勭悊
+
+- 浠诲姟鍙疯幏鍙栧け璐� 鈫� 杩斿洖閿欒
+- WCS 鏌ユ壘杈撻�佺嚎瀹炰緥澶辫触 鈫� 杩斿洖閿欒缁� WMS
+- 鍐欏叆 PLC 澶辫触 鈫� 杩斿洖閿欒锛學MS 浠诲姟鐘舵�佷繚鎸佹柊寤�
+- WCS 杩斿洖閲嶅浠诲姟 鈫� 杩斿洖閿欒缁� WMS
+
+## 8. 娑夊強鐨勬簮鏂囦欢
+
+### WMS 鍓嶇
+- `WMS/WIDESEA_WMSClient/src/views/taskinfo/task.vue`
+- `WMS/WIDESEA_WMSClient/src/extension/taskinfo/task.js`
+
+### WMS 鍚庣
+- `WMS/WIDESEA_WMSServer/WIDESEA_TaskInfoService/TaskService.cs`
+- `WMS/WIDESEA_WMSServer/WIDESEA_WMSServer/Controllers/TaskInfo/TaskController.cs`
+
+### WCS 鍚庣
+- `WCS/WIDESEAWCS_Server/WIDESEAWCS_TaskInfoService/TaskService.cs`
+- `WCS/WIDESEAWCS_Server/WIDESEAWCS_TaskInfoService/Flows/InboundTaskFlowService.cs`
+- `WCS/WIDESEAWCS_Server/WIDESEAWCS_TaskInfoService/Flows/OutboundTaskFlowService.cs`
+- `WCS/WIDESEAWCS_Server/WIDESEAWCS_TaskInfoService/Flows/RelocationTaskFlowService.cs`
+- `WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/ConveyorLineNewJob/ConveyorLineDispatchHandler.cs` (鍙傝�冨啓鍏ユā寮�)
+- `WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/ConveyorLineNewJob/ConveyorLine/ConveyorLineTaskCommandNew.cs` (浠诲姟鍛戒护缁撴瀯)
--
Gitblit v1.9.3