From 8e42d0c1b7ae36cff2e7c69999117911a4b6f300 Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期四, 26 三月 2026 17:31:06 +0800
Subject: [PATCH] feat(WCS): 完善 WIDESEAWCS_Tasks 模块代码注释
---
Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/ConveyorLineNewJob/ConveyorLineTaskFilter.cs | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++--
1 files changed, 51 insertions(+), 2 deletions(-)
diff --git a/Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/ConveyorLineNewJob/ConveyorLineTaskFilter.cs b/Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/ConveyorLineNewJob/ConveyorLineTaskFilter.cs
index 96fdf1c..297fbd0 100644
--- a/Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/ConveyorLineNewJob/ConveyorLineTaskFilter.cs
+++ b/Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/ConveyorLineNewJob/ConveyorLineTaskFilter.cs
@@ -1,30 +1,79 @@
-锘縰sing WIDESEAWCS_ITaskInfoService;
+using WIDESEAWCS_ITaskInfoService;
using WIDESEAWCS_Model.Models;
namespace WIDESEAWCS_Tasks
{
/// <summary>
- /// 杈撻�佺嚎浠诲姟璁块棶鍣細缁熶竴灏佽浠诲姟鏌ヨ涓� WMS 璇锋眰銆�
+ /// 杈撻�佺嚎浠诲姟杩囨护鍣� - 缁熶竴灏佽浠诲姟鏌ヨ涓� WMS 璇锋眰
/// </summary>
+ /// <remarks>
+ /// 鏍稿績鑱岃矗锛�
+ /// 1. 鏌ヨ杈撻�佺嚎鐨勫緟澶勭悊浠诲姟
+ /// 2. 鏌ヨ姝ｅ湪鎵ц鐨勪换鍔�
+ /// 3. 鍚� WMS 璇锋眰鏂颁换鍔�
+ ///
+ /// 璇ョ被浣滀负涓氬姟灞備笌浠诲姟鏈嶅姟涔嬮棿鐨勪腑闂村眰锛�
+ /// 灏佽浜嗗父鐢ㄧ殑浠诲姟鏌ヨ鎿嶄綔锛屾彁渚涚畝娲佺殑鎺ュ彛缁欒皟鐢ㄦ柟銆�
+ /// </remarks>
public class ConveyorLineTaskFilter
{
+ /// <summary>
+ /// 浠诲姟鏈嶅姟瀹炰緥
+ /// </summary>
+ /// <remarks>
+ /// 鐢ㄤ簬璁块棶鏁版嵁搴撲腑鐨勪换鍔℃暟鎹紝浠ュ強涓� WMS 绯荤粺浜や簰銆�
+ /// </remarks>
private readonly ITaskService _taskService;
+ /// <summary>
+ /// 鏋勯�犲嚱鏁�
+ /// </summary>
+ /// <param name="taskService">浠诲姟鏈嶅姟瀹炰緥</param>
public ConveyorLineTaskFilter(ITaskService taskService)
{
_taskService = taskService;
}
+ /// <summary>
+ /// 鏌ヨ寰呭鐞嗙殑杈撻�佺嚎浠诲姟
+ /// </summary>
+ /// <remarks>
+ /// 鏍规嵁璁惧缂栫爜鍜屽瓙璁惧缂栫爜鏌ヨ鐘舵�佷负"寰呭鐞�"鐨勪换鍔°��
+ /// 鐢ㄤ簬褰� PLC 璇锋眰浠诲姟鏃讹紝WCS 鍚戞暟鎹簱鏌ヨ鍙笅鍙戠殑浠诲姟銆�
+ /// </remarks>
+ /// <param name="deviceCode">璁惧缂栫爜锛堜富璁惧锛�</param>
+ /// <param name="childDeviceCode">瀛愯澶囩紪鐮侊紙浣嶇疆缂栫爜锛�</param>
+ /// <returns>寰呭鐞嗙殑浠诲姟瀵硅薄锛屽鏋滄病鏈夊垯杩斿洖 null</returns>
public Dt_Task? QueryPendingTask(string deviceCode, string childDeviceCode)
{
return _taskService.QueryConveyorLineTask(deviceCode, childDeviceCode);
}
+ /// <summary>
+ /// 鏌ヨ姝ｅ湪鎵ц鐨勮緭閫佺嚎浠诲姟
+ /// </summary>
+ /// <remarks>
+ /// 鏍规嵁浠诲姟鍙峰拰瀛愯澶囩紪鐮佹煡璇㈢姸鎬佷负"鎵ц涓�"鐨勪换鍔°��
+ /// 鐢ㄤ簬璺熻釜浠诲姟鐨勬墽琛岃繘搴︺��
+ /// </remarks>
+ /// <param name="taskNo">浠诲姟鍙�</param>
+ /// <param name="childDeviceCode">瀛愯澶囩紪鐮�</param>
+ /// <returns>鎵ц涓殑浠诲姟瀵硅薄锛屽鏋滄病鏈夊垯杩斿洖 null</returns>
public Dt_Task? QueryExecutingTask(int taskNo, string childDeviceCode)
{
return _taskService.QueryExecutingConveyorLineTask(taskNo, childDeviceCode);
}
+ /// <summary>
+ /// 鍚� WMS 璇锋眰鏂颁换鍔�
+ /// </summary>
+ /// <remarks>
+ /// 褰撹緭閫佺嚎鏈夎揣鐗╁埌杈炬椂锛屽悜 WMS 璇锋眰鏂扮殑浠诲姟銆�
+ /// WMS 浼氭牴鎹粨搴撴儏鍐靛拰璋冨害绛栫暐杩斿洖鍚堥�傜殑浠诲姟銆�
+ /// </remarks>
+ /// <param name="barcode">璐х墿/鎵樼洏鏉＄爜</param>
+ /// <param name="childDeviceCode">璇锋眰鐨勫瓙璁惧缂栫爜</param>
+ /// <returns>璇锋眰鏄惁鎴愬姛</returns>
public bool RequestWmsTask(string barcode, string childDeviceCode)
{
return _taskService.RequestWMSTask(barcode, childDeviceCode).Status;
--
Gitblit v1.9.3