package com.xiaopeng.order.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xiaopeng.api.dto.statistics.OrderStatisticsDTO;
import com.xiaopeng.api.dto.statistics.StatisticsQueryDTO;
import com.xiaopeng.api.model.order.XpOrder;
import com.xiaopeng.api.model.vehicleConvoy.XpVehicle;
import com.xiaopeng.api.vo.order.FareBreakdownVo;
import com.xiaopeng.api.vo.order.XpHistoryEndPointsVo;
import com.xiaopeng.api.vo.order.XpHistoryStartPointsVo;
import com.xiaopeng.api.vo.order.XpPointInfoVo;
import com.xiaopeng.common.core.domain.R;
import com.xiaopeng.common.core.web.page.PageInfo;
import com.xiaopeng.order.model.dto.XpOrderCommentDto;
import com.xiaopeng.order.model.dto.XpOrderPayDto;
import com.xiaopeng.order.model.query.XpHistoryOrderListQuery;
import com.xiaopeng.order.model.query.XpOrderPageQuery;
import com.xiaopeng.order.model.vo.XpOrderDetailVO;
import com.xiaopeng.order.model.vo.XpOrderHistoryVO;
import com.xiaopeng.order.model.vo.XpOrderPageVO;

import java.util.List;

/**
 * <p>
 * 订单 服务类
 * </p>
 *
 * @author mitao
 * @since 2026-02-03
 */
public interface IXpOrderService extends IService<XpOrder> {

    /**
     * 获取订单统计数据
     *
     * @param query 查询参数
     * @return 订单统计数据
     */
    OrderStatisticsDTO getOrderStatistics(StatisticsQueryDTO query);

    /**
     * 订单分页列表
     *
     * @param query 分页查询参数
     * @return 分页结果
     */
    PageInfo<XpOrderPageVO> pageList(XpOrderPageQuery query);

    /**
     * 获取订单详情
     *
     * @param id 订单ID
     * @return 订单详情
     */
    XpOrderDetailVO getOrderDetail(Long id);

    /**
     * 删除订单（逻辑删除）
     *
     * @param id 订单ID
     */
    void deleteOrder(Long id);

    /**
     * 导出订单列表
     *
     * @param query 查询参数
     * @return 订单列表
     */
    List<XpOrderPageVO> exportList(XpOrderPageQuery query);

    /**
     * 取消或关闭订单
     *
     * @param orderId 订单ID
     * @param type 操作类型：1=取消订单，2=关闭订单
     */
    void cancelOrCloseOrder(Long orderId, Integer type);

    /**
     * 改派订单
     *
     * @param orderId 订单ID
     * @param newVehicleId 新车辆ID
     * @param reassignReason 改派原因（可选）
     */
    void reassignOrder(Long orderId, Long newVehicleId, String reassignReason);

    /**
     *  获取用户快捷胶囊
     * @param uid
     * @return
     */
    XpPointInfoVo getUserQuickCapsule(String uid);

    /**
     * 获取历史下单成功起点10条数据列表
     * @param uid
     * @return
     */
    List<XpHistoryStartPointsVo> getHistoryStartPoints(String uid,double lon,double lat);


    /**
     * 获取正在进行中的订单
     * @param uid
     * @return
     */
    XpOrderDetailVO getActiveOrder(String uid);

    /**
     * 获取历史下单成功终点10条数据列表
     * @param uid
     * @return
     */
    List<XpHistoryEndPointsVo> getHistoryEndPoints(String uid, double lon, double lat);

    /**
     * 获取历史订单列表
     * @param query
     * @param uid
     * @return
     */
    XpOrderHistoryVO getHistoryOrderList(XpHistoryOrderListQuery query, String uid);

    /**
     * 取消订单
     * @param orderId
     * @param uid
     */
    void cancelOrder(Long orderId,String uid);

    /**
     * 取消订单
     * @param orderId
     */
    void cancelOrder(String orderId);

    /**
     * 评价订单
     * @param dto
     * @param uid
     */
    void comment(XpOrderCommentDto dto, String uid);

    /**
     * 修改订单状态
     * @param orderId 订单id
     * @param status 状态 0=已取消，1=待接单，2=待出发，3=接驾中，4=待客上车，5=乘客已上车，6=服务中，7=待客下车，8=待付款，9=待评价，10=已完成
     * @return 修改结果
     */
    R<String> updateOrderStatus(Long orderId, Integer status);

    void endTrip(Long orderId, String uid);

    R<FareBreakdownVo> fareBreakdown(Long orderId, String uid);

    R payment(XpOrderPayDto dto, String uid);

    boolean addOrder(XpOrder xpOrder);

    /**
     * 根据订单ID查询车辆信息
     * @param orderId 订单ID
     * @param uid
     * @return
     */
    XpVehicle queryVehicleByOrderId(Long orderId, String uid);
}