ebike-plus/ebike-operations/src/main/java/com/cdzy/operations/service/CommandService.java

package com.cdzy.operations.service;

import com.cdzy.operations.model.entity.EbikeEcuInfo;

/**
 * MQTT命令 服务层。
 *
 * @author attiya
 * @since 2025-09-15
 */
public interface CommandService{

    /**
     * 寻车铃
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean findBike(EbikeEcuInfo ebikeEcuInfo);

    /**
     * GPS定位上报
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean gps(EbikeEcuInfo ebikeEcuInfo);

    /**
     * 打开电池仓锁
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean openBatteryLock(EbikeEcuInfo ebikeEcuInfo);

    /**
     * 复位（关闭）电池仓锁
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean closeBatteryLock(EbikeEcuInfo ebikeEcuInfo);

    /**
     * 关锁
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean lock(EbikeEcuInfo ebikeEcuInfo);


    /**
     * 关锁
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean unLock(EbikeEcuInfo ebikeEcuInfo);

    /**
     * 回调事件
     * @param taskId 任务ID
     * @param success 结果
     */
    void onComplete(String taskId, boolean success);

    /**
     * 打开头盔所
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean openHelmet(EbikeEcuInfo ebikeEcuInfo);

    /**
     * 关闭电源
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean powerOff(EbikeEcuInfo ebikeEcuInfo);

    /**
     * 远程升级
     * @param ebikeEcuInfo 中控信息
     * @return 执行结果
     */
    boolean upgrade(EbikeEcuInfo ebikeEcuInfo,String url,Boolean fullUpgrade);

    /**
     * 升级/更换音频
     * @param ebikeEcuInfo 中控信息
     * @param url 文件路径
     * @param idx 所升级音频编号
     * @return 执行结果
     */
    boolean upgradeAudio(EbikeEcuInfo ebikeEcuInfo, String url, Integer idx,Boolean fullUpgrade);
}