IOT_API/Service/Interface/System/IRoleService.cs

using Model;
using Model.Dto.System;
using SqlSugar;
using System.Collections.Generic;
using System.Threading.Tasks;

namespace Service.Interface
{
    /// <summary>
    /// 角色权限管理 服务接口
    /// </summary>
    public interface IRoleService
    {
        /// <summary>分页查询角色列表（关键字匹配编码/名称）</summary>
        Task<Result<List<RoleDto>>> GetPagedAsync(int pageIndex, int pageSize, RefAsync<int> total, string? keyword = null);

        Task<Result<RoleDto>> GetByIdAsync(long id);

        /// <summary>新增角色（校验编码唯一）</summary>
        Task<Result<RoleDto>> AddAsync(RoleDto dto);

        /// <summary>修改角色（系统内置角色不允许改编码）</summary>
        Task<Result<RoleDto>> UpdateAsync(RoleDto dto);

        /// <summary>删除角色（系统内置角色不可删；有关联用户时不可删）</summary>
        Task<Result> DeleteAsync(long id);

        /// <summary>分配权限（全量覆盖该角色的权限关联）</summary>
        Task<Result> AssignPermissionsAsync(long roleId, List<long> permissionIds);

        /// <summary>角色下拉选项</summary>
        Task<Result<List<RoleOptionDto>>> GetOptionsAsync();

        /// <summary>查询全部权限列表</summary>
        Task<Result<List<PermissionDto>>> GetPermissionsAsync();
    }
}