using Dlhis.Basic.Device.Request;
using Dlhis.Basic.Device.Response;
using Kurisu.AspNetCore.DataAccess.Dto;

namespace Dlhis.Basic.Device.Services;
/// <summary>
/// 例外人员权限分配服务接口，定义了对设备权限进行手动分配、查询及清理的相关操作。
/// </summary>
public interface IDevicePermissionManuallyService : IScopeDependency
{
    /// <summary>
    /// 获取例外分配的分页数据。
    /// </summary>
    /// <param name="requestDto">分页及筛选请求参数。</param>
    /// <returns>包含例外分配信息的分页结果。</returns>
    Task<Pagination<DevicePermissionManuallyResponse>> GetPageAsync(DevicePermissionManuallyRequest requestDto);

    /// <summary>
    /// 添加新的例外分配记录。
    /// </summary>
    /// <param name="request">例外分配添加请求参数。</param>
    /// <returns>异步操作任务。</returns>
    Task AddAsync(DevicePermissionManuallyAddRequest request);

    /// <summary>
    /// 根据主键删除指定的例外分配记录。
    /// </summary>
    /// <param name="id">要删除的记录主键ID。</param>
    /// <returns>异步操作任务。</returns>
    Task DeleteAsync(long id);

    /// <summary>
    /// 批量删除例外分配记录。
    /// </summary>
    /// <param name="ids">要删除的记录主键ID集合。</param>
    /// <returns>异步操作任务。</returns>
    Task DeleteAsync(List<long> ids);

    /// <summary>
    /// 清除指定用户的所有设备例外权限。
    /// </summary>
    /// <param name="userNo">用户编号。</param>
    /// <returns>异步操作任务。</returns>
    Task ClearUserDeviceManuallyPermissionsAsync(string userNo);

    /// <summary>
    /// 清除指定工厂下指定用户的所有设备权限。
    /// </summary>
    /// <param name="factory">工厂编码。</param>
    /// <param name="userCode">用户编码。</param>
    /// <returns>异步操作任务。</returns>
    Task ClearAllDevicePermissions(string factory, string userCode);
}