package com.ruoyi.system.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.system.dto.BigGiftPlaceOrderDTO;
import com.ruoyi.system.model.TBigGiftPackageOrder;
import com.ruoyi.system.query.BigGiftPackageOrderQuery;
import com.ruoyi.system.vo.PlaceOrderVO;

import java.util.List;

/**
 * <p>
 * 大礼包订单 服务类
 * </p>
 *
 * @author xiaochen
 * @since 2025-12-08
 */
public interface TBigGiftPackageOrderService extends IService<TBigGiftPackageOrder> {

    List<TBigGiftPackageOrder> pageList(Page<TBigGiftPackageOrder> tBigGiftPackageOrderPage, BigGiftPackageOrderQuery query);


    List<TBigGiftPackageOrder> export(BigGiftPackageOrderQuery query);

    /**
     * 大礼包下单
     *
     * @param dto       下单请求参数
     * @param appUserId 用户ID
     * @param openid    用户微信openid
     * @return 下单结果（包含订单信息和支付参数）
     */
    PlaceOrderVO placeOrder(BigGiftPlaceOrderDTO dto, Integer appUserId, String openid);

    /**
     * 大礼包尾款支付
     *
     * @param orderId   订单ID
     * @param appUserId 用户ID
     * @param openid    用户微信openid
     * @return 支付结果（包含订单信息和支付参数）
     */
    PlaceOrderVO payFinalPayment(Integer orderId, Integer appUserId, String openid);

}