数据总览
实时查看网关、通道、电表及采集服务状态。
MQTT 网关
-
-
电表数量
-
-
待执行队列
-
按网关通道独立排队
电表在线率
-
-
有功总电量 · 最近 24 小时
IoTDBkWh
当前为占位曲线，接入 IoTDB 后替换为真实数据
网关状态
加载中…
系统健康
未知MQTT 连接
采集服务
IoTDB
上次检查 -
模型管理
平台内置的电表型号与测点定义，写死在 core/meter_models.py，启动时自动同步。
型号列表
| 型号编码 | 名称 | 协议 | 驱动 | 版本 | 测点数 | 关联电表 | 能力 | 状态 | 操作 |
|---|
网关管理
管理接入 MQTT 服务器的现场采集网关。
| ID | 网关名称 | MQTT 订阅地址 | MQTT 发布地址 | 命令间隔 | 命令超时 | 电表 | 自动采集 | 在线状态 | 最后数据 | 操作 |
|---|
电表管理
登记现场电表，指定所属网关与型号。
| ID | 电表名称 | 表号 | 所属网关 | 型号 | 电量 | 拉合闸状态 | 在线状态 | 最后通信 | 操作 |
|---|
历史数据
采集历史存入 IoTDB；SQLite 仅维护配置与最新状态。当前展示最近采集记录。
| 时间 | 电表 | 操作号 | 类型 | 耗时 | 状态 | 原始报文 |
|---|
运行日志
查看 MQTT、任务调度、电表协议及 IoTDB 写入日志。
系统设置
采集器运行策略、MQTT、IoTDB、认证与电表驱动配置。
采集调度
config.json / 环境变量系统组件
登录与会话
加载中…
数据备份
加载中…
MQTT 服务器
检测中…
IoTDB 时序库
检测中…
电表驱动
| 驱动型号 | 名称 | 协议 | 版本 | 测点数 | 能力 | 状态 |
|---|
用户账号
角色决定权限：观察者只能看数据，不能编辑、不能拉合闸、不能调接口，
也看不到 MQTT / IoTDB 的连接细节。
| 用户名 | 显示名 | 角色 | 权限 | 状态 | 最后登录 | 操作 |
|---|
开发者选项
给外部系统调用的接口。全部按表号操作，不依赖平台内部 ID。 下面的示例用的是本平台真实的地址和表号，可以直接复制运行。
① 先拿访问令牌
所有接口都要认证，请求头统一带
Authorization: Bearer <token>。
凭据分两种，按用途选 —— 别拿会话令牌去做对接。
接口令牌对接系统用这个
长期有效，不受「1 小时空闲退出」影响，可以随时吊销
加载中…
会话令牌临时调试用
账号密码换来，- 小时上限、
空闲 - 分钟自动失效
④ 通用约定
| 项 | 说明 |
|---|---|
| 返回格式 | 成功 {"ok":true,"data":{...}}；
失败 {"ok":false,"error":{"code":"...","message":"..."}} |
| 表号 | 按数字比较，前导零可省。
1600087805 和 001600087805 是同一块表 |
| 表号重复 | 表号只在同一个网关内唯一。
若两块表在不同网关上用了同一个表号，接口会返回 ambiguous_addr，
需要加 gateway 参数（网关 id / 编号 / 名称都行）指定 |
| 权限 | 调用对外接口需要 api 权限
（管理员、操作员有，观察者没有）；其中抄表还要 collect、拉合闸还要 control ——
接口和界面用的是同一把锁，不会出现「页面上点不动、用接口却能操作」的口子 |
| 常见错误码 |
unauthorized 没带令牌 ·
session_expired 会话过期（12 小时上限）·
idle_timeout 会话空闲超时（1 小时没操作）·
forbidden 权限不足 ·
meter_not_found 表号不存在 ·
ambiguous_addr 表号在多个网关重复 ·
invalid_param 参数不合法 |
| 探活接口 |
GET /api/health 不需要认证，只回 {"status":"up"}
和运行时长，给监控 / 负载均衡用；不含任何业务数据 |
| 跨域调用 | 默认不返回 CORS 头。
需要浏览器直连时，在 config.json 的
security.cors_origins 里填白名单（填 ["*"] 放开全部） |
| 数据删除 | 删除电表会同时删除它在 IoTDB 里的历史数据。
只想删档案、保留时序数据时，用
DELETE /api/meters/<id>?keep_data=1 |