ThingsGateway/framework/admin/ThingsGateway.Admin.Application/System/Services/Role/IRoleService.cs

#region copyright
//------------------------------------------------------------------------------
//  此代码版权声明为全文件覆盖，如有原作者特别声明，会在下方手动补充
//  此代码版权（除特别声明外的代码）归作者本人Diego所有
//  源代码使用协议遵循本仓库的开源协议及附加协议
//  Gitee源代码仓库：https://gitee.com/diego2098/ThingsGateway
//  Github源代码仓库：https://github.com/kimdiego2098/ThingsGateway
//  使用文档：https://diego2098.gitee.io/thingsgateway-docs/
//  QQ群：605534569
//------------------------------------------------------------------------------
#endregion

using Furion.DependencyInjection;

namespace ThingsGateway.Admin.Application;

/// <summary>
/// 角色服务
/// </summary>
public interface IRoleService : ITransient
{
    /// <summary>
    /// 添加角色
    /// </summary>
    /// <param name="input">添加参数</param>
    /// <returns></returns>
    Task AddAsync(RoleAddInput input);

    /// <summary>
    /// 删除角色
    /// </summary>
    /// <param name="input">删除参数</param>
    /// <returns></returns>
    Task DeleteAsync(params long[] input);

    /// <summary>
    /// 编辑角色
    /// </summary>
    /// <param name="input">编辑角色</param>
    /// <returns></returns>
    Task EditAsync(RoleEditInput input);

    /// <summary>
    /// 根据用户ID获取用户角色Id集合
    /// </summary>
    /// <param name="userId">用户ID</param>
    /// <returns></returns>
    Task<List<long>> GetRoleIdListByUserIdAsync(long userId);

    /// <summary>
    /// 根据用户ID获取用户角色集合
    /// </summary>
    /// <param name="userId">用户ID</param>
    /// <returns></returns>
    Task<List<SysRole>> GetRoleListByUserIdAsync(long userId);

    /// <summary>
    /// 给角色授权资源
    /// </summary>
    /// <param name="input">授权参数</param>
    /// <returns></returns>
    Task GrantResourceAsync(GrantResourceInput input);

    /// <summary>
    /// 给角色授权用户
    /// </summary>
    /// <param name="input">授权信息</param>
    /// <returns></returns>
    Task GrantUserAsync(GrantUserInput input);
    /// <summary>
    /// 角色拥有资源
    /// </summary>
    /// <param name="input">角色id</param>
    /// <returns>角色拥有资源信息</returns>
    Task<RoleOwnResourceOutput> OwnResourceAsync(long input);

    /// <summary>
    /// 获取角色下的用户
    /// </summary>
    /// <param name="input">角色ID</param>
    /// <returns></returns>
    Task<List<long>> OwnUserAsync(long input);

    /// <summary>
    /// 分页查询角色
    /// </summary>
    /// <param name="input">查询参数</param>
    /// <returns></returns>
    Task<ISqlSugarPagedList<SysRole>> PageAsync(RolePageInput input);

    /// <summary>
    /// 刷新缓存
    /// </summary>
    /// <returns></returns>
    void RefreshCache();

    /// <summary>
    /// 角色刷新资源
    /// </summary>
    Task RefreshResourceAsync(long? menuId = null);
    /// <summary>
    /// 角色选择器
    /// </summary>
    Task<List<SysRole>> RoleSelectorAsync(string searchKey = null);
}