平台使用文档

01平台概览

今来物联是基于成熟物联网引擎构建的白标 SaaS 平台:设备数据统一接入、实时可视,告警主动触达,并支持数据转发与多租户运营。

整体架构

两种角色,一个平台

02快速开始:从零接入六步

从登录到看到第一笔设备数据,新用户平均 10 分钟即可完成。

03设备接入(MQTT / HTTP)

每台设备一个独立 Token(一物一码),标准 MQTT / HTTP 双通道接入;正式接入参数与报文规范将在对接开通时发布。

接入方式概览

接入通用流程

1. 在「设备接入 → 添加设备」创建设备,获得该设备独立的 Access Token。
2. 设备端使用 Token 鉴权,按平台提供的接入参数建立连接(MQTT)或发起上报(HTTP)。
3. 按设备模型中定义的数据 Key 上报 JSON 数据,数值、布尔、字符串均可。
4. 到「接入凭证 → 实时数据」做对点调试,核对报文到达与点位匹配情况。

接入凭证与对点调试

• 接入凭证页:集中管理全部设备 Token。默认打码显示,点击展示单台、再点即复制。
• 实时数据(对点调试):左侧为实时报文流(只显示新到达报文,绿色高亮,保留 60 条);右侧按点位对照判定——已上报(点表定义且正在报)、缺少(定义了但没报)、多出(报了但点表没定义),顶部有汇总徽标。

04设备模型与点位

设备模型是「一类设备」的模板:点位定义数据字段,报警规则定义阈值,同类设备共享规则。

设备类型

• 类型标识仅限英文字母 / 数字 / 下划线(字母开头),中文写在「说明」字段,前后端双层校验。
• 每类设备一张卡片,显示设备数、点位数、规则数,并可快捷跳转配置。
• 删除保护:类型下仍有设备时拒绝删除;删除类型会自动清理其点位。

点位配置

• 表格末行即添加行,新点位自动追加;支持勾选批量删除、「保存全部」整表提交。
• CSV 导入导出:可下载模板、Excel 编辑后批量导入,同 Key 覆盖更新、逐行报错。
• 脏数据保护:改动未保存会有黄条提示,切换类型被拦截,支持撤销修改。

报警规则与计算字段

• 报警规则:规则名 + 数据 Key + 条件 + 阈值 + 级别;规则对该类型全部设备生效,并自动附带反向清除规则(数据恢复正常自动清告警)。运算符按字段类型校验(数值型才可比大小)。
• 计算字段:由已有点位推导新指标(如由电流电压算功率)。
• 离线告警:模型自带「在线状态」字段,配合离线规则实现断连判警(见第 06 章)。

05设备管理

设备列表、详情、控制的日常操作。

设备列表

• 支持名称搜索、状态筛选、分页;可弹窗添加设备(类型动态下拉 + 名称实时查重)。
• 在线状态按最新遥测时间判定,而不是连接状态——只要按期上报数据即视为在线,避免"连着却不报数"的假在线。

设备详情

06告警中心

阈值告警 + 离线告警双判据,从触发、确认到自动清除的完整闭环。

告警怎么触发

1. 在设备模型 → 报警规则中配置阈值(如 起重量 > 75t → 严重)。
2. 设备上报数据后,平台规则引擎实时判断,命中即创建告警。
3. 数据恢复正常时,自动反向清除,无需人工关单。

离线告警

• 按「最新遥测时间」判据:超过设定分钟数(如 10 分钟)没有任何数据上报,即判定离线并产生告警。
• 设备恢复上报后告警自动清除;级别可按规则配置。

告警中心

• 实时告警:未确认的活动告警,10 秒自动刷新,侧边栏红点徽标提醒;支持「确认」「清除」操作。
• 告警历史:全量记录,按状态筛选 + 分页,满足追溯与迎检需要。

07可视大屏

深色大屏对外展示;支持 AI 生成页面、自动兜底模板与免登录分享。

创建与绑定

• 「可视大屏 → 我的大屏」新建,给大屏命名并绑定设备(可多台)。
• 编辑抽屉一屏搞定:改名 / 绑设备 / 复制 AI 材料 / 粘贴导入 HTML / 预览。

AI 生成大屏流程

1. 在大屏编辑中点击「AI 材料」:平台自动导出含接口契约、字段定义与样本数据的完整提示词。
2. 把材料粘贴给任意大模型(ChatGPT / Claude / 通义 / DeepSeek 均可),让它生成单页 HTML 大屏。
3. 回到平台「导入 HTML」粘贴保存,大屏立即替换为 AI 版本。
4. 点击「预览」生成 7 天有效期的免登录分享链接,可直接投屏或发给学生 / 客户 / 领导。

自动模板与公开 API

• 未导入 AI 页面时,大屏自动渲染深色科技风设备卡片,数据 5 秒刷新,创建即所得。
• 对外数据走公开接口 /api/ksh/{token}/devices/ 与 /api/ksh/{token}/telemetry/,免登录、按分享令牌隔离,可嵌入客户自有门户(iframe)。
• 「自定义页面」与「我的大屏」底层同一套能力,用于客户自建内部页面。

08云云对接

把设备数据转发到你自己的系统或第三方平台:Webhook 或 MQTT,租户自助配置。

云传通道配置

1. 进入「设备管理 → 云云对接」,为目标设备新建云传通道。
2. 选择目标类型:Webhook(HTTP 地址)或 MQTT(第三方 Broker)。
3. 拼装内容:选择要转发的字段,组织输出报文格式。
4. 设置冷却秒数控制推送频率(60 秒冷却 = 每分钟 1 次,多通道叠加)。
5. 「发送测试」验证连通,保存后即按数据到达 + 冷却规则持续推送。

计量与运营

• 平台按通道 × 天统计成功推送条数;管理端可查看每租户的通道数、今日推送量与理论频率。
• 推送频率与套餐档位挂钩(标准版 60 次/分钟,专业版 600 次/分钟)。
• 网关层另支持 Modbus / OPC-UA 等 20+ 工业协议的采集侧对接(专业版起,按需开通)。

09用户与权限

租户内自建用户与角色,精确控制"谁能看到哪台设备"。

用户管理

• 四件套建用户:名字 / 账号 / 密码 / 角色,免邮件激活。
• 用户-设备分配:分配了设备的用户只看被分配的设备;未分配则看本租户全部设备。设备级守卫覆盖详情、曲线、凭证、属性、告警等接口。
• 密码重置:管理员下发临时密码,用户首次登录免旧密码自行设置新密码。

角色管理

• 自建角色,勾选菜单范围即为该角色的可见权限(范围不超过本租户自身权限)。
• 租户管理员(is_owner)可:添加用户、分配角色、重置他人密码、使用设备控制、配置告警通知。

租户运营(管理员视角)

• 一步开户:租户名 + 套餐 + 管理员账号 + 菜单模板。
• 套餐配额:设备数 / 账号数 / 时长,配额由引擎层强制执行,到期自动停用、可续期。
• 审计:操作流水、云传概况、通知留痕、控制日志均可追溯;删除租户时全量善后清理。

10常见问题

按"数据源 → 网络 → 认证 → 平台 → 前端"的顺序逐层排查,绝大多数问题五分钟内定位。