文档怎么读
- 第一次接触平台：按「产品管理 → 设备管理 → 数据大屏」的顺序读，这条路径能把一条数据从设备跑到大屏。
- 要对接自己的系统：直接看「凭证与开放 API」与「协议网关」。
- 要部署到自己的机房：看「私有化部署」。
- 每一章末尾的「注意」都是实际操作中容易踩的坑，建议不要跳过。
一条数据在平台里的完整路径
理解这条路径，就能理解各模块的分工，也能在出问题时快速判断该去哪个模块排查。
- 在「产品管理」建一个产品，定义它有哪些属性（例如温度、压力、开关状态）。
- 在「设备管理」把真实设备注册到该产品下，设备获得平台身份。
- 设备通过 MQTT 上报，或由 Modbus 网关轮询采集，数据按产品与物模型落库。
- 在设备详情看实时数据流与历史曲线；需要控制时下发下行指令。
- 在「数据大屏」把关心的指标拖成一张看板，绑定设备数据后发布。
- 在「AI 助理」里用自然语言查询这些数据，或配置定时任务做周期巡检。
- 需要给外部系统用时，在「凭证管理」创建凭证，通过 OpenAPI 取数。
注意数据从设备到平台一般是秒级；大屏上的数据有一个刷新间隔（默认 10 秒，最小 5 秒），所以不要用大屏来判断毫秒级时序。
模块速查
- 产品管理：定义"这类设备长什么样"，一次建模、批量复用。
- 设备管理：管"具体哪台设备"，包括注册、状态、数据与指令。
- 数据大屏：把数据变成能给别人看的画面，可发布、可分享。
- AI 助理：用自然语言查数、下指令、做定时巡检。
- 凭证与开放 API：给第三方系统一把可控、可撤销的钥匙。
- 协议网关：设备侧怎么把数据送上来（MQTT 直连 / Modbus 轮询）。
- 私有化部署：把整套平台交付到自己的服务器。