package com.usky.vpp.service;

import com.usky.common.core.bean.CommonPage;
import com.usky.vpp.service.vo.CapabilityEvalSummaryVO;
import com.usky.vpp.service.vo.CapabilityHistoryVO;
import com.usky.vpp.service.vo.CapabilityLoadCurveVO;

import java.util.Map;

/**
 * 可调能力评估业务接口
 */
public interface VppCapabilityEvalService {

    /**
     * 顶部汇总统计（总资源/负荷类/储能类/发电类 + 最大上下调能力）
     *
     * @param siteId 站点 ID，为空时统计全部站点
     */
    CapabilityEvalSummaryVO getSummary(Long siteId);

    /**
     * 可调能力曲线（基线负荷 vs 实际负荷）
     *
     * @param siteId 站点 ID，为空时统计全部站点
     * @param date   统计日期 yyyy-MM-dd，默认当天
     */
    CapabilityLoadCurveVO getLoadCurve(Long siteId, String date);

    /**
     * 历史响应记录（分页）
     */
    CommonPage<CapabilityHistoryVO> pageHistory(Long siteId, Map<String, Object> params);
}
