IStorageLocationRepository.cs 1.96 KB
using Rcs.Domain.Entities;

namespace Rcs.Domain.Repositories;

/// <summary>
/// 库位仓储接口
/// @author zzy
/// </summary>
public interface IStorageLocationRepository : IRepository<StorageLocation>
{
    /// <summary>
    /// 根据库区ID获取库位列表
    /// </summary>
    Task<IEnumerable<StorageLocation>> GetByAreaIdAsync(Guid areaId, CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据库位编码获取库位
    /// </summary>
    Task<StorageLocation?> GetByLocationCodeAsync(string locationCode, CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据地图节点ID获取库位
    /// </summary>
    Task<IEnumerable<StorageLocation>> GetByMapNodeIdAsync(Guid mapNodeId, CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据状态获取库位列表
    /// </summary>
    Task<IEnumerable<StorageLocation>> GetByStatusAsync(StorageLocationStatus status, CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据地图ID获取库位列表(通过MapNode关联)
    /// @author zzy
    /// </summary>
    Task<IEnumerable<StorageLocation>> GetByMapIdAsync(Guid mapId, CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据区域ID获取第一个空闲库位(按编码排序)
    /// @author zzy
    /// </summary>
    Task<StorageLocation?> GetFirstEmptyByAreaIdAsync(Guid areaId, CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据多边形区域查找区域内的空货位
    /// @author zzy
    /// </summary>
    /// <param name="mapId">地图ID</param>
    /// <param name="polygon">多边形区域</param>
    /// <param name="cancellationToken">取消令牌</param>
    /// <returns>区域内的空货位列表</returns>
    Task<IEnumerable<StorageLocation>> GetEmptyLocationsInPolygonAsync(Guid mapId, NetTopologySuite.Geometries.Polygon polygon, CancellationToken cancellationToken = default);
}