package com.yc.ship.module.trade.service.orderjzdetail;

import com.yc.ship.framework.common.pojo.PageResult;
import com.yc.ship.module.trade.controller.admin.orderjzdetail.vo.OrderJzDispatchBatchReqVO;
import com.yc.ship.module.trade.controller.admin.orderjzdetail.vo.OrderJzDispatchPageReqVO;
import com.yc.ship.module.trade.controller.admin.orderjzdetail.vo.OrderJzDispatchRecordRespVO;
import com.yc.ship.module.trade.controller.admin.orderjzdetail.vo.OrderJzDispatchSaveReqVO;

import javax.validation.Valid;
import java.util.List;

/**
 * 订单分车 Service 接口
 *
 * @author 管理员
 */
public interface OrderJzDispatchService {

    /**
     * 创建订单分车
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createOrderJzDispatch(@Valid OrderJzDispatchSaveReqVO createReqVO);

    /**
     * 批量保存订单分车（有dispatchId则更新，无则新建）
     *
     * @param batchReqVO 批量分车请求
     */
    void batchSaveOrderJzDispatch(@Valid OrderJzDispatchBatchReqVO batchReqVO);

    /**
     * 更新订单分车
     *
     * @param updateReqVO 更新信息
     */
    void updateOrderJzDispatch(@Valid OrderJzDispatchSaveReqVO updateReqVO);

    /**
     * 删除订单分车
     *
     * @param id 编号
     */
    void deleteOrderJzDispatch(Long id);

    /**
     * 获得订单分车
     *
     * @param id 编号
     * @return 订单分车
     */
    com.yc.ship.module.trade.dal.dataobject.orderjzdispatch.OrderJzDispatchDO getOrderJzDispatch(Long id);

    /**
     * 获得分车记录分页
     *
     * @param pageReqVO 分页查询条件
     * @return 分车记录分页结果
     */
    PageResult<OrderJzDispatchRecordRespVO> getDispatchRecordPage(OrderJzDispatchPageReqVO pageReqVO);

    /**
     * 获得分车记录列表（用于导出）
     *
     * @param pageReqVO 查询条件
     * @return 分车记录列表
     */
    List<OrderJzDispatchRecordRespVO> getDispatchRecordExportList(OrderJzDispatchPageReqVO pageReqVO);

    /**
     * 更新分车记录
     *
     * @param updateReqVO 更新信息
     */
    void updateDispatchRecord(@Valid OrderJzDispatchSaveReqVO updateReqVO);

    /**
     * 校验分车记录是否重复
     * 根据分车号+航次ID（有组团号则加上组团号）查询已有记录，
     * 如果已有记录的车辆信息与本次不一致，则返回提示信息
     *
     * @param dispatchInfo 分车信息
     * @return 重复提示信息，null表示不重复
     */
    String checkDispatchDuplicate(OrderJzDispatchBatchReqVO.DispatchInfo dispatchInfo);


}
