package org.dromara.rfid.mapper;

import org.dromara.rfid.domain.RfidReadRecord;
import org.dromara.rfid.domain.vo.RfidReadRecordVo;
import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.core.toolkit.Constants;
import org.apache.ibatis.annotations.Param;
import java.util.List;
import java.util.Collection;

/**
 * 读取记录Mapper接口
 * <p>
 * 支持按日期分表，表名格式：rfid_read_record_yyyyMMdd
 * 所有方法需传入动态表名参数
 * </p>
 *
 * @author zch
 * @date 2025-11-25
 */
public interface RfidReadRecordMapper extends BaseMapperPlus<RfidReadRecord, RfidReadRecordVo> {

    /**
     * 查询读取记录列表（单表）
     *
     * @param tableName    表名
     * @param queryWrapper 条件
     * @return 读取记录集合
     */
    List<RfidReadRecordVo> selectCustomRfidReadRecordVoList(
        @Param("tableName") String tableName,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 查询读取记录列表（多表联合查询，跨日期范围）
     *
     * @param tableNames   表名列表
     * @param queryWrapper 条件
     * @return 读取记录集合
     */
    List<RfidReadRecordVo> selectCustomRfidReadRecordVoListMultiTable(
        @Param("tableNames") List<String> tableNames,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 根据ID查询读取记录详情
     *
     * @param tableName 表名
     * @param id        主键ID
     * @return 读取记录对象
     */
    RfidReadRecordVo selectCustomRfidReadRecordVoById(
        @Param("tableName") String tableName,
        @Param("id") Long id);

    /**
     * 根据ID列表批量查询读取记录
     *
     * @param tableName 表名
     * @param ids       ID集合
     * @return 读取记录集合
     */
    List<RfidReadRecordVo> selectCustomRfidReadRecordVoByIds(
        @Param("tableName") String tableName,
        @Param("ids") Collection<Long> ids);

    /**
     * 统计读取记录数（单表）
     *
     * @param tableName    表名
     * @param queryWrapper 查询条件
     * @return 记录总数
     */
    Long countCustomRfidReadRecord(
        @Param("tableName") String tableName,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 统计读取记录数（多表）
     *
     * @param tableNames   表名列表
     * @param queryWrapper 查询条件
     * @return 记录总数
     */
    Long countCustomRfidReadRecordMultiTable(
        @Param("tableNames") List<String> tableNames,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 分页查询读取记录（单表）
     *
     * @param tableName    表名
     * @param page         分页对象
     * @param queryWrapper 查询条件
     * @return 分页结果
     */
    Page<RfidReadRecordVo> selectCustomRfidReadRecordVoPage(
        @Param("tableName") String tableName,
        @Param("page") Page<RfidReadRecord> page,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 分页查询读取记录（多表联合查询，跨日期范围）
     *
     * @param tableNames   表名列表
     * @param page         分页对象
     * @param queryWrapper 查询条件
     * @return 分页结果
     */
    Page<RfidReadRecordVo> selectCustomRfidReadRecordVoPageMultiTable(
        @Param("tableNames") List<String> tableNames,
        @Param("page") Page<RfidReadRecord> page,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 单条插入读取记录
     *
     * @param tableName 表名
     * @param entity    读取记录对象
     * @return 影响行数
     */
    int insertRfidReadRecord(
        @Param("tableName") String tableName,
        @Param("entity") RfidReadRecord entity);

    /**
     * 批量插入读取记录
     *
     * @param tableName 表名
     * @param list      读取记录对象集合
     * @return 影响行数
     */
    int batchInsertRfidReadRecord(
        @Param("tableName") String tableName,
        @Param("list") List<RfidReadRecord> list);

    /**
     * 单条更新读取记录
     *
     * @param tableName 表名
     * @param entity    读取记录对象
     * @return 影响行数
     */
    int updateRfidReadRecordById(
        @Param("tableName") String tableName,
        @Param("entity") RfidReadRecord entity);

    /**
     * 批量更新读取记录
     *
     * @param tableName 表名
     * @param list      读取记录对象集合
     * @return 影响行数
     */
    int batchUpdateRfidReadRecord(
        @Param("tableName") String tableName,
        @Param("list") List<RfidReadRecord> list);

    /**
     * 根据自定义条件删除读取记录
     *
     * @param tableName    表名
     * @param queryWrapper 删除条件
     * @return 影响行数
     */
    int deleteCustomRfidReadRecord(
        @Param("tableName") String tableName,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 根据ID列表批量删除读取记录
     *
     * @param tableName 表名
     * @param ids       ID集合
     * @return 影响行数
     */
    int deleteCustomRfidReadRecordByIds(
        @Param("tableName") String tableName,
        @Param("ids") Collection<Long> ids);

    /**
     * 检查读取记录是否存在（单表）
     *
     * @param tableName    表名
     * @param queryWrapper 查询条件
     * @return 是否存在
     */
    Boolean existsRfidReadRecord(
        @Param("tableName") String tableName,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 检查读取记录是否存在（多表）
     *
     * @param tableNames   表名列表
     * @param queryWrapper 查询条件
     * @return 是否存在
     */
    Boolean existsRfidReadRecordMultiTable(
        @Param("tableNames") List<String> tableNames,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    // ==================== 看板专用查询方法 ====================

    /**
     * 查询每个设备的最新一条读取记录
     *
     * @param tableName 表名
     * @param deviceIds 设备ID列表（可选）
     * @return 最新读取记录列表
     */
    List<RfidReadRecordVo> selectLatestRecordByDevice(
        @Param("tableName") String tableName,
        @Param("deviceIds") List<Long> deviceIds);

    /**
     * 按小时统计成功率
     *
     * @param tableName 表名
     * @param startTime 开始时间
     * @param endTime   结束时间
     * @return 成功率统计结果
     */
    List<java.util.Map<String, Object>> selectSuccessRateByHour(
        @Param("tableName") String tableName,
        @Param("startTime") String startTime,
        @Param("endTime") String endTime);

    /**
     * 查询告警记录列表
     *
     * @param tableName 表名
     * @param limit     限制数量
     * @return 告警记录列表
     */
    List<RfidReadRecordVo> selectAlarmRecordList(
        @Param("tableName") String tableName,
        @Param("limit") Integer limit);

    // ==================== 采样查询方法（无索引依赖，大数据量优化） ====================

    /**
     * 采样查询读取记录列表（多表）
     * <p>
     * 使用时间槽分组，每 N 分钟取一条代表数据，适用于大数据量场景
     * 无索引依赖，通过 UNIX_TIMESTAMP + FLOOR 计算时间槽
     * </p>
     *
     * @param tableNames       表名列表
     * @param samplingInterval 采样间隔（分钟）
     * @param queryWrapper     查询条件
     * @return 采样后的记录列表
     */
    List<RfidReadRecordVo> selectWithSamplingMultiTable(
        @Param("tableNames") List<String> tableNames,
        @Param("samplingInterval") Integer samplingInterval,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

    /**
     * 采样查询读取记录列表（单表）
     *
     * @param tableName        表名
     * @param samplingInterval 采样间隔（分钟）
     * @param queryWrapper     查询条件
     * @return 采样后的记录列表
     */
    List<RfidReadRecordVo> selectWithSampling(
        @Param("tableName") String tableName,
        @Param("samplingInterval") Integer samplingInterval,
        @Param(Constants.WRAPPER) Wrapper<RfidReadRecord> queryWrapper);

}
