using Apimanager_backend.Dtos;
using Apimanager_backend.Models;
using System.Runtime.CompilerServices;

namespace Apimanager_backend.Services
{
    public interface IUserService
    {
         /// <summary>
    /// 登录用户，根据用户名和密码进行身份验证。
    /// </summary>
    /// <param name="username">用户名</param>
    /// <param name="password">密码</param>
    /// <returns>包含用户信息的 <see cref="UserInfoDto"/></returns>
    Task<UserInfoDto> LoginAsync(string username, string password);

    /// <summary>
    /// 发送密码重置邮件到指定邮箱。
    /// </summary>
    /// <param name="email">用户注册的邮箱地址</param>
    /// <returns>异步操作</returns>
    Task SendResetPasswordEmailAsync(string email);

    /// <summary>
    /// 重置用户密码，验证重置令牌的有效性并更新密码。
    /// </summary>
    /// <param name="email">用户邮箱地址</param>
    /// <param name="token">重置密码的令牌</param>
    /// <param name="newPassword">新的密码</param>
    /// <returns>异步操作</returns>
    Task ResetPasswordAsync(string email, string token, string newPassword);

    /// <summary>
    /// 获取用户信息。
    /// </summary>
    /// <param name="username">用户名</param>
    /// <returns>包含用户信息的 <see cref="UserInfoDto"/></returns>
    Task<UserInfoDto> GetUserAsync(string username);

    /// <summary>
    /// 更新用户信息。
    /// </summary>
    /// <param name="user">包含更新信息的 <see cref="UpdateUserDto"/></param>
    /// <returns>更新后的 <see cref="UserInfoDto"/></returns>
    Task<UserInfoDto> UpdateUserAsync(UpdateUserDto user);

    /// <summary>
    /// 删除指定的用户。
    /// </summary>
    /// <param name="username">要删除的用户名</param>
    /// <returns>异步操作</returns>
    Task DeleteUserAsync(string username);

    /// <summary>
    /// 创建新用户。
    /// </summary>
    /// <param name="user">包含新用户信息的 <see cref="CreateUserDto"/></param>
    /// <returns>创建成功的用户信息 <see cref="UserInfoDto"/></returns>
    Task<UserInfoDto> CreateUserAsync(CreateUserDto user);

    /// <summary>
    /// 禁用用户，使其无法登录。
    /// </summary>
    /// <param name="username">要禁用的用户名</param>
    /// <returns>异步操作</returns>
    Task BanUserAsync(string username);

    /// <summary>
    /// 取消禁用用户，恢复登录权限。
    /// </summary>
    /// <param name="username">要取消禁用的用户名</param>
    /// <returns>异步操作</returns>
    Task UnbanUserAsync(string username);

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