using Apimanager_backend.Dtos;

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);
    }
}