package com.xy.xyaicpzs.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.xy.xyaicpzs.domain.entity.LotteryDraws;

import java.util.Date;
import java.util.List;

/**
* @author XY003
* @description 针对表【lottery_draws(彩票开奖信息表)】的数据库操作Service
* @createDate 2025-06-14 16:41:29
*/
public interface LotteryDrawsService extends IService<LotteryDraws> {

    /**
     * 获取近期开奖信息
     * @param limit 获取条数，默认15条
     * @return 开奖信息列表，按开奖期号倒序排列
     */
    List<LotteryDraws> getRecentDraws(Integer limit);

    /**
     * 根据期号精准查询开奖信息
     * @param drawId 开奖期号
     * @return 开奖信息
     */
    LotteryDraws getByDrawId(Long drawId);

    /**
     * 根据日期范围查询开奖信息
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 开奖信息列表，按开奖期号倒序排列
     */
    List<LotteryDraws> getByDateRange(Date startDate, Date endDate);

    /**
     * 综合查询开奖信息
     * @param drawId 开奖期号（可选）
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 开奖信息列表
     */
    List<LotteryDraws> queryDraws(Long drawId, Date startDate, Date endDate);

}
