package com.ruoyi.ems.service;

import com.ruoyi.ems.domain.EmsObjFlowRel;

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

/**
 * 能源设施能流关系Service接口
 *
 * @author ruoyi
 * @date 2024-07-10
 */
public interface IEmsObjFlowRelService {
    /**
     * 查询能源设施能流关系
     *
     * @param id 能源设施能流关系主键
     * @return 能源设施能流关系
     */
    EmsObjFlowRel selectFlowRelById(Long id);

    /**
     * 查询能源设施能流关系列表
     *
     * @param flowRel 能源设施能流关系
     * @return 能源设施能流关系集合
     */
    List<EmsObjFlowRel> selectFlowRelList(EmsObjFlowRel flowRel);

    /**
     * 新增能源设施能流关系
     *
     * @param flowRel 能源设施能流关系
     * @return 结果
     */
    int insertFlowRel(EmsObjFlowRel flowRel);

    /**
     * 修改能源设施能流关系
     *
     * @param flowRel 能源设施能流关系
     * @return 结果
     */
    int updateFlowRel(EmsObjFlowRel flowRel);

    /**
     * 批量删除能源设施能流关系
     *
     * @param ids 需要删除的能源设施能流关系主键集合
     * @return 结果
     */
    int deleteFlowRelByIds(Long[] ids);

    /**
     * 删除能源设施能流关系信息
     *
     * @param id 能源设施能流关系主键
     * @return 结果
     */
    int deleteFlowRelById(Long id);

    /**
     * 获取能流拓扑数据
     *
     * @param areaCode 区域代码
     * @param emsClsCode 能源分类代码
     * @return 拓扑数据（包含nodes和edges）
     */
    Map<String, Object> getFlowTopology(String areaCode, String emsClsCode);

    /**
     * 检查能流关系是否存在
     *
     * @param flowRel 能流关系
     * @return 是否存在
     */
    boolean checkFlowRelExists(EmsObjFlowRel flowRel);

    /**
     * 获取上游能流（输入到该对象的能流）
     *
     * @param objCode 对象代码
     * @param objType 对象类型
     * @return 能流关系列表
     */
    List<EmsObjFlowRel> getUpstreamFlow(String objCode, Integer objType);

    /**
     * 获取下游能流（从该对象输出的能流）
     *
     * @param objCode 对象代码
     * @param objType 对象类型
     * @return 能流关系列表
     */
    List<EmsObjFlowRel> getDownstreamFlow(String objCode, Integer objType);

    /**
     * 根据能源类型获取能流关系
     *
     * @param emsClsCode 能源分类代码
     * @param areaCode 区域代码
     * @return 能流关系列表
     */
    List<EmsObjFlowRel> getFlowRelByEnergyType(String emsClsCode, String areaCode);
}