microservice / rider-service · Files

package com.diligrp.rider.service;

import com.diligrp.rider.dto.DeliveryOrderCreateDTO;
import com.diligrp.rider.entity.Orders;
import com.diligrp.rider.vo.DeliveryOrderCreateVO;
import com.diligrp.rider.vo.OpenRiderLocationVO;

public interface DeliveryOrderService {
    /**
     * 外部系统推单（核心接口）
     * 1. 校验城市是否开通服务
     * 2. 计算配送费
     * 3. 创建配送订单（status=2待接单）
     * 4. 返回订单信息供接入方展示
     */
    DeliveryOrderCreateVO create(String appKey, DeliveryOrderCreateDTO dto);

    /** 查询订单状态（供接入方轮询） */
    DeliveryOrderCreateVO queryByOutOrderNo(String appKey, String outOrderNo);

    /** 取消订单（仅 status=2 可取消） */
    void cancel(String appKey, String outOrderNo);

    /**
     * 查询订单当前承运骑手的实时位置（供接入方展示配送轨迹）
     * 仅当订单 status=3 已接单 或 status=4 服务中时返回，其他状态抛业务异常
     */
    OpenRiderLocationVO getRiderLocation(String appKey, String outOrderNo);

    /** 后台查看配送订单详情 */
    DeliveryOrderCreateVO getAdminDetail(Orders order);

    /** 后台取消配送订单 */
    void cancelByAdmin(Orders order);
}