package com.ruoyi.jarvis.mapper;

import com.ruoyi.jarvis.domain.OrderRows;
import org.apache.ibatis.annotations.Param;

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

/**
 * 京粉订单Mapper接口
 *
 * @author ruoyi
 */
public interface OrderRowsMapper
{
    /**
     * 查询京粉订单
     *
     * @param id 京粉订单主键
     * @return 京粉订单
     */
    public OrderRows selectOrderRowsById(String id);

    /**
     * 查询京粉订单列表
     *
     * @param orderRows 京粉订单
     * @return 京粉订单集合
     */
    public List<OrderRows> selectOrderRowsList(OrderRows orderRows);

    /**
     * 查询京粉订单列表（支持日期范围过滤和排除特定unionId）
     *
     * @param orderRows 京粉订单
     * @param beginTime 开始时间
     * @param endTime 结束时间
     * @param excludeUnionIds 排除的unionId列表
     * @return 京粉订单集合
     */
    public List<OrderRows> selectOrderRowsListWithFilter(@Param("orderRows") OrderRows orderRows, @Param("beginTime") Date beginTime, @Param("endTime") Date endTime, @Param("excludeUnionIds") List<Long> excludeUnionIds);

    /**
     * 新增京粉订单
     *
     * @param orderRows 京粉订单
     * @return 结果
     */
    public int insertOrderRows(OrderRows orderRows);

    /**
     * 修改京粉订单
     *
     * @param orderRows 京粉订单
     * @return 结果
     */
    public int updateOrderRows(OrderRows orderRows);

    /**
     * 删除京粉订单
     *
     * @param id 京粉订单主键
     * @return 结果
     */
    public int deleteOrderRowsById(String id);

    /**
     * 批量删除京粉订单
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteOrderRowsByIds(String[] ids);

    /**
     * 根据订单ID查询京粉订单
     *
     * @param orderId 订单ID
     * @return 京粉订单
     */
    public OrderRows selectOrderRowsByOrderId(String orderId);

    /**
     * 根据礼金Key查询订单列表
     *
     * @param giftCouponKey 礼金Key
     * @return 订单列表
     */
    public List<OrderRows> selectOrderRowsByGiftCouponKey(@Param("giftCouponKey") String giftCouponKey);
}
