using System;
|
using System.Collections.Generic;
|
using System.Linq;
|
using System.Text;
|
using System.Threading.Tasks;
|
using WIDESEAWCS_Common;
|
using WIDESEAWCS_Core;
|
using WIDESEAWCS_Core.BaseServices;
|
using WIDESEAWCS_DTO.PlacedBlockDTO;
|
using WIDESEAWCS_DTO.TaskInfo;
|
using WIDESEAWCS_Model.Models;
|
|
namespace WIDESEAWCS_IBasicInfoService
|
{
|
public interface IContainerService : IService<Dt_Container>
|
{
|
/// <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>返回任务位置信息，若放置失败则返回null</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 - 错误代码，成功时返回空字符串
|
/// </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: 错误代码(成功时返回空字符串)
|
/// </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);
|
}
|
}
|
