# 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
(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)。