package com.ruoyi.system.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.system.query.AppletOrderListQuery;
import com.ruoyi.system.vo.AppletOrderDetailVO;
import com.ruoyi.system.vo.AppletOrderListVO;

/**
 * 小程序端订单Service
 *
 * @author mitao
 * @since 2025-12-20
 */
public interface AppletOrderService {

    /**
     * 分页查询订单列表
     *
     * @param query     查询条件
     * @param appUserId 用户ID
     * @return 分页结果
     */
    Page<AppletOrderListVO> getOrderList(AppletOrderListQuery query, Integer appUserId);

    /**
     * 获取实物商品订单详情
     *
     * @param orderId   订单ID
     * @param appUserId 用户ID
     * @return 订单详情
     */
    AppletOrderDetailVO getPhysicalOrderDetail(Integer orderId, Integer appUserId);

    /**
     * 获取大礼包订单详情
     *
     * @param orderId   订单ID
     * @param appUserId 用户ID
     * @return 订单详情
     */
    AppletOrderDetailVO getBigGiftOrderDetail(Integer orderId, Integer appUserId);

    /**
     * 实物商品确认收货
     *
     * @param orderId   订单ID
     * @param appUserId 用户ID
     * @return 是否成功
     */
    boolean confirmPhysicalOrder(Integer orderId, Integer appUserId);

    /**
     * 大礼包确认收货
     *
     * @param orderId   订单ID
     * @param appUserId 用户ID
     * @return 是否成功
     */
    boolean confirmBigGiftOrder(Integer orderId, Integer appUserId);
}