package com.ruoyi.system.service;

import com.ruoyi.common.core.domain.AjaxResult;
import com.ruoyi.common.core.domain.entity.OrderInfo;
import com.ruoyi.common.core.domain.dto.OrderCreateRequest;
import com.ruoyi.common.core.domain.dto.PaymentRequest;
import com.ruoyi.common.core.domain.dto.RefundRequest;
import com.ruoyi.common.core.domain.vo.OrderInfoVO;

import java.util.List;

/**
 * 【请填写功能名称】Service接口
 * 
 * @author ruoyi
 * @date 2025-08-03
 */
public interface IOrderInfoService 
{
    /**
     * 查询【请填写功能名称】
     * 
     * @param id 【请填写功能名称】主键
     * @return 【请填写功能名称】
     */
    public OrderInfo selectOrderInfoById(String id);

    /**
     * 查询【请填写功能名称】列表
     * 
     * @param orderInfo 【请填写功能名称】
     * @return 【请填写功能名称】集合
     */
    public List<OrderInfo> selectOrderInfoList(OrderInfo orderInfo);

    /**
     * 新增【请填写功能名称】
     * 
     * @param orderInfo 【请填写功能名称】
     * @return 结果
     */
    public int insertOrderInfo(OrderInfo orderInfo);

    /**
     * 修改【请填写功能名称】
     * 
     * @param orderInfo 【请填写功能名称】
     * @return 结果
     */
    public int updateOrderInfo(OrderInfo orderInfo);

    /**
     * 批量删除【请填写功能名称】
     * 
     * @param ids 需要删除的【请填写功能名称】主键集合
     * @return 结果
     */
    public int deleteOrderInfoByIds(String[] ids);

    /**
     * 删除【请填写功能名称】信息
     * 
     * @param id 【请填写功能名称】主键
     * @return 结果
     */
    public int deleteOrderInfoById(String id);

    /**
     * 创建订单
     * 
     * @param request 订单创建请求
     * @return 结果
     */
    AjaxResult createOrder(OrderCreateRequest request);

    /**
     * 支付订单
     * 
     * @param request 支付请求
     * @return 结果
     */
    AjaxResult payOrder(PaymentRequest request);

    /**
     * 完成支付(支付回调)
     * 
     * @param orderId 订单ID
     * @param tradeNo 第三方交易号
     * @param payType 支付方式
     * @return 结果
     */
    AjaxResult completePayment(String orderId, String tradeNo, String payType);

    /**
     * 确认出货
     * 
     * @param orderId 订单ID
     * @return 结果
     */
    AjaxResult confirmShipment(String orderId);

    /**
     * 申请退款
     * 
     * @param request 退款请求
     * @return 结果
     */
    AjaxResult refundOrder(RefundRequest request);

    /**
     * 查询用户订单列表
     * 
     * @param userId 用户ID
     * @return 订单列表
     */
    List<OrderInfo> selectUserOrders(Long userId);

    /**
     * 查询订单详情
     * 
     * @param orderId 订单ID
     * @return 订单详情
     */
    OrderInfo selectOrderByOrderId(String orderId);

    /**
     * 查询订单列表(包含用户信息和套餐信息)
     * 
     * @param orderInfo 查询条件
     * @return 订单列表
     */
    List<OrderInfoVO> selectOrderInfoVOList(OrderInfo orderInfo);
}
