package com.aurora.mapper;

import com.aurora.model.dto.UniqueViewDTO;// 导入独立访客数据传输对象（UniqueViewDTO），用于前台数据展示，通常包含统计结果
import com.aurora.entity.UniqueView;// 导入独立访客实体类（UniqueView），该实体类与数据库中的独立访客统计表（如 unique_view）相对应
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.Date;// 导入 Java 的 Date 类，用于处理时间范围参数
import java.util.List;// 导入 Java 集合框架中的 List 接口，用于返回多个 UniqueViewDTO 对象的集合

@Repository
public interface UniqueViewMapper extends BaseMapper<UniqueView> {
    // 自定义查询方法：根据时间范围查询独立访客统计列表（通常用于图表展示或数据分析）
    // startTime: 统计开始时间，endTime: 统计结束时间，用于限定查询的时间范围（如查询某一天的UV数据）
    // 返回 UniqueViewDTO 列表，每个对象可能包含统计时间点（如日期）和对应的独立访客数量
    List<UniqueViewDTO> listUniqueViews(@Param("startTime") Date startTime, @Param("endTime") Date endTime);

}