a-tuoheng-device/src/main/java/com/ruoyi/device/service/FlightService.java

package com.ruoyi.device.service;

import com.ruoyi.device.mapper.entity.FlightEntity;

import java.util.Map;

/**
 * 飞行服务接口
 *
 * @author ruoyi
 * @date 2026-02-25
 */
public interface FlightService
{
    /**
     * 获取或创建当前正在进行的飞行记录
     * 用于MQTT回调，如果最新记录已返航则创建新记录
     *
     * @param deviceSn 设备SN号
     * @return 飞行记录
     */
    FlightEntity getOrCreateCurrentFlight(String deviceSn);

    /**
     * 获取或创建飞行记录（通过messageID匹配）
     * 如果存在相同messageID的飞行记录，返回该记录
     * 如果不存在或messageID不同，创建新记录
     *
     * @param deviceSn 设备SN号
     * @param messageId 消息ID（对应flightIdExternal）
     * @return 飞行记录
     */
    FlightEntity getOrCreateFlightByMessageId(String deviceSn, String messageId);

    /**
     * 获取最新的飞行记录（包括已返航的）
     * 用于WebSocket推送
     *
     * @param deviceSn 设备SN号
     * @return 飞行记录
     */
    FlightEntity getLatestFlight(String deviceSn);

    /**
     * 创建新的飞行记录
     *
     * @param deviceSn 设备SN号
     * @return 飞行记录
     */
    FlightEntity createFlight(String deviceSn);

    /**
     * 更新飞行ID（外部ID）
     *
     * @param flightId 飞行ID
     * @param flightIdExternal 外部飞行ID
     */
    void updateFlightIdExternal(Long flightId, String flightIdExternal);

    /**
     * 更新飞行状态
     *
     * @param flightId 飞行ID
     * @param status 状态：自检中、飞行中、已返航
     */
    void updateFlightStatus(Long flightId, String status);

    /**
     * 更新返航时间
     *
     * @param flightId 飞行ID
     */
    void updateReturnTime(Long flightId);

    /**
     * 获取飞行记录和日志（用于WebSocket推送）
     *
     * @param deviceSn 设备SN号
     * @return 飞行记录和日志
     */
    Map<String, Object> getLatestFlightWithLogs(String deviceSn);

    /**
     * 保存自检日志
     *
     * @param logEntity 自检日志实体
     */
    void insertPreCheckLog(com.ruoyi.device.mapper.entity.PreCheckLogEntity logEntity);

    /**
     * 保存飞行日志
     *
     * @param logEntity 飞行日志实体
     */
    void insertFlightLog(com.ruoyi.device.mapper.entity.FlightLogEntity logEntity);
}