package com.hotwj.platform.config.vehicleThreeInspect.service;

import com.hotwj.platform.config.vehicleThreeInspect.domain.bo.HotVehicleThreeInspectBo;
import com.hotwj.platform.config.vehicleThreeInspect.domain.bo.HotVehicleThreeInspectBatchAuditBo;
import com.hotwj.platform.config.vehicleThreeInspect.domain.bo.HotVehicleThreeInspectVehicleQueryBo;
import com.hotwj.platform.config.vehicleThreeInspect.domain.vo.HotVehicleThreeInspectProcessVo;
import com.hotwj.platform.config.vehicleThreeInspect.domain.vo.HotVehicleThreeInspectReceivedVehicleVo;
import com.hotwj.platform.config.vehicleThreeInspect.domain.vo.HotVehicleThreeInspectUnreceivedVehicleVo;
import com.hotwj.platform.config.vehicleThreeInspect.domain.vo.HotVehicleThreeInspectVo;
import com.hotwj.platform.resourceManagement.vehicleManagement.domain.vo.HotVehicleVo;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;

import java.util.Collection;
import java.util.List;

/**
 * 车辆三检Service接口
 *
 * @author shihongwei
 * @date 2025-12-29
 */
public interface IHotVehicleThreeInspectService {

    /**
     * 查询可进行三检的车辆列表（无历史记录或上一轮已完结）
     *
     * @param companyId 公司ID
     * @return 车辆列表
     */
    List<HotVehicleVo> queryAvailableVehicles(Long companyId);

    /**
     * 查询所有三检未收车的车辆列表
     *
     * @param bo 查询条件
     * @return 未收车车辆列表
     */
    List<HotVehicleThreeInspectUnreceivedVehicleVo> queryUnreceivedVehicles(HotVehicleThreeInspectVehicleQueryBo bo);

    /**
     * 查询所有三检已收车的车辆列表
     *
     * @param bo 查询条件
     * @return 已收车车辆列表
     */
    List<HotVehicleThreeInspectReceivedVehicleVo> queryReceivedVehicles(HotVehicleThreeInspectVehicleQueryBo bo);

    /**
     * 查询车辆三检
     *
     * @param id 主键
     * @return 车辆三检
     */
    HotVehicleThreeInspectVo queryById(Long id);

    /**
     * 分页查询车辆三检列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 车辆三检分页列表
     */
    TableDataInfo<HotVehicleThreeInspectVo> queryPageList(HotVehicleThreeInspectBo bo, PageQuery pageQuery);

    /**
     * 分页查询车辆三检流程列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 车辆三检流程分页列表
     */
    TableDataInfo<HotVehicleThreeInspectProcessVo> queryProcessPageList(HotVehicleThreeInspectBo bo, PageQuery pageQuery);

    /**
     * 查询符合条件的车辆三检列表
     *
     * @param bo 查询条件
     * @return 车辆三检列表
     */
    List<HotVehicleThreeInspectVo> queryList(HotVehicleThreeInspectBo bo);

    /**
     * 新增车辆三检
     *
     * @param bo 车辆三检
     * @return 是否新增成功
     */
    Boolean insertByBo(HotVehicleThreeInspectBo bo);

    /**
     * 判断车辆当前是否存在未完成的三检流程。
     * 未完成的定义为：最新一条三检记录不是已结束的收车检查。
     *
     * @param vehicleId 车辆ID
     * @return 是否存在未完成三检流程
     */
    boolean hasUnfinishedProcess(String vehicleId);

    /**
     * 校验车辆当前不存在未完成的三检流程。
     *
     * @param vehicleId      车辆ID
     * @param actionMessage 失败提示文案
     */
    void validateNoUnfinishedProcess(String vehicleId, String actionMessage);

    /**
     * 校验车辆当前不存在影响默认车辆切换的未完成三检流程。
     * 切换默认车辆时仅要求最新一条三检记录已到收车检查阶段，不区分审核结果。
     *
     * @param vehicleId      车辆ID
     * @param actionMessage 失败提示文案
     */
    void validateNoUnfinishedSwitchVehicleProcess(String vehicleId, String actionMessage);

    /**
     * 校验当前驾驶员是否可选择指定车辆。
     * 若车辆未出车则直接返回true；若车辆已出车，且当次三检流程未完成，且记录驾驶员不是当前驾驶员，则抛出异常。
     *
     * @param driverId  当前驾驶员ID
     * @param vehicleId 车辆ID
     * @return 是否可选择
     */
    boolean checkSelectableVehicle(String driverId, String vehicleId);

    /**
     * 修改车辆三检
     *
     * @param bo 车辆三检
     * @return 是否修改成功
     */
    Boolean updateByBo(HotVehicleThreeInspectBo bo);

    /**
     * 校验并批量删除车辆三检信息
     *
     * @param ids     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 审核车辆三检
     *
     * @param bo 业务对象
     */
    void audit(HotVehicleThreeInspectBo bo);

    /**
     * 批量审核车辆三检
     *
     * @param bo 批量审核业务对象
     */
    void batchAudit(HotVehicleThreeInspectBatchAuditBo bo);
}
