package com.fs.qw.mapper;

import java.util.List;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.fs.qw.domain.SignRedPacketRecord;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

/**
 * 签到红包领取记录Mapper接口
 * 
 * @author fs
 * @date 2026-04-14
 */
public interface SignRedPacketRecordMapper extends BaseMapper<SignRedPacketRecord>{
    /**
     * 查询签到红包领取记录
     * 
     * @param id 签到红包领取记录主键
     * @return 签到红包领取记录
     */
    SignRedPacketRecord selectSignRedPacketRecordById(Long id);

    /**
     * 根据用户ID和文章ID查询红包记录（唯一记录）
     * @param userId 用户ID
     * @param articleId 文章ID
     * @return 红包记录，不存在返回 null
     */
    SignRedPacketRecord selectByUserIdAndArticleId(@Param("userId") Long userId,
                                                   @Param("articleId") Long articleId);

    /**
     * 统计指定用户今日领取红包次数
     * @param userId 用户ID
     * @return 今日领取次数
     */
    int countTodayCollectedByUserId(@Param("userId") Long userId);

    /**
     * 查询签到红包领取记录列表
     * 
     * @param signRedPacketRecord 签到红包领取记录
     * @return 签到红包领取记录集合
     */
    List<SignRedPacketRecord> selectSignRedPacketRecordList(SignRedPacketRecord signRedPacketRecord);

    /**
     * 新增签到红包领取记录
     * 
     * @param signRedPacketRecord 签到红包领取记录
     * @return 结果
     */
    int insertSignRedPacketRecord(SignRedPacketRecord signRedPacketRecord);

    /**
     * 修改签到红包领取记录
     * 
     * @param signRedPacketRecord 签到红包领取记录
     * @return 结果
     */
    int updateSignRedPacketRecord(SignRedPacketRecord signRedPacketRecord);

    /**
     * 删除签到红包领取记录
     * 
     * @param id 签到红包领取记录主键
     * @return 结果
     */
    int deleteSignRedPacketRecordById(Long id);

    /**
     * 批量删除签到红包领取记录
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    int deleteSignRedPacketRecordByIds(Long[] ids);

    /**
     * 根据商户订单号查询红包记录
     * @param outBatchNo 商户订单号
     * @return 红包记录
     */
    SignRedPacketRecord selectSignRedPacketRecordByOutBatchNo(String outBatchNo);

    /**
     * 查询用户领取文章红包记录
     * @param articleId 文章id
     * @param userId 用户id
     * @return 用户领取文章红包记录
     */
    @Select("SELECT * FROM sign_red_packet_record WHERE user_id = #{userId} AND  article_id = #{articleId}")
    SignRedPacketRecord selectUserRecord(@Param("userId")Long userId, @Param("articleId")Long articleId);
}
