package com.xiaopeng.map.service;

/**
 * ADC 围栏推送编排服务。
 * 封装「查区域 → 查车辆 → 逐车推送 FBS」的完整编排逻辑。
 */
public interface AdcFencePushService {

    /**
     * 围栏变更后，向所有绑定该围栏的车辆推送最新 FBS 数据
     *
     * @param electronicId 围栏ID
     */
    void pushFenceToVehicles(Long electronicId);

    /**
     * 围栏失效后，向所有绑定车辆上传空 FBS（无任何区域节点，标记围栏已失效）
     *
     * @param electronicId 围栏ID
     */
    void deactivateFenceForVehicles(Long electronicId);

    /**
     * 单车推送：车辆绑定/变更围栏时，推送该车辆需要的 FBS 数据
     *
     * @param vehicleVin   车辆VIN码
     * @param electronicId 围栏ID
     */
    void pushFenceToSingleVehicle(String vehicleVin, Long electronicId);

    /**
     * 查询指定车辆最近一次成功推送的 FBS 版本号
     *
     * @param vehicleVin 车辆VIN码
     * @return 版本号字符串（Unix秒级时间戳），无记录时返回 null
     */
    String getLatestPushVersion(String vehicleVin);
}