智能环境监测可视化平台需求规格说明书

一、 前言

1.1 需求背景

随着科技的发展，越来越多的智能化监测设备投入日常使用，其数据的准确度和采集效率相比人工大大提高，为企业的降本增效发挥着不可或缺的作用。如何快速收集、高效分析设备数据、及时处理设备异常，逐渐成为我们关注的重点。

1.2 需求描述

按单项目维度收集设备的各项监测指标，当设备出现故障时系统自动向管理员推送通知。需要有可视化的指标全局监测，便捷的数据分析功能。

1.3 专业术语

名词、缩略	解释
PM2.5	环境空气中空气动力学当量直径小于等于 2.5 微米的颗粒物
PPM	溶质质量占全部溶液质量的百万分比来表示的浓度，也称百万分比浓度
TVOC	测量到的室内所有挥发性有机物的总称
用户	使用系统的人员，不同用户可能拥有不同的角色，查看到项目数也不同
角色	即身份，不同的身份所能操作的内容可能不同

1.4 室内空气品质分档表

污染物	单位	优	中	差
PM2.5	μg/m3	＜35	35～75	＞75
CO2含量	ppm	＜800	800～1000	＞1000
TVOC	mg/m3	＜0.3	0.3～0.5	＞0.5
甲醛	mg/m3	＜0.03	0.03～0.08	＞0.08

1.5 数据结构说明

1.5.1 单行文本框

默认为500个字符长度，特殊情况会在输入框中进行说明。

1.5.2 时间格式

默认为yyyy-mm-dd h:mm:ss。

1.5.3 文本框筛选条件

所有文本查询条件，查询时都需要去掉前后空格后模糊查询

1.5.4 文字格式

宋体 5号，单元格长度不够时隐藏尾部，鼠标悬浮显示全部

1.5.5 按钮

点击确定按钮都需做必填校验。

1.6 预期读者与阅读建议

参加需求评审的人员要仔细阅读侧重点相关内容，并提出自己建议，以并修改和完善。

预期读者	阅读建议
参加需求评审的人员	仔细阅读与其评审侧重点相关的内容。
系统设计人员	仔细阅读全部内容。
系统测试人员	仔细阅读全部内容
业务方负责人	仔细阅读全部内容
……	……

二、 系统概述

2.1  系统部署

服务器配置

本地服务器	硬件	最低要求	备注
	内存	16G
	CPU	I5九代
	硬盘	100G
	操作系统	Windows10  1903企业版windows server 2012 R2+	建议 windows server 2019
云服务器API
	内存	32G
	CPU	xeon-E5 8核
云服务器数据
	内存	32G
	CPU	xeon-E5 12核
	硬盘	2T
前置Nginx服务器
	内存	16G
	CPU	xeon-E5 8核
	硬盘	60G

2.2  系统功能

无。

2.3  运行环境

JAVA。

2.4  系统用户

建议分为 管理员+普通操作人员两类

超级管理员：可操作所有页面功能，任命管理员。

管理员：建议每个项目1-2人，进行项目创建、设备绑定等

操作人员：使用管理员分配的角色，进行看板、设备等查看添加。

三、 总体功能描述

3.1 业务介绍

按照单项目维度进行管理、展示。允许添加项目；添加和绑定设备到项目；设备实时传输数据指标、故障信息到后台，最终在系统进行中全面展示。通过对用户的菜单权限、项目权限设置，确保登录用户只能查看有授权项目的数据。管理者足不出户即可一览各项指标，发送指令到工程师修复故障设备。

3.2 业务流程图

3.3 业务流程说明

添加项目才能绑定设备，且项目与设备绑定存在多对多关系；

添加用户的前提是：有可选角色 + 已添加项目；

3.54系统主页面

输入用户名、密码，点击登录匹配数据库。

验证通过后，展示登录用户有权限的项目，点选任一后进入系统，默认打开【项目管理】。

四、功能详细介绍

4.1 设备管理

4.1.1 功能简介

查看单项目设备数量与状态、将设备与某项目绑定、进行设备的可视化配置。

