新增:
- iot-common/PlatformType: 平台维度单一真相源(枚举)
统一 tuya/matter/local/xiaomi/huawei/dueros/alexa/google_home,
提供 legacy 别名归一(miot|mi -> xiaomi)与已知性判定
- backend/sql/V22__product_device_arch_refactor.sql: 幂等迁移(153行)
A. platform_type 平台字典表 + 种子数据(后台可维护)
B. product 加 protocol 列; platform_product_id 空串清洗为 NULL;
清洗 model/manufacturer 被涂鸦 productId 污染的历史脏数据;
加 (platform, platform_product_id, deleted) 唯一约束
C. product_property 加 grp/is_primary/enum_label + (product_id,code) 唯一约束
D. product_event/product_action 加 (product_id,code) 唯一约束;
product_action 加 completion_mode
E. device 加 product_id 索引(OTA 物化目标设备此前全表扫); platform 归一
改造:
- DeviceAdapter 新增 platform() 显式声明平台
- DeviceAdapterManager 改为按 platform() 精确匹配,
移除'类名是否包含平台字符串'的脆弱约定(类名与平台码不同名会静默降级)
- DevicePlatform 委托 PlatformType, 消除第四套平台取值域
验证: mvn -pl iot-common,iot-device -am compile 通过
物联网系统平台
项目简介
企业级物联网系统平台,支持万级设备接入,兼容涂鸦、小度、小米等第三方平台,预留Matter协议扩展接口。
技术栈
后端
- Java 17
- Spring Boot 3.2.x
- Spring Security (认证鉴权)
- MyBatis Plus (持久层)
- MySQL 8.0 (关系数据库)
- InfluxDB 2.x (时序数据库)
- Redis 7.x (缓存)
- RabbitMQ (消息队列)
- EMQX (MQTT Broker)
- XXL-Job (任务调度)
前端
- Vue 3 + TypeScript
- Vite 5.x
- Element Plus (UI组件库)
- Pinia (状态管理)
- Axios (HTTP客户端)
- ECharts (数据可视化)
- UniApp (移动端)
项目结构
iotsaas/
├── backend/ # 后端项目
│ ├── iot-common/ # 公共模块
│ ├── iot-auth/ # 认证服务
│ ├── iot-gateway/ # API网关
│ ├── iot-device/ # 设备管理服务
│ ├── iot-data/ # 数据采集服务
│ ├── iot-rule/ # 规则引擎服务
│ ├── iot-alarm/ # 告警服务
│ └── iot-adapter/ # 设备适配器模块
│ ├── tuya/ # 涂鸦适配器
│ ├── dueros/ # 小度适配器
│ ├── miot/ # 小米适配器
│ └── matter/ # Matter适配器
├── frontend/ # 前端项目
│ ├── admin/ # Web管理后台
│ └── mobile/ # 移动端APP
├── docs/ # 文档
├── docker/ # Docker配置
├── scripts/ # 脚本工具
└── deploy/ # 部署配置
快速开始
环境要求
- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Redis 7.x
- Docker & Docker Compose
后端启动
cd backend
mvn clean install
mvn spring-boot:run
前端启动
cd frontend/admin
npm install
npm run dev
Docker一键启动
docker-compose up -d
核心功能
- 设备管理与监控
- 实时数据采集
- 规则引擎与联动
- 告警服务
- 多平台设备适配
- 数据可视化看板
- 用户权限管理
开发文档
详细开发文档请参考 docs/ 目录。
许可证
Copyright © 2026 IoT Platform
Description
Languages
Java
75.4%
Vue
18.9%
TypeScript
4.3%
Batchfile
0.9%
JavaScript
0.3%
Other
0.1%