From e46aa927d231af83724683c7286d9db503e24cf7 Mon Sep 17 00:00:00 2001
From: z8018 <1282578289@qq.com>
Date: 星期二, 10 六月 2025 11:46:20 +0800
Subject: [PATCH] 1

---
 项目代码/WCS/WIDESEAWCS_Server/WIDESEAWCS_IBasicInfoService/IContainerService.cs |   87 ++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 85 insertions(+), 2 deletions(-)

diff --git "a/\351\241\271\347\233\256\344\273\243\347\240\201/WCS/WIDESEAWCS_Server/WIDESEAWCS_IBasicInfoService/IContainerService.cs" "b/\351\241\271\347\233\256\344\273\243\347\240\201/WCS/WIDESEAWCS_Server/WIDESEAWCS_IBasicInfoService/IContainerService.cs"
index be278e9..b719568 100644
--- "a/\351\241\271\347\233\256\344\273\243\347\240\201/WCS/WIDESEAWCS_Server/WIDESEAWCS_IBasicInfoService/IContainerService.cs"
+++ "b/\351\241\271\347\233\256\344\273\243\347\240\201/WCS/WIDESEAWCS_Server/WIDESEAWCS_IBasicInfoService/IContainerService.cs"
@@ -14,12 +14,95 @@
 {
     public interface IContainerService : IService<Dt_Container>
     {
-        SuctionInfo GetPlacementResult(Block block, List<Block> blocks);
-
+        /// <summary>
+        /// 鑾峰彇浠诲姟浣嶇疆淇℃伅
+        /// </summary>
+        /// <param name="length">鐗╁搧闀垮害</param>
+        /// <param name="width">鐗╁搧瀹藉害</param>
+        /// <param name="height">鐗╁搧楂樺害</param>
+        /// <param name="containerSize">瀹瑰櫒灏哄</param>
+        /// <param name="placedBlocks">宸叉斁缃潡鍒楄〃</param>
+        /// <param name="edge">杈圭紭鍙傛暟</param>
+        /// <returns>杩斿洖浠诲姟浣嶇疆淇℃伅锛岃嫢鏀剧疆澶辫触鍒欒繑鍥瀗ull</returns>
+        /// <exception cref="Exception">褰撴斁缃繃绋嬩腑鍙戠敓閿欒鏃舵姏鍑哄紓甯�</exception>
         TaskPosition? GetTaskPosition(int length, int width, int height, ContainerSize containerSize, List<PlacedBlock> placedBlocks, int edge);
 
+        /// <summary>
+        /// 鏍规嵁璁㈠崟淇℃伅鎴栧昂瀵歌幏鍙栦换鍔′綅缃�
+        /// </summary>
+        /// <param name="orderId">璁㈠崟ID</param>
+        /// <param name="orderNo">璁㈠崟缂栧彿</param>
+        /// <param name="length">闀垮害</param>
+        /// <param name="width">瀹藉害</param>
+        /// <param name="height">楂樺害</param>
+        /// <returns>
+        /// 杩斿洖鍏冪粍鍖呭惈涓変釜鍊硷細 <br/>
+        /// Item1 - 鏄惁鎴愬姛鑾峰彇浣嶇疆 <br/>
+        /// Item2 - 鑾峰彇鍒扮殑浠诲姟浣嶇疆瀵硅薄锛屽彲鑳戒负null <br/>
+        /// Item3 - 閿欒浠g爜锛屾垚鍔熸椂杩斿洖绌哄瓧绗︿覆
+        /// </returns>
         (bool, TaskPosition?, string) GetPosition(int orderId, string orderNo, int length, int width, int height);
 
+        /// <summary>
+        /// 鑾峰彇鎸囧畾瀹瑰櫒涓殑鍙敤浣嶇疆
+        /// </summary>
+        /// <param name="container">鐩爣瀹瑰櫒瀵硅薄</param>
+        /// <param name="length">寰呮斁缃墿鍝侀暱搴�</param>
+        /// <param name="width">寰呮斁缃墿鍝佸搴�</param>
+        /// <param name="height">寰呮斁缃墿鍝侀珮搴�</param>
+        /// <returns>鍏冪粍鍖呭惈锛� <br/>
+        ///   - bool: 鏄惁鎵惧埌鍚堥�備綅缃� <br/>
+        ///   - TaskPosition?: 鎵惧埌鐨勪换鍔′綅缃俊鎭�(鍙负null) <br/>
+        ///   - string: 閿欒浠g爜(鎴愬姛鏃惰繑鍥炵┖瀛楃涓�)
+        /// </returns>
+        /// <remarks>
+        /// 鏂规硶浼氭鏌ュ鍣ㄥ昂瀵告槸鍚︽弧瓒崇墿鍝佹斁缃姹傦紝 <br/>
+        /// 骞惰�冭檻瀹瑰櫒杈圭紭鎯呭喌璁$畻鏈�浣虫斁缃綅缃�
+        /// </remarks>
+        (bool, TaskPosition?, string) GetPosition(Dt_Container container, int length, int width, int height);
+
+        /// <summary>
+        /// 閲婃斁鎸囧畾瀹瑰櫒鍙婂叾鍏宠仈椤�
+        /// </summary>
+        /// <param name="keys">瀹瑰櫒ID鏁扮粍</param>
+        /// <returns>鎿嶄綔缁撴灉鍝嶅簲</returns>
+        /// <remarks>
+        /// 1. 鏌ヨ骞惰幏鍙栨寚瀹氬鍣ㄥ強鍏跺叧鑱旈」 <br/>
+        /// 2. 鏇存柊瀹瑰櫒鐘舵�佷负绌洪棽 <br/>
+        /// 3. 鍦ㄤ簨鍔′腑鎵ц浠ヤ笅鎿嶄綔锛� <br/>
+        ///    - 鍒犻櫎瀹瑰櫒椤瑰苟绉诲叆鍘嗗彶琛� <br/>
+        ///    - 鍒犻櫎璁㈠崟瀹瑰櫒鍏宠仈骞剁Щ鍏ュ巻鍙茶〃 <br/>
+        ///    - 鏇存柊瀹瑰櫒鐘舵�� <br/>
+        /// 4. 鎿嶄綔鎴愬姛杩斿洖OK锛屽け璐ュ洖婊氫簨鍔″苟杩斿洖閿欒淇℃伅
+        /// </remarks>
         WebResponseContent ReleaseContainer(int[] keys);
+
+        WebResponseContent AutoReleaseContainer(int[] keys);
+
+        /// <summary>
+        /// 鑷姩閲婃斁瀹瑰櫒
+        /// </summary>
+        /// <param name="containerCode">瀹瑰櫒缂栧彿</param>
+        /// <returns>Web鍝嶅簲缁撴灉</returns>
+        /// <remarks>
+        /// 1. 鏍规嵁瀹瑰櫒缂栧彿鏌ヨ瀹瑰櫒淇℃伅 <br/>
+        /// 2. 妫�鏌ュ鍣ㄦ槸鍚﹀瓨鍦ㄥ叧鑱斾换鍔� <br/>
+        /// 3. 鑻ユ棤浠诲姟鍒欐竻绌哄鍣ㄧ姸鎬佸苟鍒犻櫎璁㈠崟瀹瑰櫒璁板綍 <br/>
+        /// 4. 鑻ユ湁浠诲姟鍒欐洿鏂颁换鍔$姸鎬佷负"榫欓棬鏋堕噸鏂板垎閰�" <br/>
+        /// 5. 浜嬪姟澶勭悊鎵�鏈夋暟鎹簱鎿嶄綔
+        /// </remarks>
+        WebResponseContent AutoReleaseContainer(string containerCode);
+
+        /// <summary>
+        /// 鑾峰彇寮傚父宸ヤ綅浣嶇疆
+        /// </summary>
+        /// <param name="length">鐗╁搧闀垮害</param>
+        /// <param name="width">鐗╁搧瀹藉害</param>
+        /// <param name="height">鐗╁搧楂樺害</param>
+        /// <returns>鍏冪粍鍖呭惈涓変釜鍊硷細鏄惁鎴愬姛鑾峰彇銆佷换鍔′綅缃璞�(澶辫触鏃朵负null)銆侀敊璇俊鎭�(鎴愬姛鏃朵负绌�)</returns>
+        /// <remarks>
+        /// 褰撳紓甯稿鍣ㄤ腑鐗╁搧鏁伴噺鈮�5鏃讹紝浣跨敤鍥哄畾Z杞翠綅缃�99锛涘惁鍒欐牴鎹綋鍓嶇墿鍝佹暟閲忚绠椾綅缃�
+        /// </remarks>
+        (bool, TaskPosition?, string) GetExceptionPosition(int length, int width, int height);
     }
 }
\ No newline at end of file

--
Gitblit v1.9.3