点击左上角汉堡菜单可切换左侧菜单的折叠展开；

点击右上角【切换项目】按钮会展示可切换项目，跳转新项目；

点击右上角【全屏】按钮进入全屏模式，体验更好的看板；

点击右上角用户名可进入个人中心、首页看板、退出登录并回到首页。

4.1.2 功能页面

4.1.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	总数			√		字符型	=下方列表中设备总数
	在线设备			√		字符型	=下方列表中状态为“在线”的设备个数
	离线设备		√	√		字符型	=下方列表中状态为“离线”的设备个数
	传感器					数值型	=下方列表勾选类型是“传感器”的设备个数
	电表					数值型	=下方列表勾选类型是“电表”的设备个数
	水表					数值型	=下方列表勾选类型是“水表”的设备个数
	序号			√		字符型	从1开始生成顺序编号
	设备号			√		字符型
	设备名称			√		字符型
	设备类型			√		字符型
	区域			√		字符型
	软件版本号			√		字符型
	最后在线时间			√		字符型
	状态			√
	操作						按钮
	查询						按钮
	可视化配置						按钮

4.1.4 功能要求

• • 权限：只显示登陆用户有数据权限的项目；
  • 排序：按照创建日期倒序排列；
  • 数量：默认20条，支持切换显示条数；
  • 【查询】点击后按照输入字符进行检索显示；
  • 【可视化配置】点击打开【可视化数据】界面，并加载所勾选设备的指标
  • 【绑定项目】点击打开【项目选择】弹窗，加载所有项目列表，显示该设备目前的勾选状态，支持多选。点击【确认】后保存并返回【设备管理】页面；
  • 
    【项目选择】弹窗如下图：
  • 

4.1.5 输出要求

写入数据库。

4.2 项目管理

4.2.1 功能简介

查看系统中的项目清单、所在地、已绑定设备、操作绑定设备及增删项目。

4.2.2 功能页面

4.2.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	项目ID					字符型
	项目名					字符型
	城市					字符型
	看板标题					字符型
	创建日期					日期时间	格式yyyy-mm-dd hh:mm 24小时制
	证书						按钮
	操作						按钮
	添加						按钮

4.2.4 功能要求

• • 【添加】点击打开【添加项目】编辑弹窗（功能介绍见4.2.5）；
  • 【证书】首次添加的项目显示【生成证书】，点击后需上传证书文件，上传完毕后，切换为【下载证书】，点击可下载电子档到本机；
  • 【操作】项目添加后按序生成【查看】【编辑】【绑定设备】【删除】4个按钮；

【查看】点击打开【添加项目】弹窗，只看查看添加明细，不可保存；

【编辑】点击打开【添加项目】弹窗，可编辑，保存即刻生效；

【绑定设备】点击打开【设备绑定】弹窗，加载当前项目已关联的设备清单，支持再添加；（功能介绍见4.2.6）

【删除】点击提示“确认删除XX吗？”，选确认则从列表中删除；

• 权限：列表展示所有项目清单，不做数据权限控制；
• 排序：按照创建日期倒序排列；
• 数量：默认20条，支持切换当页条数；

4.2.5【添加项目】编辑弹窗

4.2.5.1 功能页面

4.2.5.2 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
项目信息	项目ID	√				字符型
	项目名称	√			√	字符型		红字提示“请输入项目名称”
	看板标题	√				字符型
	支持图表切换		√			枚举型	是、否
	城市	√	√		√	下拉列表	城市选择控件，最低一级到地级市；支持输入选择	红字提示“请选择城市”
	模板配置		√			枚举型	五种模板，分别是：北京庄园-办公室、北京田园、综合数据、环境检测、能耗监测。可多选
	取消						按钮
	确定						按钮

4.2.5.3 功能要求

• • 【取消】点击关闭弹窗；
  • 【确定】校验必填；若项目ID为空，则按照预制规则生成ID。保存后关闭弹窗并刷新【项目管理】列表

4.2.6【设备绑定】编辑弹窗

4.2.6.1  功能页面

