From 96c9142944da3b9f6ebfc63e17451b9b330e5a72 Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期二, 31 三月 2026 09:28:35 +0800
Subject: [PATCH] docs: 添加 TaskService 重构设计文档
---
Code/WMS/docs/superpowers/specs/2026-03-31-taskService-refactor-design.md | 106 +++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 106 insertions(+), 0 deletions(-)
diff --git a/Code/WMS/docs/superpowers/specs/2026-03-31-taskService-refactor-design.md b/Code/WMS/docs/superpowers/specs/2026-03-31-taskService-refactor-design.md
new file mode 100644
index 0000000..e4c65f7
--- /dev/null
+++ b/Code/WMS/docs/superpowers/specs/2026-03-31-taskService-refactor-design.md
@@ -0,0 +1,106 @@
+# TaskService.cs 閲嶆瀯璁捐
+
+## 1. 鑳屾櫙
+
+`TaskService.cs` 褰撳墠瓒呰繃 1500 琛岋紝鍖呭惈涓変釜鑱岃矗宸紓鏄庢樉鐨勫姛鑳芥ā鍧楋細
+- **WCS 閫昏緫澶勭悊**锛氬叆搴�/鍑哄簱/绉诲簱/鏈烘鎵�/鑷姩鍑哄簱浠诲姟
+- **鍒嗗鏌滄帴鍙�**锛氬寲鎴愬垎瀹规煖鐘舵�佸悓姝ュ拰鍑哄簱璇锋眰
+- **鏋佸嵎搴� AGV 鎺ュ彛**锛欰GV 鍑哄叆搴撶敵璇枫�佽緭閫佺嚎鐢宠銆佸彇鏀捐揣瀹屾垚
+
+鏂囦欢杩囧ぇ瀵艰嚧锛�
+- 闅句互瀹氫綅鍜屼慨鏀圭壒瀹氬姛鑳�
+- 浠ｇ爜瀹℃煡鍥伴毦
+- 骞惰寮�鍙戝啿绐佺巼楂�
+
+## 2. 鐩爣
+
+灏� `TaskService.cs` 鎷嗗垎涓� partial class 鏂囦欢锛�**涓嶆敼鍙樹换浣曚笟鍔￠�昏緫**锛�**涓嶄慨鏀规帶鍒跺櫒璋冪敤鏂瑰紡**銆�
+
+## 3. 鎷嗗垎鏂规
+
+### 3.1 鏂囦欢缁撴瀯
+
+| 鏂囦欢 | 鑱岃矗 | 棰勪及琛屾暟 |
+|------|------|----------|
+| `TaskService.cs` | partial class 澹版槑銆佸瓧娈靛畾涔夈�佹瀯閫犲嚱鏁� | ~100琛� |
+| `TaskService_WCS.cs` | WCS 閫昏緫澶勭悊锛堝叆搴�/鍑哄簱/绉诲簱/绌烘墭鐩�/鏈烘鎵�/鑷姩鍑哄簱锛� | ~550琛� |
+| `TaskService_AGV.cs` | 鏋佸嵎搴� AGV 浠诲姟锛堝嚭鍏ュ簱鐢宠/杈撻�佺嚎鐢宠/鍙栨斁璐у畬鎴�/浠诲姟鍙栨秷锛� | ~280琛� |
+| `TaskService_GradingMachine.cs` | 鍒嗗鏌滄帴鍙ｏ紙鐘舵�侀�氱煡/鍑哄簱璇锋眰/鐢佃姱鏌ヨ锛� | ~140琛� |
+
+### 3.2 淇濈暀鍦ㄤ富鏂囦欢鐨勫唴瀹�
+
+```csharp
+// TaskService.cs
+public partial class TaskService : ServiceBase<Dt_Task, IRepository<Dt_Task>>, ITaskService
+{
+ // 瀛楁
+ private readonly IMapper _mapper;
+ private readonly IStockInfoService _stockInfoService;
+ private readonly ILocationInfoService _locationInfoService;
+ private readonly HttpClientHelper _httpClientHelper;
+ private readonly IConfiguration _configuration;
+ private readonly RoundRobinService _roundRobinService;
+ private readonly IMesService _mesService;
+ private readonly ITask_HtyService _task_HtyService;
+ private readonly IStockInfo_HtyService _stockInfo_HtyService;
+ private readonly IUnitOfWorkManage _unitOfWorkManage;
+
+ // 鏋勯�犲嚱鏁�
+ public TaskService(...) : base(BaseDal) { ... }
+
+ // Repository 灞炴��
+ public IRepository<Dt_Task> Repository => BaseDal;
+
+ // 甯搁噺
+ public List<int> TaskTypes => typeof(TaskTypeEnum).GetEnumIndexList();
+ public List<int> TaskOutboundTypes => typeof(TaskTypeEnum).GetEnumIndexList();
+
+ // 閰嶇疆瀛楁锛圓GV URL锛�
+ public string AGV_OutTaskComplete = ...;
+ public string WCS_ReceiveTask = ...;
+}
+```
+
+### 3.3 鍏叡鏂规硶澶勭悊
+
+浠ヤ笅鏂规硶鍥犺澶氫釜妯″潡璋冪敤锛岄噰鐢�**澶嶅埗鏂瑰紡**淇濇寔瀹屽叏鐙珛锛�
+
+| 鏂规硶 | 澶嶅埗鍒� |
+|------|--------|
+| `CompleteTaskAsync` | `TaskService_WCS.cs` |
+| `GetTaskByPalletCodeAsync` | `TaskService_WCS.cs` |
+| `DetermineTargetAddress` | `TaskService_WCS.cs` |
+
+### 3.4 涓嶆媶鍒嗙殑鍐呭
+
+- 鎵�鏈� `#region` 淇濇寔涓嶅彉
+- 鎵�鏈夋灇涓惧紩鐢ㄤ繚鎸佷笉鍙�
+- 鎵�鏈� using 璇彞鍦ㄥ悇鏂囦欢涓噸澶�
+
+## 4. 瀹炴柦姝ラ
+
+1. **鍒涘缓 `TaskService_WCS.cs`**
+ - 浠庡師鏂囦欢鎻愬彇 WCS 閫昏緫澶勭悊鐩稿叧鏂规硶
+ - 娣诲姞 partial class 澹版槑鍜屽繀瑕� using
+
+2. **鍒涘缓 `TaskService_AGV.cs`**
+ - 浠庡師鏂囦欢鎻愬彇鏋佸嵎搴� AGV 鐩稿叧鏂规硶
+ - 淇濈暀 `AGV_OutTaskComplete` 鍜� `WCS_ReceiveTask` 鐨勮闂�
+
+3. **鍒涘缓 `TaskService_GradingMachine.cs`**
+ - 浠庡師鏂囦欢鎻愬彇鍒嗗鏌滄帴鍙ｇ浉鍏虫柟娉�
+
+4. **绮剧畝 `TaskService.cs`**
+ - 鍒犻櫎宸茶縼绉荤殑鏂规硶瀹炵幇
+ - 淇濈暀 partial class 澹版槑銆佸瓧娈点�佹瀯閫犲嚱鏁�
+
+5. **楠岃瘉缂栬瘧閫氳繃**
+ - 纭繚鎵�鏈夋柟娉曠鍚嶄笉鍙�
+ - 纭繚鎺у埗鍣ㄨ皟鐢ㄦ甯�
+
+## 5. 绾︽潫
+
+- **涓嶄慨鏀逛换浣曚笟鍔￠�昏緫**锛氬彧鎼Щ浠ｇ爜锛屼笉鏀瑰疄鐜�
+- **涓嶄慨鏀规帴鍙� ITaskService**锛氭帶鍒跺櫒渚濊禆鎺ュ彛锛屼笉鎰熺煡瀹炵幇鎷嗗垎
+- **涓嶄慨鏀� DI 娉ㄥ唽**锛欰utofac 鎵弿淇濇寔涓嶅彉
+- **浣跨敤 partial class**锛氫繚璇佺紪璇戝悗绫诲瀷瀹屽叏鍚堝苟
--
Gitblit v1.9.3