主题
实时数据
1、概述
本模块用于展示所有站点设备的 最新上报数据，包括实时液位、密集周期采集数据、信号强度、电池电压等关键指标。系统每小时自动采集一次主数据，同时在特定时间段内以 10分钟为间隔 进行密集周期采集（共6次），便于分析设备运行趋势与稳定性。
用户可通过站点区域、站点名称、设备编号进行快速检索，查看当前状态及历史记录。支持导出功能，满足报表生成与数据分析需求。 
2、实时数据展示
2.1 数据来源
- 每个站点设备 每小时上报一次主数据（即“实际液位”）。
- 在每小时的前60分钟内，每隔10分钟进行一次 密集周期采集，共采集6条数据。
- 实际液位显示为空表示本次上报数据中未能提取出有效的液位数值（例如数据格式异常、数值无效等）。
- 密集周期数据 ：
- 显示“--”： 表示数据已正常上报并被系统接收到，但在解析过程中未能提取出有效的液位数值（例如数据格式异常、数值无效等）；
- 显示为空（即无任何内容）：表示该时刻未采集到数据或设备未上报数据。
- 如果当前小时尚未完成上报，系统将在下一小时补传该小时的数据。
2.2 字段说明
| 字段 | 说明 |
|---|---|
| 站点区域 | 设备所属的上级区域名称，支持按区域筛选 |
| 站点名称 | 站点的中文名称，便于识别 |
| 设备编号 | 唯一标识符，用于系统内部识别 |
| 上报时间 | 最近一次数据上传的时间 |
| 实际液位 | 当前小时上报的实际液位值（单位：米），若未采集到则显示为空 |
| 密集周期数据 | 每10分钟采集一次的6条数据 |
| 信号强度 | 通信信号强度，单位为 dBm 参考标准： 🔵 ≥ -90 dBm：良好信号，通信稳定 🟡 -90 ~ -100 dBm：一般信号，可能轻微波动 🔴 < -100 dBm：弱信号，存在通信风险 |
| 信噪比 | 接收信号与噪声的比例（dB） 数值越高表示抗干扰能力越强 建议值 ≥ 10 dB，> 20 dB 为优秀 |
| 电池电压(V) | 当前设备电池电压（单位：伏特） 参考标准：3.5V ~ 3.7V |
| 操作 | “详情”按钮，点击可查看该设备的历史上报记录 |
3、查询与过滤功能
3.1 查询条件
| 条件 | 说明 |
|---|---|
| 站点区域 | 下拉选择框，可筛选指定区域下的设备 |
| 站点名称 | 输入框，支持模糊搜索站点名称 |
| 设备编号 | 输入框，支持精确匹配设备编号 |
💡 提示：多个条件可组合使用，提升查找效率。
3.2 操作按钮
- 重置：清空所有查询条件，恢复默认视图
- 查询：执行当前筛选条件下的数据加载
- 全屏：当前页面全屏展示
- 刷新（⟳）：手动刷新当前页面数据
- 设置（⚙️）：进入高级配置选项（如列显示隐藏）
4、详情页 — 历史数据查询
点击任意一条记录的“详情”按钮，进入该设备的 历史数据详情页。 
4.1 数据展示规则
- 默认展示 最近7天 的历史数据。
- 数据按 上报时间倒序排列（最新的在前）。
- 每小时仅保留一条主数据记录。
- 若某小时未上报，系统会在后续小时内补传（如有）。
4.2 支持功能
| 功能 | 说明 |
|---|---|
| 时间范围筛选 | 支持设置“开始时间”和“结束时间”，自定义查询区间 |
| 导出功能 | 支持将当前查询结果导出为 Excel 文件，包含全部字段 |
| 数据完整性 | 即使某小时未及时上报，系统也会在下个小时尝试补传，保证数据连续性 |
✅ 示例： 若某设备在 14:00 未上报，但 15:00 成功补传了 14:00 的数据，则历史记录中仍会显示该条数据，且时间标记为 14:00。
5、信号强度评估标准
| 信号强度 (dBm) | 状态 | 建议 |
|---|---|---|
| ≥ -90 dBm | ✅ 良好 | 通信稳定，无需干预 |
| -90 ~ -100 dBm | ⚠️ 一般 | 关注是否频繁掉线 |
| < -100 dBm | ❌ 弱信号 | 存在通信中断风险 |
📌 注：信号强度受环境影响较大，如墙体遮挡、金属屏蔽等会导致衰减。
6、数据采集机制说明
| 类型 | 频率 | 说明 |
|---|---|---|
| 主数据上报 | 每小时一次 | 固定时间点上报，包含实际液位、电池电压、信号强度等 |
| 密集周期采集 | 每10分钟一次 | 共6次，倒序排列（如 13:50, 13:40, 13:30, 13:20, 13:10, 13:00），用于监测短期波动 |
| 补传机制 | 自动触发 | 若某小时未成功上报，系统将在下一个小时尝试补传 |
💡 说明： 密集周期数据不作为正式上报记录，主要用于趋势分析。 主数据是唯一计入历史记录和报表的核心数据。
7、导出功能
7.1 实时数据导出
- 支持将当前查询结果导出为 .xlsx 格式文件。
- 包含所有可见字段：站点区域、站点名称、设备编号、上报时间、实际液位、密集周期数据、信号强度、信噪比、电池电压。
7.2 历史数据导出
- 支持将历史数据列表导出为 .xlsx 文件。
- 导出内容包括：上报时间、实际液位、密集周期数据、信号强度、信噪比、电池电压等。
8、注意事项
- 实际液位为空不代表设备故障，可能是暂时未采集到数据，建议结合信号强度判断。
- 若密集周期数据中出现多个 --，说明该时间段设备采集通信不稳定。
📌 附注：本功能依赖于设备端稳定的通信与定时上报机制。建议定期维护设备，清洗数据，确保信号覆盖与电源供应正常。