4.2.6.2 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
项目信息	序号					字符型	从1开始顺序生成编号
	项目ID					字符型
	设备名					字符型
	设备类型					字符型
	区域					字符型
	状态					字符型
	操作						按钮
	添加						按钮

4.2.6.3 功能要求

• 【操作】点击【删除】按钮，从当前列表删除该设备；
• 【添加】点击打开【设备选择】弹窗，加载设备库中所有状态的设备，支持多选，翻页保留前页选中状态。点确定后将勾选设备添加到上级【设备绑定】列表。
• 【设备选择弹窗】见下图

4.3 运行管理

4.3.1 功能简介

      点击运行管理，选择单一设备，页面展示温度、湿度等各项指标，其中趋势图的统计周期可切换。选择感应器、水表、电表后页面显示指标不同。

4.3.2 功能页面

4.3.3 输入要求

	信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
			手工输入	手工选择	自动带出	必须录入	字段类型
	列表信息	运行管理					枚举型
		温度					数值型	选择设备后自动加载
		湿度					数值型	选择设备后自动加载
		PM2.5					数值型	选择设备后自动加载
		CO2					数值型	选择设备后自动加载
		TVOC					数值型	选择设备后自动加载
		电表					数值型	选择设备后自动加载
		水表					数值型	选择设备后自动加载
		历史监测数据						图表
		导出						按钮

4.3.4 功能要求

• 运行管理：下拉选项，有两级，一级是设备分类：传感器、电表、水表；二级是具体设备。点选一级后自动加载二级，取设备管理对应类型的设备名称。
• 运行管理：选择二级设备后，自动加载该设备的当前指标。所选一级不同，页面的指标多少也会不同。
• 传感器：TVOC、温度、PM2.5、CO2、温度、环境质量；
• 电表：电表；
• 水表：水表，详见系统
• 历史检测数据：所选设备各项指标的折线图，可切换指标，或统计周期。周期包括：最近24小时、最近一周、最近半个月、最近半年，默认最近一周。支持导出

4.3.5 输出要求

无。

4.4 能耗管理

4.4.1 功能介绍

查看某项目当日0:00~当前时间，所有设备的耗电量、用水量；折线图可查看历史。

4.4.2 功能页面

4.4.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
	实时用电					数值型	该项目当天0:00到当前时间的用电量
	区域能耗						图表
	实时用水					数值型	该项目当天0:00到当前时间的用水量
	趋势图						图表
	导出						按钮

4.4.4 功能页面

• 区域能耗：位置图
• 趋势图：按周期查看项目的水电消耗量。周期包括：最近24小时、最近一周、最近半个月、最近半年，默认最近一周
• 【历史检测数据】支持导出

4.4.5 输出要求

无。

4.6 用户管理

4.6.1 功能介绍

添加新用户、编辑老用户账号信息、直接修改密码。

4.6.2 功能页面

4.6.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	姓名					字符型
	角色					字符型
	手机					字符型
	邮箱					字符型
	项目					字符型
	编辑					按钮
	修改密码					按钮
	删除					按钮
	添加					按钮

4.6.4 功能要求

• 【添加】点击打开【添加用户】弹窗（功能介绍见4.6.5
• 【编辑】点击打开【编辑用户】弹窗，确认后覆盖原用户数据；
• 【修改密码】点击打开【修改密码】弹窗，确认后覆盖原密码；
• 【删除】点击后提示“确定删除XXX(姓名)？”，确认即可删除数据

4.6.5【添加用户】弹窗

4.6.5.1 功能页面

4.6.5.2 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	账户	√			√	字符型		红字提示“请输入账户”
	密码	√			√	字符型		红字提示“密码”
	手机	√				字符型
	邮箱	√				字符型
	角色		√		√	枚举型	展示系统中已配置的角色 单选	红字提示“请选择角色”
	项目		√		√	枚举型	展示系统中已添加的项目 多选	红字提示“请选择项目”
	取消						按钮
	确定						按钮

4.6.5.3 功能要求

• 【取消】关闭当前弹窗；
• 【确认】点击校验必填，通过过保存成功，并刷新【用户管理】列表

