综合能源平台KPI子系统概要设计说明书
KPI子系统功能概要设计说明书V1.00文件编号生效日期受控编号保密级别一级版 本 号V1.00修改次数0总 页 数正 文附 录无编 制审 核批 准评审记录对EMSV平台功能 概要设计说明书 V1.00的评审意见：上述问题修改验证后，由 验证后，本文件即可发布。评审人员签字： 问题修改验证结果： 验证人签字： 时间： 年 月 日变更日志编号版本修改内容修改人修改日期目 录1引言11.1编写目的11.2背景11.3定义11.4参考资料12总体设计22.1需求规定22.1.1功能边界22.1.2性能边界22.2运行环境22.2.1硬件环境22.2.2软件环境22.3概要设计决策22.3.1设计原则22.3.2设计决策32.4开发环境42.5界面设计42.6功能模块划分52.7系统结构62.7.1系统框架图63模块设计73.1 KPI子系统73.1.1实现方案73.1.2数据库表结构73.1.3 计算方法83.1.4 执行流程93.1.5 接口9 1引言1.1编写目的本文档是对EMSV能源管理系统软件V1.2（以下简称-9000系统或本系统）进行详细分析和讨论后得出的分析说明书，旨在明确本软件模块的功能需求。通过本说明书，可以了解到本软件的开发背景、建设要求、功能需求等。各个模块的开发人员阅读此文档后，以各个模块的功能为基础，兼顾配合服务器模块，完成各自模块的功能。本文档面向的读者是： EMSV项目组各成员。1.2背景原-9000强弱电一体化平台系统软件V及EMSV1.15以前的版本，在业务、规模及相关功能上无法支撑快速发展的客户需求，在此基础上对客户需求进行分析、筛选并结合目前系统的架构，对功能进行升级/完善、规模扩充，实现对医院、商业载体等实现全面的监测、分析，给运维人员提供便利，给管理者提供决策分析。1.3定义下表列出本报告中专门术语的定义、英文缩写词的原词组和意义、项目组内达成一致意见的专用词汇，同时继承全部的先前过程中定义过的词汇。词汇名称词汇含义备注常规定额水、电、气等能耗种类定额经营性定额单位床日、万元收入、业务量定额1.4参考资料编号资料名称说明1EMSV 系统需求包 - 140828- 一阶段需求.xlsx122总体设计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硬件环境硬件环境类别要求备注CPU2.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开发环境开发用机器类别要求备注CPU2.40GHz CPU内存4G主机硬盘250G网卡100Mb/s操作系统Windows 7 旗舰版64bit windows xp开发环境Microsoft Visual Studio 2010旗舰版2.5界面设计界面1界面2界面32.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_ BusinessTypeVarchar(10)PKDescription 对象描述varchar(32)关于此定额的辅助说明Unit单位Varchar(5)Not null例子：<1，"按床位数"，"张" >，<2，"按业务量"，"人次"><3, ''按单位空调面积", "KWh/m2",><4, "按万元收入", "T/元">经营数据表（TB_EMS _ BusinessData）字段名描述类型说明BusinessDataIDint自动编号 PKRecordTime时间Datetime时刻点当月经营数量not nullZValue属性数值floatNullFK_BusinessData_BusinessTypeInt外键，与经营业务ID对应；not nullAreaIDInt关联tb_area中的areaid；not nullRecordType年、月Int1：月 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 自增idintPKQUOTAID定额id int定额id； not
