package com.aurora.service;

import com.aurora.model.dto.*;
import com.aurora.model.vo.*;

import java.util.List;
//该接口处理用户注册、登录、密码管理、第三方认证和用户信息查询等功能
public interface UserAuthService {

    void sendCode(String username);//向指定用户发送验证码（用于注册、登录或安全操作验证）,该方法发送一次性验证码，并设置有效期和防刷机制

    List<UserAreaDTO> listUserAreas(ConditionVO conditionVO);

    void register(UserVO userVO);// 导入用户值对象（UserVO），用于接收前端传递的用户注册或信息修改参数，通常进行参数校验

    void updatePassword(UserVO userVO);//返回结果通常按地域分组统计用户数量，支持按时间范围、用户状态等条件筛选

    void updateAdminPassword(PasswordVO passwordVO);// 导入密码值对象（PasswordVO），专门用于接收密码修改参数，可能包含旧密码、新密码等敏感信息

    PageResultDTO<UserAdminDTO> listUsers(ConditionVO condition);

    UserLogoutStatusDTO logout();//用户退出登录（清除认证状态和令牌信息),该方法使当前用户的登录状态失效，通常包括清除JWT令牌、会话信息和缓存数据
    //@return UserInfoDTO 用户信息数据传输对象，包含QQ登录成功后获取的用户基本信息
    UserInfoDTO qqLogin(QQLoginVO qqLoginVO);// 导入QQ登录值对象（QQLoginVO），用于接收QQ第三方登录所需的参数，如授权码、OpenID等

}