Files
mdm/README.md
T

153 lines
8.5 KiB
Markdown
Raw 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.
# IoT-M (CloudPulse-MDM) - 工业级智能终端与物联网设备云管控平台
[![Java](https://img.shields.io/badge/Java-11-orange.svg)](https://www.oracle.com/java/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-2.7.15-brightgreen.svg)](https://spring.io/projects/spring-boot)
[![MongoDB](https://img.shields.io/badge/MongoDB-4.x%2B-green.svg)](https://www.mongodb.com/)
[![WebSocket](https://img.shields.io/badge/WebSocket-Full--Duplex-blue.svg)](https://spring.io/)
[![Cloud Storage](https://img.shields.io/badge/Storage-AWS%20S3%20%7C%20Azure%20%7C%20GCP-blueviolet.svg)](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`