4.6.5.4 输出要求

写入数据库。

4.7 角色管理

4.7.1 功能介绍

添加/删除系统角色、编辑角色可见菜单及项目。

4.7.2 功能页面

4.7.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	序号					字符型
	角色名称					字符型
	操作						按钮
	添加						按钮

4.7.4 功能要求

• 【操作】

查看：点击打开【查看角色】弹窗，只读；

编辑：点击打开【编辑角色】弹窗，可编辑；

删除：点击提示“确认删除XX(角色名称)？”，确认后删除该角色

• 【添加】点击打开【添加角色】弹窗。

角色名：必填，字符型；

菜单：枚举型，列举系统所有页面。支持多选。

点【确认】后保存并关闭当前弹窗

【查看/编辑/添加角色】

弹窗如下图

4.7.4 输出要求

无

4.8  错误信息

4.8.1 功能介绍

查看设备出现各种故障数量、解决情况。

4.8.2 功能页面

4.8.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	已解决					字符型	统计出现三种故障之一后故障排除的数量
	轻微故障					字符型	统计设备报轻微故障的数量
	严重故障					字符型	统计设备报严重故障的数量
	致命故障					字符型	统计设备报致命故障的数量
	当前处理故障					字符型	统计当前在维修中的设备数量
	设备名称	√				文本框	支持模糊查询
	故障级别		√			下拉选框	参数化配置，包括：不限、轻微故障、严重故障、致命故障。
	处理状态		√			下拉选框	参数化设置，包括：已处理、处理中、未处理。
	编号					字符型
	设备ID					字符型
	故障描述					字符型	设备自动推送
	故障级别					字符型	设备自动推送
	故障代码					字符型	设备自动推送
	处理状态					字符型
	编辑						按钮
	删除						按钮

4.8.4 功能要求

• 【编辑】
• 【删除】

4.8.5 输出要求

无

4.9  历史数据

4.9.1 功能介绍

查看项目在某个周期内的环境监测指标、水电消耗量。

4.9.2 功能页面

4.9.3 功能要求

• 页面由三部分组成，分别是：区域能耗折线图、实时用水趋势柱状图、电能趋势图。
• 统计周期选项：最近24小时、最近一周、最近最近一个月、最近半年。
• 区域能耗包括：CO2、甲醛、温度、PM2.5、TVOC、温度

4.9.4 输出要求

无

4.10 消息推送

4.10.1 功能介绍

设备故障时，系统自动向工程师推送故障通知；手动向指定人员发送通知；

消息传送渠道为微信公众号。

4.10.2 功能页面

4.10.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	序号					字符型
	城市					字符型
	内容	√				字符型
	设备号					字符型
	故障描述					字符型
	发送						按钮

4.10.4 功能要求

• 【发送】点击后即可将内容通过微信传至用户

4.10.5 输出要求

无

4.11 系统信息

4.11.1 功能介绍

系统版本查看

4.11.2 功能页面

4.11.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	当前版本号					字符型
	版本更新					字符型
	二维码						图片

4.11.4 功能要求

功能说明

• 版本更新按条列出，按照发布日期倒序排列；
• 二维码为公众号平台二维码，用户扫码关注可接收推送消息。

4.11.5 输出要求

无

4.12 可视化数据

4.12.1 功能介绍

看板的形式展示各项指标，需要在【设备管理】中预先做可视化配置。

4.12.2 功能页面

 

4.12.3 输入要求

信息类别	信息项	产生方式					说   明	出错时的校验、提示信息
		手工输入	手工选择	自动带出	必须录入	字段类型
列表信息	温度						图表
	湿度						图表
	PM2.5						图表
	CO2						图表
	TVOC						图表
	甲醛						图表
	环境质量						图表
	电能						图表
	水表						图表
	天气预报						图表
	环境趋势图						图表
	水电量统计图						图表
	故障信息						图表
	设备信息						图表
	新风设备					字符型
	空调设备					字符型

4.12.4 功能要求

• 数据展示，无操作。

4.12.5 输出要求

无