57 lines
2.1 KiB
C#
57 lines
2.1 KiB
C#
using Apimanager_backend.Dtos;
|
||
using Apimanager_backend.Models;
|
||
|
||
namespace Apimanager_backend.Services
|
||
{
|
||
public interface IAdminService
|
||
{
|
||
/// <summary>
|
||
/// 禁用用户，使其无法登录。
|
||
/// </summary>
|
||
/// <param name="userId">要禁用的用户ID</param>
|
||
/// <returns>异步操作</returns>
|
||
Task BanUserAsync(int userId);
|
||
/// <summary>
|
||
/// 取消禁用用户，恢复登录权限。
|
||
/// </summary>
|
||
/// <param name="userId">要取消禁用的用户ID</param>
|
||
/// <returns>异步操作</returns>
|
||
Task UnbanUserAsync(int userId);
|
||
/// <summary>
|
||
/// 获取分页的用户列表。
|
||
/// </summary>
|
||
/// <param name="page">要获取的页码，从1开始</param>
|
||
/// <param name="pageSize">每页的用户数量</param>
|
||
/// <param name="desc">是否按降序排序</param>
|
||
/// <returns>包含用户信息的 <see cref="List{UserInfoDto}"/></returns>
|
||
Task<List<UserInfoDto>> GetUsersAsync(int page, int pageSize, bool desc);
|
||
/// <summary>
|
||
/// 创建新用户。
|
||
/// </summary>
|
||
/// <param name="user">包含新用户信息的 <see cref="CreateUserDto"/></param>
|
||
/// <returns>创建成功的用户信息 <see cref="UserInfoDto"/></returns>
|
||
Task<UserInfoDto> CreateUserAsync(CreateUserDto user);
|
||
/// <summary>
|
||
/// 删除指定的用户。
|
||
/// </summary>
|
||
/// <param name="userId">用户ID</param>
|
||
/// <returns>异步操作</returns>
|
||
Task DeleteUserAsync(int userId);
|
||
/// <summary>
|
||
/// 修改用户信息
|
||
/// </summary>
|
||
/// <returns></returns>
|
||
Task<UserInfoDto> UpdateUserAsync(int userId, AdminUpdateUserDto dto);
|
||
/// <summary>
|
||
/// 用户总数
|
||
/// </summary>
|
||
/// <returns></returns>
|
||
Task<int> UserCountAsync();
|
||
/// <summary>
|
||
/// 获取角色列表
|
||
/// </summary>
|
||
/// <returns></returns>
|
||
Task<List<UserRole>> GetRolesAsync();
|
||
}
|
||
}
|