package com.aurora.mapper;
// 导入用户管理数据传输对象（UserAdminDTO），用于后台管理界面展示用户信息，通常包含用户基本属性及扩展字段（如角色信息、状态标识等）
import com.aurora.model.dto.UserAdminDTO;
// 导入用户认证实体类（UserAuth），该实体类与数据库中的用户认证表（如 user_auth）相对应，其字段（如用户名、密码、状态）与表结构映射
import com.aurora.entity.UserAuth;
// 导入条件查询值对象（ConditionVO），用于封装前端传递的复杂查询参数（如关键词、状态、时间范围等）
import com.aurora.model.vo.ConditionVO;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.List;


@Repository
public interface UserAuthMapper extends BaseMapper<UserAuth> {
    //自定义查询方法：分页获取后台用户管理列表（通常用于管理员控制台）
    // conditionVO: 封装查询条件的对象，可能包含用户名关键词、账号状态、注册时间范围等筛选条件
    // 返回 UserAdminDTO 列表，该 DTO 通常扩展了用户基础信息，包含管理所需的附加字段（如角色列表、最后登录时间等）
    List<UserAdminDTO> listUsers(@Param("current") Long current, @Param("size") Long size, @Param("conditionVO") ConditionVO conditionVO);
    // 自定义统计方法：根据条件统计用户数量（通常用于分页查询中的总数计算）
    // conditionVO: 封装统计条件的对象，与 listUsers 方法中的条件一致，确保分页统计的准确性
    // 返回符合条件的用户总数，Integer 类型避免 null 值问题，用于前端分页组件计算总页数
    Integer countUser(@Param("conditionVO") ConditionVO conditionVO);

}