一、 前言
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 输入要求
信息类别 |
|
|
|
| ||||
|
|
|
|
| ||||
项目信息 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
|
|
|
|
|
|
| |
|
|
|
|
|
|
|
| |
|
|
|
|
|
|
|
| |
|
|
|
|
|
|
|
| |
|
|
|
|
|
|
|
| |
|
|
|
|
|
|
|
|
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 输出要求
无