aiot-document/开发者文档/03-IoT领域/00-IoT领域总览.md

00-IoT领域总览

本文档是 AIOT 平台 IoT（物联网）领域的核心入口。 当前阶段，研发重心正从 Ops（人工作业）向 IoT（设备物联）全面转移。

一、当前建设重心

IoT 领域不再是停留在 PPT 上的规划，而是当前正在落地的战场。我们必须解决三个核心问题：

1. 设备怎么连上来：设备注册、认证、保活心跳、MQTT 报文解析。
2. 数据长什么样：定义统一的“物模型”，让后端业务逻辑不需要去管设备底层是透传的 Hex 还是非标的 JSON。
3. 数据怎么用：如何将冷冰冰的设备遥测数据，通过规则引擎转化为业务系统（Ops）关心的“告警事件”并触发工单。

二、架构解耦原则（铁律）

在阅读和编写下属文档时，必须时刻牢记：“南向屏蔽，北向统一”。

• 南向（面向设备）：允许混乱。允许存在 MQTT、HTTP、TCP 各种协议；允许 payload 千奇百怪。
• 北向（面向业务）：必须干净。所有向 Ops 抛出的事件、所有存储到数据库的属性，必须是经过「物模型」标准转换后的统一格式。
• 绝对禁止：在工单、保洁等业务 Service 里直接引入诸如 MqttClient，或者直接去 parse 设备的原始报文。

三、核心文档阅读指引

请按顺序阅读以下标准设计：

1. 01-设备接入与控制主链路.md
   • 关注网络层和会话层。定义了设备从开机到上线、数据上报和接收指令的全过程（Mermaid 时序图）。
2. 02-物模型标准设计.md
   • 关注数据表示层。定义了“属性（Property）”、“事件（Event）”和“服务（Service）”的三要素规范，以及设备影子的机制。
3. 03-规则引擎与联动策略.md
   • 关注业务逻辑层。说明了大量传感器数据如何经过防抖、过滤，最终安全地跨域调用 Ops 接口生成维修/应急工单。

⚠️ 注意：本目录下的规范即代表开发契约，开发进行代码结构设计和数据库表设计时，必须与之对齐。