Files
rick 10aa1829f5 fix: repair decompiled sources and add exhaustive documentation
- restore generic signatures, scoped variables and missing code from original bytecode
- remove decompiler artifacts and document classes, methods, fields and packages
- restore resources, add Batik/BouncyCastle dependencies and build/runtime docs
2026-11-16 17:28:23 +08:00

10 KiB
Raw Permalink Blame History

IoT-M (CloudPulse-MDM) - 工业级智能终端与物联网设备云管控平台

Java Spring Boot MongoDB WebSocket Cloud Storage

IoT-M 是一套专为工业级手持终端(PDA)、车载智能平板、移动医疗设备及行业专用 POS 机设计的企业级全生命周期物联网管控云平台 (Mobile Device Management / IoT Fleet Management Platform)。 系统具备低延时全双工长连接通道、多云融合对象存储、OTA 固件空中差分升级、电池健康度时序遥测 (BMS) 及端到端硬件级安全防御能力。


🏗️ 系统架构图 (端-边-云协同)

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 安全签名

📂 项目工程结构

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(本机已验证):

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:

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 并导致启动失败。本机已创建:

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. 构建与启动

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