feat(IStockInfoService): 新增 Get3DLayoutAsync 方法签名

wanshenmean

2026-03-30 2d27e688d33998d2244b1b9cc04b942d88c0d4bf

 Code/WMS/WIDESEA_WMSServer/WIDESEA_IStockService/IStockInfoService.cs

@@ -1,46 +1,60 @@
using WIDESEA_Core.BaseRepository;
using WIDESEA_Core.BaseServices;
using WIDESEA_DTO.Stock;
using WIDESEA_Model.Models;

namespace WIDESEA_IStockService
{
    /// <summary>
    /// 库存信息服务接口
    /// </summary>
    public interface IStockInfoService : IService<Dt_StockInfo>
    {
        /// <summary>
        /// 获取库存信息仓储接口
        /// </summary>
        IRepository<Dt_StockInfo> Repository { get; }

        /// <summary>
        /// 获取库存信息列表（出库日期小于当前时间且库存状态为入库完成的记录）
        /// </summary>
        /// <returns></returns>
        public Task<List<Dt_StockInfo>> GetStockInfoAsync();
        /// <returns>库存信息列表</returns>
        Task<List<Dt_StockInfo>> GetStockInfoAsync();

        /// <summary>
        /// 获取库存信息列表（出库日期小于当前时间且库存状态为入库完成的记录，且仓库ID匹配）
        /// </summary>
        /// <param name="WarehouseId"></param>
        /// <returns></returns>
        public Task<List<Dt_StockInfo>> GetStockInfoAsync(int WarehouseId);
        /// <param name="warehouseId">仓库ID</param>
        /// <returns>库存信息列表</returns>
        Task<List<Dt_StockInfo>> GetStockInfoAsync(int warehouseId);

        /// <summary>
        /// 获取库存信息（根据托盘码查询）
        /// </summary>
        /// <param name="PalletCode"></param>
        /// <returns></returns>
        public Task<Dt_StockInfo> GetStockInfoAsync(string PalletCode);
        /// <param name="palletCode">托盘编码</param>
        /// <returns>库存信息</returns>
        Task<Dt_StockInfo> GetStockInfoAsync(string palletCode);

        /// <summary>
        /// 更新库存数据
        /// </summary>
        /// <param name="stockInfo"></param>
        /// <returns></returns>
        public Task<bool> UpdateStockAsync(Dt_StockInfo stockInfo);
        /// <param name="stockInfo">库存信息对象</param>
        /// <returns>更新是否成功</returns>
        Task<bool> UpdateStockAsync(Dt_StockInfo stockInfo);

        /// <summary>
        /// 检索指定托盘在给定位置的库存详细信息。
        /// 检索指定托盘在给定位置的库存详细信息
        /// </summary>
        /// <param name="palletCode">请求库存信息的托盘唯一标识符。不能为 null 或空。</param>
        /// <param name="locationCode">表示托盘存储位置的代码。不能为 null 或空。</param>
        /// <returns>表示异步操作的任务。任务结果包含一个 <see cref="Dt_StockInfo"/> 对象，该对象包含指定托盘和位置的库存详细信息。如果未找到匹配的库存信息，则返回 null。</returns>
        public Task<Dt_StockInfo> GetStockInfoAsync(string palletCode, string locationCode);
        /// <param name="palletCode">托盘编码</param>
        /// <param name="locationCode">货位编码</param>
        /// <returns>库存信息</returns>
        Task<Dt_StockInfo> GetStockInfoAsync(string palletCode, string locationCode);

        /// <summary>
        /// 获取仓库3D布局数据
        /// </summary>
        /// <param name="warehouseId">仓库ID</param>
        /// <returns>3D布局DTO</returns>
        Task<Stock3DLayoutDTO> Get3DLayoutAsync(int warehouseId);
    }
}