综合能源平台KPI子系统概要设计说明书

KPI子系统功能 概要设计说明书V1.00 文件编号 生效日期 受控编号 保密级别 一级 版 本 号 V1.00 修改次数 0 总 页 数 正 文 附 录 无 编 制 审 核 批 准 评审记录 对《EMSV平台功能 概要设计说明书 V1.00》的评审意见： 上述问题修改验证后，由 验证后，本文件即可发布。 评审人员签字： 问题修改验证结果： 验证人签字： 时间： 年 月 日 变更日志 编号 版本 修改内容 修改人 修改日期 　 　 　 目 录 1引言 1 1.1编写目的 1 1.2背景 1 1.3定义 1 1.4参考资料 1 2总体设计 2 2.1需求规定 2 2.1.1功能边界 2 2.1.2性能边界 2 2.2运行环境 2 2.2.1硬件环境 2 2.2.2软件环境 2 2.3概要设计决策 2 2.3.1设计原则 2 2.3.2设计决策 3 2.4开发环境 4 2.5界面设计 4 2.6功能模块划分 5 2.7系统结构 6 2.7.1系统框架图 6 3模块设计 7 3.1 KPI子系统 7 3.1.1实现方案 7 3.1.2数据库表结构 7 3.1.3 计算方法 8 3.1.4 执行流程 9 3.1.5 接口 9 1引言 1.1编写目的 本文档是对EMSV能源管理系统软件V1.2（以下简称-9000系统或本系统）进行详细分析和讨论后得出的分析说明书，旨在明确本软件模块的功能需求。通过本说明书，可以了解到本软件的开发背景、建设要求、功能需求等。各个模块的开发人员阅读此文档后，以各个模块的功能为基础，兼顾配合服务器模块，完成各自模块的功能。 本文档面向的读者是： EMSV项目组各成员。 1.2背景 原-9000强弱电一体化平台系统软件V及EMSV1.15以前的版本，在业务、规模及相关功能上无法支撑快速发展的客户需求，在此基础上对客户需求进行分析、筛选并结合目前系统的架构，对功能进行升级/完善、规模扩充，实现对医院、商业载体等实现全面的监测、分析，给运维人员提供便利，给管理者提供决策分析。 1.3定义 下表列出本报告中专门术语的定义、英文缩写词的原词组和意义、项目组内达成一致意见的专用词汇，同时继承全部的先前过程中定义过的词汇。 词汇名称 词汇含义 备注 常规定额 水、电、气等能耗种类定额 经营性定额 单位床日、万元收入、业务量定额 1.4参考资料 编号 资料名称 说明 1 EMSV 系统需求包 - 140828- 一阶段需求.xlsx 12 2总体设计 2.1需求规定 2.1.1功能边界 1）首页KPI概览。显示总区域的KPI数据，如消耗百分比、消耗值，数据通过仪表盘显示展示。模块要求：能够灵活配置KPI总览显示的项，经营性KPI和常规类型KPI可以灵活搭配。 2）KPI定额管理。主要展示常规能源种类的定额值以及KPI数据信息（包括节能、正常等数据），其中KPI数据信息以二层树模型展示。 3）经营性KPI。主要展示经营性相关的kPI数据信息，如百分比、消耗值，以仪表盘的形式展示（不包括节能、正常等数据）。 2.1.2性能边界 首页KPI数据请求响应时间不超过3s。 2.2运行环境 2.2.1硬件环境 硬件环境 类别 要求 备注 CPU 2.0 GHz以上CPU 内存 2.0 GB或以上 主机硬盘 80GB或以上 2.2.2软件环境 软件环境 类别 要求 备注 操作系统 Windows 2000/2003或 Windows XP SP3或Win2008 R2 32bit或Win7 32bit旗舰版 数据库 SQL 2000 SP3及以上或MS SQL 2005开发版（32bit）或MS SQL Server 2008企业版（32bit） 2.3概要设计决策 2.3.1设计原则 Ø 要有一个良好的设计框架。 为了软件能适应未来几年的现场需要，通用数据配置模块应该根据实际需要保持一定的可扩展性、可复用性，这就要求系统升级时对已基于该系统实施的系统兼容，软件设计必须有良好的设计框架。其中包括： 第一、采用复用技术。 第二、底层业务模块相对独立，统一接口，做到高内聚、低耦合。 第三、良好的人机交互界面。 Ø 系统的使用要考虑现场人员的易用性 本软件的最终用户为现场的运行维护人员，在设计软件时要考虑人员的使用习惯和方便使用；简单易用的系统可以提高现场工程实施人员的效率，降低出错的几率。 Ø 系统需要具有足够的灵活性 KPI子系统中KPI首页总览应根据实际数据准备情况，可自由配置显示的时间段、显示的项（电能耗、经营性能耗等）。 2.3.2设计决策 本节记录对概要设计具有重要影响的软件需求和约束，描述相关的重要决策和决策的原因。这些决策一般对设计有很大影响,它们的改变很难通过设计技巧来屏蔽，例如所选用的开发语言,所选用的平台、组件和框架，对关键业务，类和方法的处理等。 2.3.2.1 KPI数据查询设计 设计决策 KPI数据查询模块 标识号 001 问题描述 1、 首页请求的KPI数据包含两大类：经营性能耗KPI和常规能耗KPI数据 2、 KPI定额功能需要查询常规能耗KPI数据以及定额数据 3、 经营性能耗功能需要查询与经营业务相关的KPI数据 假设条件 可选方案1 返回数据的接口类中包括两大类：经营性能耗KPI和常规能耗KPI数据，定额数据信息 优点： 1、 不用重复设计接口类，一个功能类完成2项任务。 缺点： 1、 当首页请求后，后台返回数据有冗余。 可选方案2 为经营类数据、定额数据和常规类数据均建立一个接口类 优点： 1、 由于每个页面请求的数据和每一个接口类均对应，逻辑更加清晰。 缺点： 1、 由于两大类KPI数据，本质上是相同的，因此存在不同类做相同任务的弊端。 决策 使用方案1 影响 当“KPI定额”功能请求数据时，此时返回结果包括：常规能耗KPI数据和定额数据；反之，当“经营性能耗KPI”功能请求数据时，此时仅返回与经营相关的KPI数据，定额数据为null。 相关决策 2.4开发环境 开发用机器 类别 要求 备注 CPU 2.40GHz CPU 内存 4G 主机硬盘 250G 网卡 100Mb/s 操作系统 Windows 7 旗舰版64bit windows xp 开发环境 Microsoft Visual Studio 2010旗舰版 2.5界面设计 界面1 界面2 界面3 2.6功能模块划分 2.7系统结构 2.7.1系统框架图 3模块设计 3.1 KPI子系统 3.1.1实现方案 首页KPI要能够灵活搭配各类KPI组合显示，同时满足设置时间条件，如当月、上月、当年、上年四类，以保证首页面可以有数据展示。因此，首页需要在数据库中添加一张表，用来存在配置信息。 KPI定额管理功能和1.1版本基本一致，通过选择区域对象和时间粒度，将各类常规能耗的定额值，KPI数据读出，以仪表盘的形式展示。 经营性KPI功能可以视为对常规KPI的扩展，将经营性数据纳入其中制定KPI。因此，需要建立一张与业务相关的基本表，存放业务类型、业务项描述信息、业务计算单位。另外，还需要一张表来存放具体的业务数据，如单位床数、业务量、万元收入信息。而定额信息的描述，为了和已有常规定额区分对1.1.定额表，添加一个标识字段，说明是否为经营类定额。 3.1.2数据库表结构 经营业务表（TD_EMS_ BusinessType） 该表主要存放与客户业务相关的，衡量能耗的参数。 字段名 描述 类型 说明 PK_ BusinessType Varchar(10) PK Description 对象描述 varchar(32) 关于此定额的辅助说明 Unit 单位 Varchar(5) Not null 例子： <1，"按床位数"，"张" >，<2，"按业务量"，"人次"> <3, ''按单位空调面积", "KWh/m2",> <4, "按万元收入", "T/元"> 经营数据表（TB_EMS _ BusinessData） 字段名 描述 类型 说明 BusinessDataID int 自动编号 PK RecordTime 时间 Datetime 时刻点当月经营数量not null ZValue 属性数值 float Null FK_BusinessData_BusinessType Int 外键，与经营业务ID对应；not null AreaID Int 关联tb_area中的areaid；not null RecordType 年、月 Int 1：月 2：年； not null 例子： <1，'2014-09-01',5000，1，35>：2014年9月，实际使用床位数5000张，该区域ID为35. <2，'2014-09-01',100000，2，1>：2014年9月，业务量10万人次，该区域ID为1. <3，'2014-05-01',3000，3，1>：2014年5月，空调覆盖面积3千平，该区域ID为1. <4，'2014-04-01',300000，4，1>：2014年4月，本月万元收入30万，该区域ID为1. 经营定额表（TB_EMS _ Quota） 字段名 描述 类型 说明 PK_QuotaID 自增id int PK QUOTAID 定额id int 定额id； not