package com.ruoyi.energymeter.service;

import com.ruoyi.energymeter.vo.EnergyCollectionVO;
import com.ruoyi.energymeter.vo.EnergyRealtimeVO;
import com.ruoyi.energymeter.vo.EnergyReportVO;

/**
 * 能耗数据采集、实时监控与统计分析。
 */
public interface EnergyMonitorService {

    /**
     * 数据采集概览：三类介质的接入设备、归集进度与最近采集批次。
     */
    EnergyCollectionVO collection();

    /**
     * 实时监控：三类介质最新用量、近 7 日趋势与电表 15 分钟实时数据。
     *
     * @param meterId 单台设备，空表示全部已启用设备
     */
    EnergyRealtimeVO realtime(Long meterId);

    /**
     * 统计分析：按日/月、按介质/设备汇总水、电、蒸汽用量。
     */
    EnergyReportVO report(String startDate, String endDate, String granularity, String meterType, String dimension);
}