package com.fuyuanshen.equipment.mapper;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.fuyuanshen.common.mybatis.core.page.PageQuery;
import com.fuyuanshen.equipment.domain.DeviceAlarm;
import com.fuyuanshen.equipment.domain.bo.DeviceAlarmBo;
import com.fuyuanshen.equipment.domain.vo.AlarmStatisticsVo;
import com.fuyuanshen.equipment.domain.vo.DeviceAlarmVo;
import com.fuyuanshen.equipment.domain.vo.MonthlyAlarmStatisticsVo;
import com.fuyuanshen.common.mybatis.core.mapper.BaseMapperPlus;
import org.apache.ibatis.annotations.MapKey;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * 设备告警Mapper接口
 *
 * @author Lion Li
 * @date 2025-08-28
 */
public interface DeviceAlarmMapper extends BaseMapperPlus<DeviceAlarm, DeviceAlarmVo> {


    /**
     * 查询设备告警列表
     *
     * @param bo 设备告警
     * @return 设备告警
     */
    Page<DeviceAlarmVo> selectVoPage(Page pageQuery, @Param("bo") DeviceAlarmBo bo);

    /**
     * 根据设备IMEI查询最新的一条告警数据
     *
     * @param deviceImei 设备IMEI
     * @return 设备告警
     */
    DeviceAlarmVo selectLatestByDeviceImei(@Param("deviceImei") String deviceImei);


    /**
     * 获取实时告警列表
     *
     * @return 设备告警列表
     */
    List<DeviceAlarmVo> getRealtimeAlarm();
    
    /**
     * 获取报警统计数据
     *
     * @return 报警统计数据
     */
    AlarmStatisticsVo getAlarmStatistics();
    
    /**
     * 获取最近一年每月告警统计数据
     *
     * @return 每月告警统计数据
     */
    @MapKey("key")
    List<Map<String, Object>> getMonthlyAlarmStatistics();
}