using MiAssessment.Admin.Business.Models;
using MiAssessment.Admin.Business.Models.User;

namespace MiAssessment.Admin.Business.Services.Interfaces;

/// <summary>
/// �û�ҵ�����ӿ�
/// </summary>
public interface IUserBusinessService
{
    #region 用户列表和详情（旧接口 - 兼容）

    /// <summary>
    /// 获取用户列表（旧接口）
    /// </summary>
    /// <param name="request">查询参数</param>
    /// <returns>分页用户列表</returns>
    Task<PagedResult<UserListResponse>> GetUserListAsync(UserListRequest request);

    #endregion

    #region �û��б������飨�½ӿ� - Requirements 9.1-9.7��

    /// <summary>
    /// ��ȡC���û��б�
    /// </summary>
    /// <param name="request">��ѯ����</param>
    /// <returns>��ҳ�û��б�</returns>
    Task<PagedResult<UserDto>> GetUserListAsync(UserQueryRequest request);

    /// <summary>
    /// ��ȡC���û�����
    /// </summary>
    /// <param name="id">�û�ID</param>
    /// <returns>�û�����</returns>
    Task<UserDetailDto?> GetUserDetailAsync(long id);

    /// <summary>
    /// �����û�״̬
    /// </summary>
    /// <param name="id">�û�ID</param>
    /// <param name="status">״̬��0���� 1����</param>
    /// <returns>�Ƿ�ɹ�</returns>
    Task<bool> UpdateUserStatusAsync(long id, int status);

    /// <summary>
    /// �����û��ȼ�
    /// </summary>
    /// <param name="id">�û�ID</param>
    /// <param name="userLevel">�û��ȼ���1��ͨ�û� 2�ϻ��� 3�����ϻ���</param>
    /// <returns>�Ƿ�ɹ�</returns>
    Task<bool> UpdateUserLevelAsync(long id, int userLevel);

    /// <summary>
    /// 导出用户列表
    /// </summary>
    /// <param name="request">查询参数</param>
    /// <returns>导出数据</returns>
    Task<List<UserDto>> ExportUsersAsync(UserQueryRequest request);

    /// <summary>
    /// 删除用户（硬删除，同时清除登录记录和令牌）
    /// </summary>
    /// <param name="id">用户ID</param>
    /// <returns>是否成功</returns>
    Task<bool> DeleteUserAsync(long id);

    #endregion

    #region ״̬�������ɽӿ� - ���ݣ�

    /// <summary>
    /// �����û�״̬�����/��⣩
    /// </summary>
    /// <param name="userId">�û�ID</param>
    /// <param name="status">״̬��1-���� 0-����</param>
    /// <returns>�Ƿ�ɹ�</returns>
    Task<bool> SetUserStatusAsync(long userId, int status);

    /// <summary>
    /// ���ò����˺ű�ʶ
    /// </summary>
    /// <param name="userId">�û�ID</param>
    /// <param name="isTest">�Ƿ�����˺ţ�0-�� 1-��</param>
    /// <returns>�Ƿ�ɹ�</returns>
    Task<bool> SetTestAccountAsync(long userId, int isTest);

    /// <summary>
    /// ����û��ֻ���
    /// </summary>
    /// <param name="userId">�û�ID</param>
    /// <returns>�Ƿ�ɹ�</returns>
    Task<bool> ClearMobileAsync(long userId);

    /// <summary>
    /// ����û�΢�Ű󶨣������µ����openid��
    /// </summary>
    /// <param name="userId">�û�ID</param>
    /// <returns>�Ƿ�ɹ�</returns>
    Task<bool> ClearWeChatAsync(long userId);

    #endregion

    #region �û�������أ��ɽӿ� - ���ݣ�

    /// <summary>
    /// ��ȡ�û�IP��¼��ʷ
    /// </summary>
    /// <param name="userId">�û�ID</param>
    /// <param name="page">ҳ��</param>
    /// <param name="pageSize">ÿҳ����</param>
    /// <returns>IP��¼��ʷ�б�</returns>
    Task<PagedResult<IpLogItem>> GetUserIpLogsAsync(long userId, int page, int pageSize);

    /// <summary>
    /// ���û��ֻ���
    /// </summary>
    /// <param name="userId">�û�ID</param>
    /// <param name="mobile">�ֻ���</param>
    /// <returns>�Ƿ�ɹ�</returns>
    Task<bool> BindMobileAsync(long userId, string mobile);

    #endregion
}