# 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
(Android DPC)"]
D2["车载终端 / 智能平板"]
D3["行业移动 POS 机"]
end
subgraph Gateway ["接入与通信网关 (Cloud Gateway)"]
WAF["Spring Security / HSTS 防火墙
(SecurityConfig)"]
WS["WebSocket 长连接网关
(QueryHandler)"]
AUTH["RSA-OAEP 非对称硬件验签
(DeviceKeyService)"]
end
subgraph CoreService ["业务与控制中枢 (Core Services)"]
DM["设备全生命周期服务
(DeviceService)"]
BMS["电池健康度遥测服务
(BatteryService)"]
OTA["固件升级分发系统
(StoreOtaService)"]
AUDIT["操作与安全审计中心
(LogService)"]
SESSION["在线会话与防刷管理器
(WebSocketSessionManager)"]
end
subgraph Storage ["混合存储与分发基础设施 (Storage Layer)"]
MONGO[("MongoDB 副本集
(复合时序索引 + 管道聚合)")]
MULTICLOUD["多云对象存储抽象 (CloudStorageService)
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. 环境准备(Windows,本机已配置)
| 组件 | 版本 | 本机路径 |
| :--- | :--- | :--- |
| JDK | Amazon Corretto 18.0.2 | `C:\Users\rick.liu\.jdks\corretto-18.0.2` |
| Maven | Apache Maven 3.9.9 | `D:\Software\apache-maven-3.9.9` |
| MongoDB | Community 7.0.14(便携版) | `D:\Software\mongodb-7.0.14` |
已写入用户环境变量:
- `JAVA_HOME` → Corretto 18
- `MAVEN_HOME` / `M2_HOME` → Maven 3.9.9
- `PATH` 追加 `%MAVEN_HOME%\bin`
> 新开一个 PowerShell 窗口后可直接使用 `mvn`;当前会话也可用完整路径
> `D:\Software\apache-maven-3.9.9\bin\mvn.cmd`。
### 2. 启动 MongoDB
PowerShell(本机已验证):
```powershell
New-Item -ItemType Directory -Force D:\Develop\MiDM\.mongo-data | Out-Null
& 'D:\Software\mongodb-7.0.14\bin\mongod.exe' `
--dbpath 'D:\Develop\MiDM\.mongo-data' `
--port 27017 `
--bind_ip 127.0.0.1 `
--logpath 'D:\Develop\MiDM\.mongo-data\mongod.log' `
--logappend
```
也可以继续使用 Docker:
```bash
docker run -d --name midm-mongo -p 27017:27017 -e MONGO_INITDB_DATABASE=db_midm mongo:5.0
```
### 3. 运行时配置
MiDM 启动时会加载 `C:\ProgramData\MiDM\midm.properties`。该文件或目录不存在时,
`PropertiesConfig` 会抛 `FileNotFoundException` 并导致启动失败。本机已创建:
```properties
mongo.uri=
mongo.host=127.0.0.1
mongo.port=27017
mongo.dbname=db_midm
mongo.replica_set=
```
> 单机 MongoDB 必须保持 `mongo.replica_set=` 为空;如果使用副本集,改为 `rs0` 并先执行
> `rs.initiate()`,否则连接串中的 `replicaSet=rs0` 会导致连接失败。
### 4. 构建与启动
```powershell
mvn clean package -DskipTests
java -jar target\midm-1.1.1.12.war
```
系统启动后默认监听 `8080` 端口:
- 登录页:`http://localhost:8080/`
- WebSocket 网关端点:`ws://localhost:8080/query`
- 零接触 DPC 二维码端点:`http://localhost:8080/dpc/qr`
本次已实际启动验证:`Started MainApplication`,登录页返回 200,
`/dpc/qr` 返回 `image/png`。MongoDB 日志与运行日志位于
`D:\Develop\MiDM\.mongo-data\mongod.log`、`D:\Develop\MiDM\.run\app.log`(均已 gitignore)。