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.PhysicalGoodsPlaceOrderDTO;
import com.ruoyi.system.model.TPhysicalGoodsOrder;
import com.ruoyi.system.query.BigGiftPackageQuery;
import com.ruoyi.system.vo.PlaceOrderVO;

import java.util.List;

/**
 * <p>
 * 实物商品订单 服务类
 * </p>
 *
 * @author xiaochen
 * @since 2025-12-08
 */
public interface TPhysicalGoodsOrderService extends IService<TPhysicalGoodsOrder> {

    Page<TPhysicalGoodsOrder> pageList(BigGiftPackageQuery query);


    List<TPhysicalGoodsOrder> export(BigGiftPackageQuery query);

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

}