package com.ruoyi.ems.service;

import com.ruoyi.ems.domain.ElecConsumeForecast;

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

/**
 * 电力消耗预测Service接口
 *
 * @author ruoyi
 * @date 2024-08-12
 */
public interface IElecConsumeForecastService {

    /**
     * 查询电力消耗预测
     *
     * @param id 电力消耗预测主键
     * @return 电力消耗预测
     */
    ElecConsumeForecast selectForecastById(Long id);

    /**
     * 查询电力消耗预测列表（支持层级汇总）
     * 当选择父节点时，自动包含所有子节点数据
     *
     * @param forecast 电力消耗预测查询条件
     * @return 电力消耗预测集合
     */
    List<ElecConsumeForecast> selectForecastList(ElecConsumeForecast forecast);

    /**
     * 新增电力消耗预测
     *
     * @param forecast 电力消耗预测
     * @return 结果
     */
    int insertForecast(ElecConsumeForecast forecast);

    /**
     * 修改电力消耗预测
     *
     * @param forecast 电力消耗预测
     * @return 结果
     */
    int updateForecast(ElecConsumeForecast forecast);

    /**
     * 批量删除电力消耗预测
     *
     * @param ids 需要删除的电力消耗预测主键集合
     * @return 结果
     */
    int deleteForecastByIds(Long[] ids);

    /**
     * 删除电力消耗预测信息
     *
     * @param id 电力消耗预测主键
     * @return 结果
     */
    int deleteForecastById(Long id);

    /**
     * 查询每日汇总趋势数据（支持层级汇总）
     * 当选择父节点时，自动汇总所有子节点数据
     *
     * @param forecast 查询条件
     * @return 每日汇总数据列表
     */
    List<ElecConsumeForecast> calcForecastDateRange(ElecConsumeForecast forecast);

    /**
     * 获取预测汇总统计（支持层级汇总）
     * 返回：
     * - totalElec: 总用电量
     * - avgElec: 日均用电量
     * - itemCount: 子项数量
     * - dayCount: 天数
     * - dateRange: 日期范围
     * - trend: 环比趋势（百分比）
     *
     * @param forecast 查询条件
     * @return 汇总统计结果
     */
    Map<String, Object> selectForecastSummary(ElecConsumeForecast forecast);
}