55 lines
2.3 KiB
C#
55 lines
2.3 KiB
C#
|
using YY.Admin.Core.Entity;
|
|||
|
|
|
|||
|
|
namespace YY.Admin.Core.Services;
|
|||
|
|
|
|||
|
|
public record WarehouseAreaPageResult(List<MesXslWarehouseArea> Records, long Total, int PageNo, int PageSize);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 库区管理服务（CRUD + 状态切换 + 编码校验）。
|
|||
|
|
/// 走 jeecg 免密接口 /xslmes/mesXslWarehouseArea/anon/*。
|
|||
|
|
///
|
|||
|
|
/// 注意：本接口契约不可随意改签名，被以下调用方引用：
|
|||
|
|
/// - WarehouseAreaListViewModel（列表/筛选/启停/删除）
|
|||
|
|
/// - WarehouseAreaEditDialogViewModel（新增/编辑/校验）
|
|||
|
|
/// - WarehouseAreaPickerDialogViewModel（拆码明细库位选择弹窗）
|
|||
|
|
/// </summary>
|
|||
|
|
public interface IWarehouseAreaService
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 分页查询。参数顺序与 WarehouseAreaListViewModel 调用一致：
|
|||
|
|
/// pageNo, pageSize, areaCode, areaName, warehouseId, status。
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="status">"0" 启用 / "1" 停用 / "" 或 null 表示不限</param>
|
|||
|
|
Task<WarehouseAreaPageResult> PageAsync(
|
|||
|
|
int pageNo,
|
|||
|
|
int pageSize,
|
|||
|
|
string? areaCode = null,
|
|||
|
|
string? areaName = null,
|
|||
|
|
string? warehouseId = null,
|
|||
|
|
string? status = null,
|
|||
|
|
CancellationToken ct = default);
|
|||
|
|
|
|||
|
|
/// <summary>按 ID 查单条。</summary>
|
|||
|
|
Task<MesXslWarehouseArea?> GetByIdAsync(string id, CancellationToken ct = default);
|
|||
|
|
|
|||
|
|
/// <summary>新增库区。后端会校验 areaCode 重复。</summary>
|
|||
|
|
Task<bool> AddAsync(MesXslWarehouseArea area, CancellationToken ct = default);
|
|||
|
|
|
|||
|
|
/// <summary>编辑库区（按 ID）。</summary>
|
|||
|
|
Task<bool> EditAsync(MesXslWarehouseArea area, CancellationToken ct = default);
|
|||
|
|
|
|||
|
|
/// <summary>按 ID 删除。</summary>
|
|||
|
|
Task<bool> DeleteAsync(string id, CancellationToken ct = default);
|
|||
|
|
|
|||
|
|
/// <summary>切换启停状态：传入目标状态 "0"=启用 / "1"=停用。</summary>
|
|||
|
|
Task<bool> UpdateStatusAsync(string id, string newStatus, CancellationToken ct = default);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 校验库区编码是否可用（不存在则可用）。
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="areaCode">待校验的库区编码</param>
|
|||
|
|
/// <param name="excludeId">编辑时排除自身 ID；新增传 null 或空</param>
|
|||
|
|
/// <returns>true=可用（无重复），false=已被占用</returns>
|
|||
|
|
Task<bool> CheckAreaCodeAsync(string areaCode, string? excludeId, CancellationToken ct = default);
|
|||
|
|
}
|