RuoYi-Vue-Pro 架构总览
IoT 物联网

核心定位

IoT 模組是一個類阿里雲物聯網平臺的裝置管理平臺。它可以接入海量裝置，透過物模型定義裝置能力，利用規則引擎處理裝置資料，實現裝置資料採集、遠端控制和場景聯動。

一句話：如果你的硬體裝置需要接入雲端管理，這裡提供從裝置註冊到資料流轉的完整鏈路。

解決什麼問題

痛點IoT 如何解決
裝置接入協議多樣支援 MQTT/HTTP/CoAP/TCP/UDP/WebSocket/Modbus 等
裝置資料格式不統一物模型標準化裝置能力定義
裝置資料不知道如何處理規則引擎 → 資料流轉/場景聯動/告警
裝置韌體升級困難OTA 遠端升級
需要對接第三方 IoT 平臺內建 EMQX 整合，可自定義協議

使用者角色

graph LR subgraph 角色 IOT_ADMIN["IoT 管理員
定義產品
管理裝置
配置物模型
設定規則引擎"] IOT_DEV["裝置開發者
裝置端開發
協議對接
OTA 升級"] IOT_OP["運維人員
監控裝置狀態
處理告警
資料分析"] end

平臺架構

graph TB subgraph 裝置層["裝置層"] D1["感測器"] D2["閘道器"] D3["控制器"] D4["智慧裝置"] end subgraph 接入層["接入層（多協議）"] P1["MQTT"] P2["HTTP"] P3["CoAP"] P4["TCP/UDP"] P5["WebSocket"] P6["Modbus"] end subgraph 平臺層["IoT 平臺"] PRODUCT["產品管理
定義裝置型別"] DEVICE["裝置管理
註冊/認證/狀態"] MODEL["物模型
屬性/服務/事件"] OTA["OTA 升級
韌體遠端更新"] end subgraph 處理層["資料處理層"] RULE["規則引擎
資料規則/場景聯動/告警"] TD["TDengine
時序資料儲存"] end 裝置層 --> 接入層 接入層 --> 平臺層 平臺層 --> 處理層

物模型設計

物模型是 IoT 的核心概念，用標準化的方式描述裝置「有什麼屬性、能做什麼、會報告什麼」：

graph TB subgraph 物模型["物模型 = 裝置的數字化描述"] ATTR["屬性 Property
裝置的靜態特徵
例：溫度、溼度、開關狀態"] SERVICE["服務 Service
裝置可執行的操作
例：開鎖、重啟、校準"] EVENT["事件 Event
裝置主動上報的資訊
例：告警、故障、完成通知"] end

規則引擎

flowchart LR DATA["裝置資料"] --> ENGINE["規則引擎"] ENGINE -->|資料規則| ROUTE1["資料路由
儲存到 TDengine
轉發到 HTTP/Kafka"] ENGINE -->|場景聯動| ROUTE2["場景聯動
溫度 > 30°C → 自動開風扇"] ENGINE -->|告警配置| ROUTE3["告警
裝置離線 > 5 分鐘 → 傳送通知"]

裝置生命週期

flowchart LR CREATE["建立產品
定義物模型"] --> REG["註冊裝置
獲取認證資訊"] REG --> ONLINE["裝置上線
建立連線"] ONLINE --> WORK["正常工作
上報資料/接收指令"] WORK --> OTA2["OTA 升級"] OTA2 --> WORK WORK --> OFFLINE["裝置下線"] OFFLINE --> ONLINE

支援的協議

協議適用場景特點
MQTT物聯網主流協議輕量、釋出訂閱、QoS
HTTP簡單裝置、Web 應用通用性強
CoAP低功耗裝置類 HTTP、UDP
TCP自定義協議靈活、高效
UDP高頻資料上報低延遲
WebSocket實時雙向通訊瀏覽器友好
Modbus工業裝置工控標準
EMQX高效能 MQTT Broker百萬級連線
自定義協議特殊裝置擴充套件開發

技術依賴

  • TDengine：時序資料庫，用於儲存裝置上報的海量時序資料（需額外搭建）
  • EMQX：高效能 MQTT Broker（可選，用於大規模裝置接入）
docs