能源管理平台告警诊断及设备管理模块需求分析说明书

能源管理平台告警诊断及设备管理模块需求分析说明书目录1 引言 引言编写目的本文的描述对象是能源管理系统(EMS)V1.30的系统功能架构和产品经理负责的需求。需求分析系统需求是在原始的需求的基础上进行多层次加工所得。原始需求一般需要经过过滤、分解、分发、分析才能转化为系统需求。每个环节都很重要，尤其是需求分析更是核心中的核心。常用的需求分析方法有业界基准寻找、行业标准搜索、竞争对手分析、应用场景描绘、功能框架搭建、逻辑推敲、客户价值评价、投入产出分析等。系统需求不仅仅是业务功能需求，还包含了相关的操作维护需求，如权限、配置、告警、日志、统计；系统需求还可能包含到性能、扩展性、用户体验等。此外，如能对异常流程进行设计则更为全面。复杂的业务流程一般要绘制流程图。系统功能架构从EMSV1.20开始，逐渐深度集成多个子系统，且形成多个通用业务模块。EMSV1.30更是深度融入了照明、计费，对配电也进行更深度融入；因此，从EMSV1.30开始，系统功能架构需要按照模块的方式进行规划和设计。模块、子模块的划分关系到很多设计，如下图所示：在xmind图上标识为5级的功能为EMSV1.30版本要开发的功能；行业业务模块需求通用业务模块需求告警管理（有更新）告警模块主要是对告警进行细分、进行系统架构优化，建立标准的告警管理规范。此外，把通知模块从告警中拆除出来。告警记录建立与实时监测的关联；告警架构优化应用场景01平台告警跟业务告警拆分，配电、照明都属于业务告警，所属配电、照明模块；02把告警细分为运行事件、一般告警、诊断告警三大类；运行事件是指在系统运行中出现的重大事件，以提醒操作员。比如遥信变位、遥控记录，操作员需要浏览到这些事件以帮助他判断系统是否有异常；一般告警指明确的故障类、威胁安全类的事件，这类告警会影响到系统的使用，面向的用户是操作员，需要他们实时处理；诊断告警指系统优化类、需要深入分析类的事件，由于诊断需要专家介入，诊断的处理不需要实时；随着技能的融合发展，操作员和专家型分析人员可能会融合。03把一些推送功能从告警模块中拆分出来，独立于告警模块，形成“通知模块”。这个模块将被整个系统所共享，如报表报告系统也可使用通用推送模块。04权限管理无 配置管理 无告警管理无诊断管理无日志管理无统计管理无扩展性01可能因为后续业务的发展而需要对接口进行扩展；02告警的状态机中“确认”一项可以考虑去除，当前发现告警状态机过于复杂；03诊断的统计后续将上传到2.0云系统，形成经验库；安全性无性能无用户体验无告警专属推送模块-使用通知模块应用场景01通过使用通用推送模块来对告警信息进行推送。即调用通用推送模块的API接口；02实现告警和设备B/S组态监控的关联。告警记录的处理过程中，可增加一个操作“查看实时监控”，当触发该操作时，告警模块向推送模块传递“设备编号”，推送模块获取到该设备在B/S组态图上的位置信息，调用出B/S组态图供用户查看。这需要告警项与设备建立关联关系；图：告警与实时组态图关联流程介绍略，请参考图；权限管理无 配置管理 无告警管理在告警配置中描述，这里不重复；诊断管理无日志管理无统计管理无扩展性无安全性无性能无用户体验无告警配置应用场景01告警的注册要实现无代码修改，包含分级、分类、分项。主要原因是系统集成中会接入很多的第三方系统/设备的告警，需要考虑做成灵活的配置接口。02告警的生成可配置。即生成算法可以配置；03告警的自动恢复可配置，即恢复算法可以配置；04告警推送可配置。通过配置去使用通用推送模块。通过配置可推送单条告警；05告警着色，在实时告警页面、历史告警查询页面，根据根据告警状态进行着色。权限管理无 配置管理 无告警管理无诊断管理无日志管理无统计管理无扩展性无安全性无性能无用户体验无平台告警项应用场景01需设计和开发系统对接异常告警。告警项可以是通讯中断、报文错误率偏高等（开发同事要自行发现其他类型的告警，该类告警利于操作员对系统是否有故障进行判断）；优先开发OPC对接时的异常告警；02平台告警需求优化：实时告警需要增加告警维度的筛选；权限管理无 配置管理 无告警管理无诊断管理无日志管理无统计管理无扩展性无安全性无性能无用户体验无业务告警项应用场景01能耗监管增加告警项，以能耗监管模块设计为准；02能源计费变更告警项，以计费模块设计为准；03智能照明可能变更告警项，以照明模块设计为准；04系统集成模块新增告警项，以系统集成模块设计为准；权限管理无 配置管理 无告警管理无诊断管理无日志管理无统计管理无扩展性无安全性无性能无用户体验无诊断管理（有更新）一键诊断应用场景01业务逻辑不变，交互体验上提升。诊断的交互做成类似于360杀毒形式，不要一下子展现结果给客户，让客户体验到系统在一点点的做诊断，比如先做配电类诊断，输出一些配电类的诊断项，之后给排水的能耗诊断直至最后。02未配置的诊断项在诊断管理页面上不进行显示；权限管理无配置管理可把任意的告警项配置成诊断项。告警管理无诊断管理无日志管理无统计管理无扩展性诊断项今后将不断扩展；安全性无性能无用户体验通知模块通知模块更多的是进行系统架构优化，注重灵活配置。通知模块应用场景01系统架构重构，形成通用的通知模块，以供告警、报告、报表模块调用。02提供平台级接口，考虑告警、报告报表类主要业务场景的调用方式；接口需考虑推送内容、推送方式、重复推送、推送人群；权限管理无 配置管理01可根据通知内容进行配置，如告警可配置分类、分项、分级、区域、逻辑区域；报告报表可配置报告报表类型，区域、逻辑区域；02推送方式可配置：web页面（B/S组态图）、短信推送、邮件推送、声音推送；其中web页面（B/S组态图）需要能根据设备信息定位到其组态图上，并且移动到组态图该设备所在位置，展示给客户查看。推荐在设备管理时增加B/S组态图位置信息，该位置信息是在工程人员绘制组态图（进行整体设备关联时）实现信息的获取和保存；一个设备可能在多个组态图上存在，要能够让客户选择观察哪个组态图； 03重复推送可配置：推送失败重推、自动多次推送、手动再次推送； 04推送人群可配置：当选择手机号码、邮件地址方式时，可配置推送的人群。可通知单个人、也可通知一群人；告警管理无诊断管理无日志管理无统计管理无扩展性可能因为后续业务的发展而需要对接口进行扩展安全性无性能无用户体验无（有更新）设备管理整体规划方向：01本次设备管理强化设备信息总览；02把保养管理、维修管理进行一定程度的弱化，只做信息收集，不做工作流管理；03对生命周期监测进行简化；设备总览采集设备总览应用场景终端智能设备总览：01管理运维人员在进入设备管理模块，在模块首页上查看以表格形式展现的终端智能设备总览信息，包括设备子类型、设备数量、离线数量、告警数量信息，包括设备总数统计信息；02终端智能设备的设备类型子包括电表、水表、气表、继电保护装置，设备子类型可方便扩充定义。权限管理只显示权限以内的设备信息；配置管理批量导入和手动单条配置修改；告警管理无诊断管理无日志管理无统计管理在查询时，需要对记录数进行统计；扩展性设备子类型可方便扩充定义；安全性无性能无用户体验无通讯设备总览应用场景通讯网络设备总览：01管理运维人员在进入设备管理模块，在模块首页上查看以表格形式展现的通讯设备总览信息，包括设备子类型、设备数量、离线数量、告警数量信息；02通讯网络设备子类型包括通讯管理机、数据采集器、IP网关，设备子类型可方便扩充定义。权限管理只显示权限以内的设备信息；配置管理批量导入和手动单条配置修改；告警管理无诊断管理无日志管理无统计管理在查询时，需要对记录数进行统计；扩展性设备子类型可方便扩充定义；安全性无性能无用户体验无重大能耗设备总览应用场景重大能耗设备总览：01管理运维人员在进入设备管理模块，在模块首页上查看以表格形式展现的重大能耗设备总览信息，包括设备子类型、设备数量、告警数量包括设备总数统计信息；02常见的重大能耗设备的设备子类型包括变压器、冷冻站、锅炉等，设备子类型可方便扩充定义。权限管理只显示权限以内的设备信息；配置管理批量导入和手动单条配置修改；告警管理无诊断管理无日志管理无统计管理在查询时，需要对记录数进行统计；扩展性设备子类型可方便扩充定义；安全性无性能无用户体验无设备查询应用场景01名称查询：管理运维人员在进入设备管理模块，在模块首页上的设备查询区域，输入设备名称，进行设备查询，查询结果以表格形式返回；02高级条件筛选：管理运维人员在进入设备管理模块，为了精确查询所需设备信息，在模块首页上的激活高级条件查询入口，选择一种或多种筛选条件，进行精确设备查询，查询结果以表格形式返回；查询筛选条件包括设备类型、设备子类型、通讯状态、告警状态、使用状态、安装位置。03查询结果：管理运维人员在查询的设备结果以列表形式返回，若返回设备数量太多应分页显示；返回的设备信息包括：设备名称、设备类型、设备子类型、通讯状态（实时）、告警状态、使用状态、安装位置。管理运维人员可以通过设备详情链接查询该设备的详细信息。在查询结果显示模块内，不可以对设备信息进行删除或编辑操作。权限管理只显示权限以内的设备信息；配置管理无告警管理无诊断管理无日志管理无统计管理在查询时，需要对记录数进行统计；扩展性设备信息记录的字段可扩充；安全性无性能无用户体验无全生命周期监测应用场景01管理运维人员在设备全生命周期管理页面可以查看以设备生命周期图形式展现的当前设备全生命周期信息，设备生命周期图上展示的关键信息包括：能耗走势、能效、告警次数、保养信息、维修信息、生命周期阶段信息；03在生命周期图上分块显示设备的不同时期，通过里程碑点划分；如出厂、购入、交付使用、质保期结束、付费维保期结束（可选）、生命周期结束（可选）；权限管理无配置管理无诊断管理无告警管理无日志管理无统计管理无扩展性无安全性无性能页面载入时间不超过2s；用户体验用户界面良好，指向性和指导性好；页面数据载入时间较长时，应有提示；设备信息应用场景01设备详细信息：管理运维人员在设备管理模块中查看设备的详细信息，设备信息包括基本信息：设备图片、通讯状态、名称、编号、安装位置、出厂编号、使用状态等，维护信息：设备出厂日期、购入日期、交付使用日期、免费质保截止日期、生命周期结束时间等，管理信息：设备归属部门、归属负责人；厂家信息：生产厂家、厂家联系人、联系电话、地址等；02设备信息维护：管理运维人员在可以在设备详细信息页面切换到设备信息编辑状态，对设备信息进行编辑，编辑完成后可提交系统进行设备信息的更改；编辑过程有格式检查，输入内容不可有空。编辑过程应由权限管理和日志记录；03设备图片维护：管理运维人员在可以在设备详细信息页面对设备图片进行编辑修改，设备图片从本地硬盘上传并导入至管理系统中，导入成功后设备图片自动更新；编辑过程有格式和像素检查，输入内容不可有空；编辑过程应有权限管理和日志记录；权限管理无配置管理无告警管理无诊断管理无日志管理无统计管理无；扩展性设备信息内容可方便扩充定义安全性无性能无用户体验无维修日志管理应用场景01可录入维修日志，日志包含但不限于开始、结束时间、维修人、维修内容；02可查询、变更、删除维修日志；权限管理变更、删除操作需要有特别的权限限制；配置管理日志可以批量导入，也可以一条条录入；告警管理无诊断管理无日志管理无统计管理无；扩展性日志内容可方便扩充定义安全性无性能无用户体验无保养日志管理应用场景01可录入保养日志，日志包含但不限于开始、结束时间、保养人、保养内容；02可查询、变更、删除保养日志；权限管理变更、删除操作需要有特别的权限限制；配置管理日志可以批量导入，也可以一条条录入；告警管理无诊断管理无日志管理无统计管理无；扩展性日志内容可方便扩充定义安全性无性能无用户体验无告警管理应用场景01告警查询：管理运维人员在设备告警管理页面可以查询某个时段内的该设备的所有告警信息，查询结果在告警记录栏以列表的形式展现，时段开始和结束时间可设；02告警操作：管理运维人员在告警记录页面可对某一条或多条待处理告警信息进行确认、处理和取消操作，操作后告警记录状态发生变化；权限管理无配置管理无；告警管理无诊断管理无日志管理无统计管理无扩展性无安全性无性能无用户体验无系统管理需求（有更新）整体规划方向：平台提供健全、可适度扩展的系统管理功能，包括权限管理、配置管理、告警管理、日志管理、通知管理、统计管理、版本管理。业务设计和开发人员只需要聚焦自身的业务，通过调用平台接口或者遵循设计规范就可以设计出符合要求的业务功能；具备良好的操作和维护体系架构，形成一套设计和开发规范。本版本规划要点<描述本版本的规划重点，不涉及过于具体的需求，概要的描述；>权限管理主要是增加操作级别的权限，并对权限架构进行重构；配置管理将基于模块来做，配置的结构和层次进行优化；日志管理进行少量优化，建立设计规范；统计管理、版本管理本次不涉及；权限管理许可证控制管理应用场景01许可证文件和许可证生成工具。许可证文件是用于控制项目上能使用哪些功能。因为当前系统有众多的行业业务模块和通用业务模块，很多客户只会购买其中一部分模块功能。许可证生成工具是供许可证管理人员为某一个项目生成许可证文件的工具。该工具可定义为一个小工具，但对安全性要求很高，需要有密码控制，且由可靠的管理人员进行管理。02许可证文件生成流程。许可证管理人员获取到项目的功能购买清单，根据该文档操作许可证管理工具，生成该项目的许可证文件。许可证文件需进行加密，以防止泄密，给公司带来损失；03许可证文件导入到权限空白系统。工程人员或实验局人员从许可证管理人员手中获取到该项目的许可证文件，登陆用户名密码进入到EMS配置页面，打开许可证控制管理模块，把许可证文件导入到现场的权限空白系统中，系统对许可证文件进行校验，校验成功后将能正确开启相关模块的权限。校验失败要有信息提示；权限空白系统指从来没有导入过许可证文件的系统，该系统无法开启各类模块。04许可证文件导入到非空白系统。工程人员或实验局人员从许可证管理人员手中获取到该项目的许可证文件，登陆用户名密码进入到EMS配置页面，打开许可证控制管理模块，把许可证文件导入到现场的非空白系统中，系统对原有系统的权限进行覆盖，原有的权限控制消失，生成新的管理权限。覆盖前系统需验证许可证文件，并提示操作人员是否确定要覆盖；权限管理许可证工具进入时需要进行密码验证，密码复杂度要求在10个字符以上；系统的许可证导入有用户名密码管理；配置管理许可证控制管理工具是windows平台上的小工具；许可证控制管理模块是EMS的B/S配置管理中的一个模块；告警管理无诊断管理无日志管理许可证控制管理工具有日志记录；许可证控制管理模块的任何操作都有日志记录；统计管理无扩展性可能因为后续业务的发展而需要对接口进行扩展安全性无性能无用户体验无多维权限管理应用场景系统提供多维的权限管理，基于模块/子模块的权限管理、基于区域的权限管理、基于操作类型的权限管理；01基于模块的权限管理：只有拥有该模块的权限，才有可能接触到该模块，进行一系列的操作。模块主要分为四大类：行业业务模块、通用业务模块、系统管理模块、底层功能模块；其中行业业务模块、通用业务模块、系统管理模块都需要使用权限控制；当拥有模块的权限后，与模块相关联的菜单界面才会显示。菜单包含业务界面和该模块特定的操作运维页面；02基于区域的权限管理：区域有两种类型，一种是物理区域，一种是逻辑区域；物理区域主要由地理位置决定，一般而言，全系统各模块拥有相同的地理区域，如地理区域举例，某某园区1号楼，某某园区2号楼；逻辑区域则是根据业务类型各有不同，如能耗监测的逻辑区域可以是管理区域，如医院划分了内科、外科等；当操作人员拥有某区域的权限，只能看到该区域的业务信息，如能耗信息、告警信息、实时监控的监控视图；如用能计费系统，区域则跟业主期望的计费管理区域相关；只有拥有该区域的权限，才能查看到该区域的菜单、B/S组态监控图、信息数据（如告警信息、日志信息）。03模块内的操作权限管理：模块的操作权限有多种，因模块不同而不同。比如能耗分析页面有查询搜索页面，表格导出权限；报表模块有查询搜索、浏览、导出、上传等不同权限；而实时监控有查询、遥控等权限；需要针对每个模块进行设计；权限的管理需针对每个模块、子模块进行设计；配置管理B/S架构的配置界面；配置流程为，先配置模块权限-》配置子模块权限-》配置模块/子模块里的区域-》配置操作权限；告警管理无诊断管理无日志管理在配置权限时产生日志。统计管理无扩展性无安全性无性能无用户体验由于配置因素众多，要有清晰的配置层次；配置管理B/S配置逐渐取代C/S配置应用场景01新功能配置全部在B/S做；02优先移植关联度高、工作量不大配置到B/S；权限管理无 配置管理 无告警管理无诊断管理无日志管理所有的配置动作都需要有日志管理。统计管理无扩展性后续所有的配置将使用B/S架构安全性无性能无用户体验无配置结构优化应用场景01配置分为通用模块配置和模块内配置。通用模块配置是指平台级配置和多个模块同享的配置。模块内配置指仅供本模块使用的配置。02配置菜单的设计要体现模块化和配置流程。有文本框显示下一步配置和上一步配置，并有快速链接。（本版本只限于B/S配置）；03抓住设备、区域这些配置中最普遍的内容，形成索引，有利于在各个模块间柔顺的切换；比如，告警项与设备关联，B/S实时监测与设备关联，这样实时告警列表中的告警项就可以很好的与设备实时监测建立关联；04设备要进行建模，设备的基本信息模型、设备的能耗模型、设备的实时监测模型、设备的能效模型、设备的节能模型等；05区域区分地理区域和逻辑区域。地理区域一般不因为业务模型改变而改变，跟GIS类似；逻辑区域则因为业务模型不同而不同，如管理区域、商业业态区域等；权限管理无 配置管理B/S架构的配置界面；告警管理无诊断管理无日志管理 无统计管理无扩展性无安全性无性能无用户体验无批量配置应用场景01往往重复配置超过100次的配置要进行开发批量配置功能；02批量配置的模板要在界面上提供，可下载；03批量配置的模板导入后要进行校验，出错信息有信息提示；权限管理无 配置管理 无告警管理无诊断管理无日志管理批量配置动作要形成一条概括的日志记录，而不仅仅是拆分成多条操作记录；统计管理无扩展性无安全性无性能无用户体验无配置灵活性应用场景01配置的深度有系统级-》模块级-》设备类型级-》单体设备级；在进行模块配置设计时，往往要往更深度程度考虑。02算法类的场景都需要做成算法可配置，无论是诊断算法、预测算法、计费算法。03设备管理相关的信息配置要考虑做到设备类型级，甚至单体设备级；权限管理无 配置管理 无告警管理无诊断管理无日志管理无统计管理无扩展性无安全性无性能无用户体验无日志管理日志模块主要是进行系统架构优化，建立标准的日志管理规范。平台日志设计应用场景01平台日志管理模块为所有业务提供日志接口：接口内容分为两部分，一部分是日志固定项，即所有日志都需要填写的字段；一部分是日志动态项，即每个模块的特定日志字段，能动态加载业务模块的日志项。02日志种类包含两类：操作员日志和异常日志。操作员日志细分模块、子模块。异常日志细分模块、子模块、分级。03日志信息管理：提供整合查询，所有的日志由一个页面查询。04日志内容按日志种类细分。操作员日志需包含但不限于：时间、操作员名称、操作模块名称、操作动作名称、操作信息（合成）；涉及到设备级别的日志还需要考虑设备类型、所在区域、逻辑区域；异常日志包含时间、异常等级、异常模块名称、异常信息、其他重要信息。05操作员日志可分为平台日志和业务日志。平台日志：平台操作运维产生的日志，如进入某个模块、子模块；业务日志：业务操作日志，如充值、控制。业务操作运维产生的日志，如进入某个模块、子模块；06异常日志：程序异常退出、入参错误、进入异常分支时产生异常日志。日常日志要考虑分级设置，以防止大量日志打印影响系统性能；权限管理日志权限受到模块、子模块控制日志权限受异常级别控制区分查询、删除等日志操作权限 配置管理可设置是否产生异常日志，以及产生什么级别的异常日志告警管理无诊断管理无日志管理无统计管理支持对日志条数的统计区分操作日志、异常日志区分模块、子模块扩展性可能因为后续业务的发展而需要对接口进行扩展安全性无性能无用户体验无底层功能模块需求系统架构本次的系统架构主要是要求能在64bit操作系统上运行，且很多页面需要进行web定时刷新。IT框架：64bit的操作系统应用场景支持64bit的windowsserver；权限管理无 配置管理 无告警管理无诊断管理无日志管理无统计管理无扩展性无安全性无性能无用户体验无Web页面实时刷新应用场景web页面具备实时刷新能力，10分钟刷新一次；比如首页、能耗分析、能耗排名等页面；包含驾驶舱，APP页面；权限管理无 配置管理 无告警管理无诊断管理无日志管理无统计管理无扩展性无安全性无性能无用户体验无性能应用