纳入范围: - backend/ Spring Boot 多模块后端(iot-common/device/rule/data/alarm/auth) - frontend/admin/ Vue3 + Element Plus 管理后台 - Android/ 涂鸦原生 APP (com.xhai.iot) - backend/sql/ Flyway 风格迁移脚本(V2~V21) - docs/ 对接文档与设计文档 排除范围: - 构建产物: node_modules/ target/ build/ dist/ .gradle/ - 签名密钥: *.jks *.keystore (严禁入库) - 本机配置: Android/local.properties - 运行日志: logs/ *.log - AI 协作本地数据 .codebuddy/ 与第三方 demo tuya-demo/ .gitattributes 统一以 LF 存储, Windows 批处理保留 CRLF
101 lines
2.2 KiB
Markdown
101 lines
2.2 KiB
Markdown
# 物联网系统平台
|
||
|
||
## 项目简介
|
||
|
||
企业级物联网系统平台,支持万级设备接入,兼容涂鸦、小度、小米等第三方平台,预留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
|
||
|
||
### 后端启动
|
||
```bash
|
||
cd backend
|
||
mvn clean install
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
### 前端启动
|
||
```bash
|
||
cd frontend/admin
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
### Docker一键启动
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
## 核心功能
|
||
|
||
- 设备管理与监控
|
||
- 实时数据采集
|
||
- 规则引擎与联动
|
||
- 告警服务
|
||
- 多平台设备适配
|
||
- 数据可视化看板
|
||
- 用户权限管理
|
||
|
||
## 开发文档
|
||
|
||
详细开发文档请参考 [docs/](docs/) 目录。
|
||
|
||
## 许可证
|
||
|
||
Copyright © 2026 IoT Platform
|