package com.kexue.skills.mapper;

import com.kexue.skills.entity.ExchangeCode;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.math.BigDecimal;
import java.util.List;

/**
 * (ExchangeCode)表数据库访问层
 *
 * @author 系统生成
 * @since 2026-05-14
 */
@Mapper
public interface ExchangeCodeMapper {

    /**
     * 通过主键查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    ExchangeCode queryById(Long id);

    /**
     * 通过兑换码查询数据
     *
     * @param code 兑换码
     * @return 实例对象
     */
    ExchangeCode queryByCode(String code);

    /**
     * 分页查询
     *
     * @param exchangeCode 查询条件
     * @return 结果列表
     */
    List<ExchangeCode> getPageList(ExchangeCode exchangeCode);

    /**
     * 查询列表
     *
     * @param exchangeCode 查询条件
     * @return 结果列表
     */
    List<ExchangeCode> getList(ExchangeCode exchangeCode);

    /**
     * 新增数据
     *
     * @param exchangeCode 实例对象
     * @return 影响行数
     */
    int insert(ExchangeCode exchangeCode);

    /**
     * 批量新增数据
     *
     * @param list 实例对象列表
     * @return 影响行数
     */
    int batchInsert(@Param("list") List<ExchangeCode> list);

    /**
     * 更新数据
     *
     * @param exchangeCode 实例对象
     * @return 影响行数
     */
    int update(ExchangeCode exchangeCode);

    /**
     * 使用兑换码
     *
     * @param id        主键
     * @param usedUserId 使用用户ID
     * @return 影响行数
     */
    int useCode(@Param("id") Long id, @Param("usedUserId") Long usedUserId);

    /**
     * 通过主键删除
     *
     * @param id 主键
     * @return 影响行数
     */
    int deleteById(Long id);

    /**
     * 逻辑删除
     *
     * @param id       主键
     * @param updateBy 更新人
     * @return 影响行数
     */
    int logicDeleteById(@Param("id") Long id, @Param("updateBy") String updateBy);

    /**
     * 统计各状态数量
     *
     * @return 统计结果
     */
    List<ExchangeCode> countByStatus();

    /**
     * 根据套餐价格查询可用兑换码数量
     *
     * @param packagePrice 套餐价格
     * @return 数量
     */
    int countAvailableByPrice(BigDecimal packagePrice);
}