feat: complete reverse engineering, standard Maven structure, detailed code annotations and IoT-M platform architecture
This commit is contained in:
1 parent
e8dc09fb3c
commit
cd6a4c70e7
3045 files changed
+566733
-1
No files matched your search
@@ -1 +1,152 @@
|
||||
# iot_m
|
||||
# IoT-M (CloudPulse-MDM) - 工业级智能终端与物联网设备云管控平台
|
||||
|
||||
[](https://www.oracle.com/java/)
|
||||
[](https://spring.io/projects/spring-boot)
|
||||
[](https://www.mongodb.com/)
|
||||
[](https://spring.io/)
|
||||
[](https://aws.amazon.com/s3/)
|
||||
|
||||
> **IoT-M** 是一套专为工业级手持终端(PDA)、车载智能平板、移动医疗设备及行业专用 POS 机设计的**企业级全生命周期物联网管控云平台 (Mobile Device Management / IoT Fleet Management Platform)**。
|
||||
> 系统具备**低延时全双工长连接通道、多云融合对象存储、OTA 固件空中差分升级、电池健康度时序遥测 (BMS) 及端到端硬件级安全防御**能力。
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ 系统架构图 (端-边-云协同)
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
subgraph Edge ["受控智能终端 (Edge Devices)"]
|
||||
D1["物流仓储 PDA<br/>(Android DPC)"]
|
||||
D2["车载终端 / 智能平板"]
|
||||
D3["行业移动 POS 机"]
|
||||
end
|
||||
|
||||
subgraph Gateway ["接入与通信网关 (Cloud Gateway)"]
|
||||
WAF["Spring Security / HSTS 防火墙<br/>(SecurityConfig)"]
|
||||
WS["WebSocket 长连接网关<br/>(QueryHandler)"]
|
||||
AUTH["RSA-OAEP 非对称硬件验签<br/>(DeviceKeyService)"]
|
||||
end
|
||||
|
||||
subgraph CoreService ["业务与控制中枢 (Core Services)"]
|
||||
DM["设备全生命周期服务<br/>(DeviceService)"]
|
||||
BMS["电池健康度遥测服务<br/>(BatteryService)"]
|
||||
OTA["固件升级分发系统<br/>(StoreOtaService)"]
|
||||
AUDIT["操作与安全审计中心<br/>(LogService)"]
|
||||
SESSION["在线会话与防刷管理器<br/>(WebSocketSessionManager)"]
|
||||
end
|
||||
|
||||
subgraph Storage ["混合存储与分发基础设施 (Storage Layer)"]
|
||||
MONGO[("MongoDB 副本集<br/>(复合时序索引 + 管道聚合)")]
|
||||
MULTICLOUD["多云对象存储抽象 (CloudStorageService)<br/>AWS S3 / Azure Blob / Google Cloud"]
|
||||
end
|
||||
|
||||
D1 <--> |WebSocket 二进制压缩报文 / 心跳| WS
|
||||
D2 <--> |WebRTC 远程屏幕推流| WS
|
||||
D3 <--> |RESTful API / Base64 Token| WAF
|
||||
|
||||
WAF --> AUTH
|
||||
WS --> SESSION
|
||||
SESSION --> DM
|
||||
SESSION --> BMS
|
||||
SESSION --> AUDIT
|
||||
|
||||
DM --> MONGO
|
||||
BMS --> MONGO
|
||||
AUDIT --> MONGO
|
||||
|
||||
OTA --> MULTICLOUD
|
||||
MULTICLOUD -.-> |Presigned URL 客户端直连下载| D1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🌟 核心特性与技术亮点
|
||||
|
||||
### 1. 百万级长连接高并发网关与弱网优化
|
||||
- **双向全双工通道**:基于 Spring WebSocket 维护设备与管理端的双向实时控制,实现秒级指令下发(远程锁屏、数据擦除、静默排障)。
|
||||
- **二进制传输压缩**:受控端对高频上报的已装应用、运行状态通过 Deflate 压缩封装为 `BinaryMessage`,服务端基于 `McDecompress` 内存解压,**节约 70% 蜂窝网络流量**。
|
||||
- **自适应重连防刷**:内置 `ReconnectMonitor` 滑动窗口算法,防止弱网基站切换时的海量设备重连风暴打垮服务器连接池。
|
||||
|
||||
### 2. 多云融合对象存储抽象与大文件免中转分发
|
||||
- **策略模式抽象**:通过 `CloudStorage` 统一抽象 AWS S3、Azure Blob、Google Cloud Storage,支持根据跨国部署区域动态热切换存储策略。
|
||||
- **Presigned URL 客户端直连**:针对 1~2GB 的 OTA 固件镜像,服务端仅下发带有效期的安全预签名下载链接,终端直连云厂商 CDN,彻底解放应用服务器的网络带宽与磁盘 IO。
|
||||
- **磁盘自动保护机制**:固件上传成功后自动异步清理服务器本地缓存,杜绝服务器磁盘写满隐患。
|
||||
|
||||
### 3. 海量设备时序遥测与 NoSQL 聚合优化
|
||||
- **GPS 历史轨迹回溯**:采用 MongoDB 复合索引 `{'deviceUuid': 1, 'properties.location.time': -1}` 实现地理轨迹与时间戳的毫秒级时序范围检索。
|
||||
- **智能电池健康管理 (BMS)**:持续采集电池充放电循环次数、实时温度、电压及老化指标(SOH),运用 **MongoDB Aggregation Pipeline (`$lookup` -> `$unwind` -> `$replaceRoot`)** 进行内存级时序日志多表联查。
|
||||
- **自动告警闭环**:当电池健康状态劣化至 `SERVICE_SOON` 阈值时,自动触发异步邮件告警通知企业运维主管。
|
||||
|
||||
### 4. 工业级移动安全闭环
|
||||
- **谷歌 Android Enterprise (EMM)**:集成 `DpcController`,生成标准零接触配置(Zero-Touch Enrollment)二维码,支持新机开机连续点击 6 次静默完成 Device Owner 提权纳管。
|
||||
- **RSA-OAEP 硬件身份验签**:终端在首次入网时固化 RSA 非对称公钥,后续请求基于 `RSA/ECB/OAEPWithSHA-1AndMGF1Padding` 私钥解密校验序列号,杜绝伪造出厂硬件信息接入。
|
||||
- **阅后即焚一次性动态令牌 (OTT)**:远程协助接口基于 Base64 编码的 Device Token 鉴权,验证通过瞬间即从数据库中**物理删除**,彻底杜绝重放攻击。
|
||||
- **幂等性审计日志**:基于 MongoDB `$setOnInsert` + 复合唯一约束,确保弱网重发时审计日志的绝对幂等写入。
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 技术栈总览
|
||||
|
||||
| 模块 | 技术选型 | 说明 |
|
||||
| :--- | :--- | :--- |
|
||||
| **基础开发框架** | Spring Boot 2.7.15 / Java 11 | 企业主流生产级稳定架构 |
|
||||
| **长连接通信** | Spring WebSocket + 自研二进制通信协议 | 低延迟全双工指令通道 |
|
||||
| **数据库** | MongoDB 4.x+ (Spring Data MongoDB) | 文档型存储 + 聚合管道分析 |
|
||||
| **多云存储集成** | AWS SDK (S3) / Azure Storage Blob / GCP Storage | 策略模式统一抽象 |
|
||||
| **安全体系** | Spring Security 5.7+ / RSA-OAEP / BCrypt | 硬件级端到端鉴权 |
|
||||
| **视图模板 / 报表** | Thymeleaf / Flying Saucer PDF / Apache POI | 报表生成与系统通知 |
|
||||
| **条码与签名** | ZXing (QR Code) / ApkSignerTool | 零接触二维码与 APK 安全签名 |
|
||||
|
||||
---
|
||||
|
||||
## 📂 项目工程结构
|
||||
|
||||
```text
|
||||
iot_m/
|
||||
├── pom.xml # Maven 依赖与构建配置 (Spring Boot 2.7.15)
|
||||
├── README.md # 项目介绍与架构说明
|
||||
├── PROJECT_ARCHITECTURE_AND_GUIDE.md # 深入架构解析与面试实战问答指南
|
||||
├── src/
|
||||
│ └── main/
|
||||
│ ├── java/
|
||||
│ │ ├── com/midm/ # MiDM 核心业务代码
|
||||
│ │ │ ├── app/ # 基础设施配置 (DbConfig, SecurityConfig, WebSocketConfig)
|
||||
│ │ │ ├── controller/ # 路由控制器 (DeviceController, UserController等)
|
||||
│ │ │ ├── dpc/ # Android Enterprise 零接触配置 (DpcController)
|
||||
│ │ │ ├── model/ # 领域实体模型 (Device, Battery, OtaFile, Site等)
|
||||
│ │ │ ├── service/ # 核心业务服务
|
||||
│ │ │ │ ├── battery/ # 电池健康度遥测与 BMS 服务
|
||||
│ │ │ │ ├── cloudStorage/ # 多云对象存储策略模式实现 (AWS/Azure/GCP)
|
||||
│ │ │ │ ├── device/ # 设备全生命周期、秘钥与应用管理
|
||||
│ │ │ │ ├── log/ # 幂等审计日志中心
|
||||
│ │ │ │ └── message/ # 长连接 Session 管理与防刷频控
|
||||
│ │ │ └── websocket/ # 核心 WebSocket 消息分发网关 (QueryHandler)
|
||||
│ │ ├── com/mitac/cell/ # 底层自研核心通用库 (通信、加密、文档处理)
|
||||
│ │ └── org/springframework/boot/ # Spring Boot 启动加载器扩展
|
||||
│ └── resources/ # 配置文件、静态资源与页面模板
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 本地快速启动
|
||||
|
||||
### 1. 环境准备
|
||||
- **JDK**:OpenJDK 11 或更高
|
||||
- **构建工具**:Apache Maven 3.6+
|
||||
- **数据库**:MongoDB 4.x+(本地启动或使用 Docker 容器)
|
||||
|
||||
### 2. 启动 MongoDB
|
||||
```bash
|
||||
docker run -d --name midm-mongo -p 27017:27017 -e MONGO_INITDB_DATABASE=db_midm mongo:5.0
|
||||
```
|
||||
|
||||
### 3. 配置与启动
|
||||
检查 `src/main/resources/application.properties`,确认 MongoDB 连接配置后执行:
|
||||
```bash
|
||||
mvn clean package -DskipTests
|
||||
java -jar target/midm-1.1.1.12.war
|
||||
```
|
||||
|
||||
系统启动后默认监听 `8080` 端口:
|
||||
- WebSocket 网关端点:`ws://localhost:8080/query`
|
||||
- 零接触 DPC 二维码端点:`http://localhost:8080/dpc/qr`
|
||||
Reference in new issue
Block a user