平台架构概览 (Platform Overview)
本章节旨在帮助新成员快速理解 YunStack-IoT 平台的设计理念、架构组成以及核心交互流程。
为了让您能够循序渐进地掌握平台技术，我们建议按照以下顺序阅读文档：
📚 阅读路径建议
第一阶段：认知与概览
目标：了解这套系统长什么样，解决什么问题。
- 01.系统架构设计
- 必读。包含系统逻辑分层图（设备端、接入层、服务层、应用层）及各模块职责说明。看完后您脑海中应该有一张系统的全景图。
- 02.核心业务流程
- 必读。通过时序图展示了最核心的两个场景：“设备上报数据” 和 “用户控制设备”。理解了这两个流程，就理解了 IoT 平台 80% 的工作机制。
第二阶段：接入与开发
目标：动手开发，让设备连上云端，或开发后端/前端功能。
- 03.物模型设计规范
- 开发核心。定义了设备的能力（属性、事件、服务）。如果您要接入一个新设备（如温湿度传感器），首先需要看这里如何定义 JSON 格式。
- 04.MQTT通信协议
- 通信核心。规定了设备该往哪个 Topic 发消息，Payload 格式是什么，以及如何进行权限认证。嵌入式开发和后端开发都需要严格遵守此规范。
第三阶段：深入与参考
目标：理解设计背后的权衡，以及查阅具体的技术细节。
- 05.技术栈选型
- 列出了后端 (NestJS)、数据库 (PostgreSQL+InfluxDB)、前端 (Vue3/UniApp) 等核心技术的选型理由。
- 06.深度解析_消息接入决策
- 进阶阅读。详细记录了我们在“Webhook vs MQTT 直连”方案上的权衡过程。如果您对架构设计感兴趣，推荐阅读。
⚡ 快速导航
| 模块 | 描述 | 链接 |
|---|---|---|
| 全景图 | 系统整体逻辑架构 | 01.系统架构设计 |
| 交互时序 | 设备数据上报/控制流程 | 02.核心业务流程 |
| 物模型 | 设备能力定义 (JSON) | 03.物模型设计规范 |
| MQTT | Topic 与 Payload 定义 | 04.MQTT通信协议 |