iotsaas/README.md
2995840376 0ce191c448 chore: 初始化 iotsaas 版本库基线
纳入范围:
- 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
2026-10-27 12:00:41 +08:00

101 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 物联网系统平台
## 项目简介
企业级物联网系统平台,支持万级设备接入,兼容涂鸦、小度、小米等第三方平台,预留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