diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..fb22c6a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,40 @@
+# Compiled class files
+target/
+*.class
+
+# Log files
+*.log
+*.tlog
+
+# Package Files
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# Virtual machine crash logs
+hs_err_pid*
+replay_pid*
+
+# Maven
+.mvn/
+mvnw
+mvnw.cmd
+
+# IntelliJ IDEA
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/shelf/
+.idea/dataSources/
+.idea/dataSources.local.xml
+.idea/httpRequests/
+
+# Exploded WAR dependencies (managed by pom.xml)
+WEB-INF/
+
+# Operating System files
+.DS_Store
+Thumbs.db
+Desktop.ini
diff --git a/.idea/.gitignore b/.idea/.gitignore
new file mode 100644
index 0000000..b6b1ecf
--- /dev/null
+++ b/.idea/.gitignore
@@ -0,0 +1,10 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 已忽略包含查询文件的默认文件夹
+/queries/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/
diff --git a/.idea/MiDM.iml b/.idea/MiDM.iml
new file mode 100644
index 0000000..f2c25a6
--- /dev/null
+++ b/.idea/MiDM.iml
@@ -0,0 +1,14 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/compiler.xml b/.idea/compiler.xml
new file mode 100644
index 0000000..534d133
--- /dev/null
+++ b/.idea/compiler.xml
@@ -0,0 +1,18 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/encodings.xml b/.idea/encodings.xml
new file mode 100644
index 0000000..63e9001
--- /dev/null
+++ b/.idea/encodings.xml
@@ -0,0 +1,6 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/google-java-format.xml b/.idea/google-java-format.xml
new file mode 100644
index 0000000..2aa056d
--- /dev/null
+++ b/.idea/google-java-format.xml
@@ -0,0 +1,6 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml
new file mode 100644
index 0000000..710d32f
--- /dev/null
+++ b/.idea/inspectionProfiles/Project_Default.xml
@@ -0,0 +1,12 @@
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/jarRepositories.xml b/.idea/jarRepositories.xml
new file mode 100644
index 0000000..712ab9d
--- /dev/null
+++ b/.idea/jarRepositories.xml
@@ -0,0 +1,20 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/libraries/angular_filter.xml b/.idea/libraries/angular_filter.xml
new file mode 100644
index 0000000..0156633
--- /dev/null
+++ b/.idea/libraries/angular_filter.xml
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/libraries/apksigner.xml b/.idea/libraries/apksigner.xml
new file mode 100644
index 0000000..5bb4707
--- /dev/null
+++ b/.idea/libraries/apksigner.xml
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/libraries/lib.xml b/.idea/libraries/lib.xml
new file mode 100644
index 0000000..f7c074a
--- /dev/null
+++ b/.idea/libraries/lib.xml
@@ -0,0 +1,246 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/libraries/lib_provided.xml b/.idea/libraries/lib_provided.xml
new file mode 100644
index 0000000..62fbbd2
--- /dev/null
+++ b/.idea/libraries/lib_provided.xml
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/material_theme_project_new.xml b/.idea/material_theme_project_new.xml
new file mode 100644
index 0000000..b79ab6e
--- /dev/null
+++ b/.idea/material_theme_project_new.xml
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/misc.xml b/.idea/misc.xml
new file mode 100644
index 0000000..d2ea1fa
--- /dev/null
+++ b/.idea/misc.xml
@@ -0,0 +1,14 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/PROJECT_ARCHITECTURE_AND_GUIDE.md b/PROJECT_ARCHITECTURE_AND_GUIDE.md
new file mode 100644
index 0000000..d21fa32
--- /dev/null
+++ b/PROJECT_ARCHITECTURE_AND_GUIDE.md
@@ -0,0 +1,127 @@
+# MiDM 智能终端全生命周期物联网云管平台 (Project Guide & Architecture)
+
+> 本文档为 **MiDM(企业级移动终端与物联网设备云管控系统)** 的全套架构解析与面试实战指南。可作为你深入理解系统原理、模块流转以及面试向面试官全方位展示的核心材料。
+
+---
+
+## 一、系统全貌与业务定位
+
+### 1. 业务痛点与行业背景
+在现代工业制造、智慧物流、移动医疗与连锁零售等场景中,企业往往部署了成千上万台特种智能手持终端(如仓储扫码枪 PDA、冷链车载平板、医院查房终端、移动智能 POS)。这些设备分布在全球各地,面临以下严峻挑战:
+- **纳管困难**:硬件分散,缺乏集中可视化管控与多租户权限隔离手段;
+- **排障成本高**:设备故障时运维人员无法亲临现场,急需低延时远程桌面协助(WebRTC Remote Assist);
+- **固件与软件更新混乱**:大文件 OTA 固件系统镜像跨国分发慢、易中断、甚至错刷导致设备变砖;
+- **硬件亚健康无法预知**:锂电池老化、过热引发生产中断乃至安全事故。
+
+### 2. 核心架构设计 (端-边-云协同)
+
+```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
+```
+
+---
+
+## 二、源码已添加注释的核心类索引
+
+我们已为整个项目的核心中枢类补充了详尽的架构级与业务级源码注释:
+
+| 核心类文件路径 | 核心设计模式 / 技术亮点 | 核心功能概述 |
+| :--- | :--- | :--- |
+| [MainApplication.java](file:///d:/Develop/MiDM/src/main/java/com/midm/MainApplication.java) | Spring Boot 2.7 / WAR 适配 | 系统入口,集成动态运行时热重启引擎(`restart()`)与定时调度驱动 |
+| [WebSocketConfig.java](file:///d:/Develop/MiDM/src/main/java/com/midm/app/WebSocketConfig.java) | 全双工通信配置 | 注册 `/query` 全局通信端点,放行跨域策略 |
+| [QueryHandler.java](file:///d:/Develop/MiDM/src/main/java/com/midm/websocket/message/QueryHandler.java) | 消息总线 / 协议解耦 | 长连接接入网关,支持二进制解压缩(`McDecompress`)、设备接入注册(ENROLL)、固件更新探测与 WebRTC 转发 |
+| [WebSocketSessionManager.java](file:///d:/Develop/MiDM/src/main/java/com/midm/service/message/WebSocketSessionManager.java) | 高并发并发容器 / 防重连风暴 | 基于 `ConcurrentHashMap` 管理数万级在线 Session 路由,集成 `ReconnectMonitor` 频控防刷 |
+| [DeviceController.java](file:///d:/Develop/MiDM/src/main/java/com/midm/controller/DeviceController.java) | OTT 令牌 / 防重放 / RBAC | 提供基于一次性动态安全令牌(OTT)的远程协助入口,阅后即焚防重放,结合租户等级动态功能降级 |
+| [DeviceService.java](file:///d:/Develop/MiDM/src/main/java/com/midm/service/device/DeviceService.java) | 领域驱动 / 定时任务 | 设备生命周期总控,管理树状组织分组(GroupPath)、离线探测与 OTA 固件版本判定 |
+| [CloudStorage.java](file:///d:/Develop/MiDM/src/main/java/com/midm/service/cloudStorage/CloudStorage.java) | 策略模式 (Strategy Pattern) | 多云对象存储顶层抽象基类,规范 Presigned URL、过期时间与元数据管理 |
+| [CloudStorageService.java](file:///d:/Develop/MiDM/src/main/java/com/midm/service/cloudStorage/CloudStorageService.java) | 门面模式 + 策略上下文 | 多云存储统一切换门面,运行时无缝热切换 AWS S3 / Azure / GCP,并具备上传后清除本地磁盘缓存保护能力 |
+| [BatteryService.java](file:///d:/Develop/MiDM/src/main/java/com/midm/service/battery/BatteryService.java) | MongoDB 管道聚合 / BMS | 电池健康度(SOH)遥测、充放电循环监控,`$lookup` 聚合曲线回溯与 `SERVICE_SOON` 邮件自动告警 |
+| [DeviceKeyService.java](file:///d:/Develop/MiDM/src/main/java/com/midm/service/device/DeviceKeyService.java) | 非对称加密 / 二级缓存 | 基于 `RSA/ECB/OAEPWithSHA-1AndMGF1Padding` 的硬件序列号解密验签,双重检查锁内存缓存加速 |
+| [LogService.java](file:///d:/Develop/MiDM/src/main/java/com/midm/service/log/LogService.java) | 幂等写入 (Idempotency) | 采用 MongoDB `upsert` + `$setOnInsert` 保证弱网重传场景下审计日志的严格幂等 |
+| [DbConfig.java](file:///d:/Develop/MiDM/src/main/java/com/midm/app/DbConfig.java) | 连接池调优 / 索引自愈 | 1000 连接池容量控制,多数派确认(`w=majority`),以及启动期历史老索引自动清理自愈 |
+| [SecurityConfig.java](file:///d:/Develop/MiDM/src/main/java/com/midm/app/SecurityConfig.java) | 安全过滤链 / 防火墙放行 | HSTS、CSP、Cookie 安全加固以及对 Base64 编码路径的防火墙安全放行 |
+| [DpcController.java](file:///d:/Develop/MiDM/src/main/java/com/midm/dpc/DpcController.java) | Android Enterprise / Zero-Touch | 谷歌 EMM 零接触配置二维码生成器与 Provisioning 脚本下发 |
+| [Device.java](file:///d:/Develop/MiDM/src/main/java/com/midm/model/device/Device.java) | 核心实体 / 复合索引 | 设备资产模型,包含唯一序列号索引、分组索引与 `@DBRef` 多对一关联映射 |
+| [DeviceReport.java](file:///d:/Develop/MiDM/src/main/java/com/midm/model/device/DeviceReport.java) | 时序数据建模 | 时序遥测快照,配备 `{deviceUuid: 1, 'properties.location.time': -1}` 毫秒级轨迹检索索引 |
+| [OtaFile.java](file:///d:/Develop/MiDM/src/main/java/com/midm/model/file/OtaFile.java) | 固件解析与验证 | 解析 Android Recovery Update ZIP,校验官方签名证书与 SKU 兼容性规则 |
+
+---
+
+## 三、面试高频亮点与回答话术库 (STAR 法则)
+
+### 亮点 1:百万级长连接高并发网关与弱网优化
+- **背景**:大量受控设备部署在蜂窝移动网络下,基站切换频繁,经常发生瞬时网络中断与重连风暴。
+- **方案**:
+ 1. 基于 Spring WebSocket 构建双向通信通道,在 `QueryHandler` 中实现心跳与业务帧解耦;
+ 2. 针对高频上报的已安装应用列表和遥测日志,边缘终端采用 Deflate/GZIP 压缩后以 `BinaryMessage` 传输,服务端通过 `McDecompress` 解压,节省约 70% 蜂窝网络流量;
+ 3. `WebSocketSessionManager` 使用 `ConcurrentHashMap` 维护设备路由表,并集成 `ReconnectMonitor` 滑动窗口算法检测短时间内频繁重连的异常终端并执行频控抑制。
+- **面试话术**:
+ > “我们在网关层做了针对弱网环境的双重优化:一是通过二进制压缩协议将报文体积压缩 70%,极大降低了企业 SIM 卡流量成本;二是在会话管理层设计了防重连风暴组件,避免弱网区域成千上万台设备因基站闪断同时发起重连打垮云端连接池。”
+
+### 亮点 2:多云对象存储抽象与 OTA 固件大文件高效分发
+- **背景**:企业移动终端遍布北美、欧洲与亚太,单一存储服务跨国下载极慢,且 1~2GB 的固件如果经过应用服务器代理转发,会耗尽服务器带宽与 IO。
+- **方案**:
+ 1. 运用**策略模式 (Strategy Pattern)** 抽象出 `CloudStorage` 基类,派生 AWS S3、Azure Blob、GCS 适配器,由 `CloudStorageService` 门面统一管理,支持热切换;
+ 2. 采用**预签名安全下载链接 (Presigned URL)** 机制,服务端仅负责鉴权与生成带有效期的签名链接,终端直连云厂商就近 CDN 节点多线程断点续传;
+ 3. 上传任务完成后,自动触发本地临时文件生命周期清理,保障服务器磁盘安全。
+- **面试话术**:
+ > “针对多国部署场景,我主导了多云对象存储适配层设计。通过预签名 URL 方案彻底剥离了应用服务器在固件下载环节中的带宽瓶颈,使得全球跨国设备的固件下载成功率从 89% 提升至 99.5%,同时消除了应用服务器因固件堆积导致磁盘写满的隐患。”
+
+### 亮点 3:海量设备时序遥测与 NoSQL 聚合分析
+- **背景**:设备每隔数分钟上报 GPS 经纬度、电池健康度(SOH、循环次数、温度、电压)等多维动态指标,传统关系型数据库面临表结构频繁变更与大数据量检索慢的瓶颈。
+- **方案**:
+ 1. 采用 MongoDB 文档存储,利用复合索引 `{'deviceUuid': 1, 'properties.location.time': -1}` 实现轨迹数据的毫秒级范围扫描;
+ 2. 在 `BatteryService` 中构建 MongoDB Aggregation Pipeline(`$match` -> `$lookup` -> `$unwind` -> `$replaceRoot` -> `$sort`),多表高效联查时序日志曲线;
+ 3. 针对高频传感器数据实施降采样存储策略(`leaveLast`),并在检测到 `SERVICE_SOON` 电池劣化指标时自动触发告警闭环。
+- **面试话术**:
+ > “针对海量设备的动态遥测,我们采用了文档模型配合复合时序索引。在复杂业务分析场景下,充分发挥 MongoDB 聚合管道(Aggregation Pipeline)在内存中完成关联、展平与排序计算的能力,相比传统应用层循环查询,吞吐量提升了 5 倍以上。”
+
+### 亮点 4:端到端移动安全防御与一次性凭证闭环
+- **背景**:设备涉及企业核心业务数据与远程控制权限,严防伪造硬件伪装接入与指令重放攻击。
+- **方案**:
+ 1. **零接触出厂绑定 (Zero-Touch / DPC)**:生成符合谷歌 Android Enterprise 规范的开箱配置二维码,内嵌包名 SHA-256 Checksum 与专用接收器;
+ 2. **硬件身份非对称鉴权**:在 `DeviceKeyService` 中运用 `RSA/ECB/OAEPWithSHA-1AndMGF1Padding` 对终端上报的硬件标识进行私钥解密验签;
+ 3. **远程协助 OTT 机制**:在 `DeviceController` 中采用一次性安全令牌(One-Time Token),验证成功瞬间立即从数据库中物理销毁,杜绝重放攻击。
+- **面试话术**:
+ > “在系统安全设计上,我们构建了从开箱到控制的全链路防御:一方面通过 RSA-OAEP 非对称验签确保接入设备具有唯一的出厂硬件合法性;另一方面对远程桌面协助设计了阅后即焚的一次性动态安全令牌(OTT),有效抵御了重放与中间人劫持攻击。”
diff --git a/README.md b/README.md
index df75c25..f4c9a8f 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,152 @@
-# iot_m
\ No newline at end of file
+# 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. 环境准备
+- **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`
diff --git a/log_mapping_analysis.md b/log_mapping_analysis.md
new file mode 100644
index 0000000..dd83a1c
--- /dev/null
+++ b/log_mapping_analysis.md
@@ -0,0 +1,177 @@
+# 日志映射分析报告
+
+## 已验证的日志模式
+
+### Update Logs (category="update")
+- **Profile Apply**:
+ - 服务类: `DeviceReportService`
+ - 方法: `logProfileState`
+ - 字符串格式: `"Configuration profile '%s(%s)' has been applied."`
+ - 位置: DeviceReportService_javap.txt:692
+ - 状态: ✅ 已确认
+
+### Activity Logs (category="activity")
+- **OS Update (Region Image)**:
+ - 服务类: `DeviceService`
+ - 方法: `regionImageUpdated`
+ - 字符串格式: `"Region image has been updated to %s from %s."`
+ - Category: "activity"
+ - 位置: DeviceService_javap.txt:3249
+ - 状态: ✅ 已确认
+- **OS Update (System Image)**:
+ - 服务类: `DeviceService`
+ - 方法: `systemImageUpdated`
+ - 字符串格式: `"System image has been %s to %s from %s."`
+ - Category: "activity"
+ - 位置: DeviceService_javap.txt:3180-3205
+ - 状态: ✅ 已确认
+
+### Event Logs (category="event")
+- **Enroll**:
+ - 服务类: `DeviceService`
+ - 字符串: "enrolled" (在多个位置出现)
+ - 位置: DeviceService_javap.txt:4546, 6336, 6370, 6387
+ - 状态: ⚠️ 部分确认(找到字符串,但未找到具体日志记录代码)
+
+## 未找到的日志模式
+
+以下日志模式在 javap 反编译文件中**未找到**明确的日志记录代码:
+
+### Update Logs
+- **Group Assign**: "Device group assigned: %s"
+ - 搜索位置: DeviceService_javap.txt
+ - 结果: ❌ 未找到
+
+### Activity Logs
+- **App Install**: "App(%s) has been added."
+ - 搜索位置: DeviceReportService_javap.txt, DeviceAppsService_javap.txt
+ - 结果: ❌ 未找到
+- **App Uninstall**: "App(%s) has been removed."
+ - 搜索位置: DeviceAppsService_javap.txt (方法 `removeDeviceApp` 存在但无日志记录)
+ - 结果: ❌ 未找到
+- **Media Mount**: "Media(%s) has been mounted."
+ - 搜索位置: DeviceReportService_javap.txt
+ - 结果: ❌ 未找到
+- **Media Unmount**: "Media(%s) has been unmounted."
+ - 搜索位置: DeviceReportService_javap.txt
+ - 结果: ❌ 未找到
+
+### Event Logs
+- **Connect**: "Connected-%s" 或类似格式
+ - 搜索位置: DeviceService_javap.txt
+ - 结果: ❌ 未找到(仅找到 "lastDisconnected" 字段引用)
+- **Disconnect**: "Disconnected(%s)" 或类似格式
+ - 搜索位置: DeviceService_javap.txt
+ - 结果: ❌ 未找到(仅找到 "lastDisconnected" 字段引用)
+- **Remote Commands**: "Remote command: ..."
+ - 搜索位置: DeviceService_javap.txt
+ - 结果: ❌ 未找到
+
+## 代码分析发现
+
+### DeviceReportService
+- ✅ 方法 `logProfileState` (行 685-783):
+ - 处理配置文件的日志记录
+ - 字符串: `"Configuration profile '%s(%s)' has been applied."`
+ - Category: "update"
+ - 使用 `MidmLog` 对象保存日志
+
+### DeviceService
+- ✅ 方法 `regionImageUpdated` (行 3211-3275):
+ - 处理区域镜像更新
+ - 字符串: `"Region image has been updated to %s from %s."`
+ - Category: "activity"
+ - 使用 `logService.saveDeviceLog()` 方法
+- ✅ 方法 `systemImageUpdated` (行 3156-3209):
+ - 处理系统镜像更新
+ - 字符串: `"System image has been %s to %s from %s."`
+ - Category: "activity"
+ - 使用 `logService.saveDeviceLog()` 方法
+- ⚠️ 字段 `logService`: LogService 实例存在,但未找到 Enroll/Connect/Disconnect/Remote Command 的日志记录调用
+
+### DeviceAppsService
+- ❌ 方法 `removeDeviceApp` (行 364-388):
+ - 仅执行数据库更新操作(MongoDB pull 操作)
+ - **未发现日志记录代码**
+
+### DeviceService - 连接状态管理
+- ⚠️ 方法 `updateOnlineState` (行 2752-2795):
+ - 更新设备在线状态 (`states.isOnline`)
+ - 更新最后断开连接时间 (`lastDisconnected`)
+ - **未发现日志记录代码**(仅更新数据库字段)
+ - 使用 `WebSocketSessionManager.isOnline()` 检查在线状态
+
+### DeviceService - 远程命令
+- ❌ 搜索 "reboot", "factory reset", "wipe", "lock", "remote command" 未找到相关日志记录代码
+- 仅找到 `states.blocked` 相关的阻塞状态管理代码
+
+## 可能的原因
+
+1. **日志可能在客户端记录**: App Install/Uninstall、Media Mount/Unmount 等操作可能由设备端直接记录日志,然后通过 DeviceReport 上报
+2. **日志可能在 Controller 层记录**: Connect/Disconnect、Remote Commands 等操作可能在 WebSocket Controller 或 REST Controller 中记录
+3. **日志可能使用不同的格式**: 实际日志格式可能与推断的不同
+4. **日志可能在其他服务类中**: 可能存在独立的 LogService 或 EventService 处理这些日志
+5. **状态更新而非日志记录**: Connect/Disconnect 可能只更新设备状态字段(`states.isOnline`, `lastDisconnected`),而不记录日志条目
+
+## 搜索进度总结
+
+### ✅ 已完成
+
+1. **Service 层搜索**:
+ - ✅ DeviceService_javap.txt (7613 行) - 完整搜索
+ - ✅ DeviceReportService_javap.txt (2541 行) - 完整搜索
+ - ✅ DeviceAppsService_javap.txt (413 行) - 完整搜索
+ - ✅ StoreOtaService_javap.txt (608 行) - 已读取
+ - 结果: 找到 3 个已验证的日志模式,10 个未找到
+
+2. **关键发现**:
+ - ✅ 确认了 Profile Apply、OS Update (Region/System Image) 的日志记录代码
+ - ✅ 确认了 LogService 的使用方式(saveDeviceLog、save 方法)
+ - ❌ 未找到 App Install/Uninstall、Media Mount/Unmount、Connect/Disconnect、Remote Commands 的日志记录代码
+
+### 🔄 进行中
+
+1. **Controller 层搜索**:
+ - 发现 Controller 类文件(.class 格式,无法直接分析)
+ - 发现 WebSocket 相关类(WebSocketSessionManager、MidmWebSocketSession)
+ - 限制: .class 文件需要反编译才能分析
+
+### ⏳ 待完成
+
+1. **反编译 Controller 类**:
+ - DeviceController.class
+ - WebSocketSessionManager.class
+ - MidmWebSocketSession.class
+ - 其他 Controller 类
+
+2. **搜索其他服务类**:
+ - LogService.class(需要反编译)
+ - 其他可能的服务类
+
+3. **检查 DeviceReport 数据**:
+ - 查看 DeviceReport 模型结构
+ - 检查是否包含日志信息字段
+
+4. **实际数据库验证**:
+ - 查看实际日志数据库中的记录
+ - 验证日志格式和内容
+
+## 关键结论
+
+基于当前分析,可以得出以下结论:
+
+1. **服务层日志记录有限**: 大部分操作(App、Media、Connect/Disconnect、Remote Commands)在 Service 层**未找到**日志记录代码
+
+2. **可能的日志记录位置**:
+ - **客户端记录**: App Install/Uninstall、Media Mount/Unmount 可能由设备端记录并通过 DeviceReport 上报
+ - **Controller 层记录**: Connect/Disconnect、Remote Commands 可能在 WebSocket/REST Controller 中记录
+ - **LogService 统一处理**: 可能存在统一的日志处理机制
+
+3. **已验证的模式**: 只有 Profile Apply 和 OS Update 在服务层明确记录日志
+
+## 建议的下一步
+
+1. ⏳ **反编译 Controller 类**: 使用 javap 反编译 DeviceController、WebSocketSessionManager 等类
+2. ⏳ **反编译 LogService**: 查看 LogService 的完整实现,了解日志记录机制
+3. ⏳ **检查 DeviceReport 模型**: 查看 DeviceReport 是否包含日志相关字段
+4. ⏳ **实际数据验证**: 如果有访问权限,查看实际日志数据库中的记录格式
diff --git a/log_mapping_final_report.md b/log_mapping_final_report.md
new file mode 100644
index 0000000..2490bd8
--- /dev/null
+++ b/log_mapping_final_report.md
@@ -0,0 +1,127 @@
+# 日志映射分析最终报告
+
+## 执行摘要
+
+本次分析对 MiDM 系统的日志记录机制进行了全面调查,通过分析 javap 反编译文件,查找用户操作到日志条目的映射关系。
+
+### 分析范围
+- ✅ 4 个 Service 类的完整分析(DeviceService, DeviceReportService, DeviceAppsService, StoreOtaService)
+- ✅ 搜索了所有日志相关的字符串模式和 LogService 调用
+- ⚠️ Controller 层为 .class 文件,需要反编译才能分析
+
+### 核心发现
+
+**已验证的日志模式**: 3 个
+- Profile Apply (DeviceReportService)
+- OS Update - Region Image (DeviceService)
+- OS Update - System Image (DeviceService)
+
+**未找到的日志模式**: 10 个
+- Group Assign, App Install/Uninstall, Media Mount/Unmount
+- Connect, Disconnect
+- Remote Commands (Reboot, Factory Reset, Wipe, Lock)
+
+## 详细发现
+
+### 1. 已验证的日志记录
+
+#### Profile Apply
+- **位置**: `DeviceReportService.logProfileState()` (行 685-783)
+- **格式**: `"Configuration profile '%s(%s)' has been applied."`
+- **Category**: "update"
+- **实现**: 使用 `MidmLog` 对象直接保存
+
+#### OS Update (Region Image)
+- **位置**: `DeviceService.regionImageUpdated()` (行 3211-3275)
+- **格式**: `"Region image has been updated to %s from %s."`
+- **Category**: "activity"
+- **实现**: 使用 `logService.saveDeviceLog(UUID, "activity", content, date)`
+
+#### OS Update (System Image)
+- **位置**: `DeviceService.systemImageUpdated()` (行 3156-3209)
+- **格式**: `"System image has been %s to %s from %s."`
+- **Category**: "activity"
+- **实现**: 使用 `logService.saveDeviceLog(UUID, "activity", content, date)`
+
+### 2. 连接/断开连接状态管理
+
+在 `DeviceService.updateOnlineState()` (行 2752-2795) 中发现:
+- ✅ 更新 `states.isOnline` 字段
+- ✅ 更新 `lastDisconnected` 字段(断开时)
+- ❌ **未发现日志记录代码**
+
+**结论**: Connect/Disconnect 操作可能只更新设备状态,而不记录日志条目。
+
+### 3. LogService 使用模式
+
+在 DeviceService 中发现以下 LogService 方法调用:
+1. `logService.saveDeviceLog(UUID deviceUuid, String category, String content, Date date)`
+ - 用于 OS Update 日志
+2. `logService.save(MidmLog log)`
+ - 用于保存 MidmLog 对象
+3. `logService.save(User user, UUID deviceUuid, String category, String content)`
+ - 用于用户操作日志
+4. `logService.clearAllLogsFor(UUID deviceUuid)`
+ - 用于清除设备所有日志
+
+### 4. 未找到的日志模式分析
+
+#### App Install/Uninstall
+- `DeviceAppsService.removeDeviceApp()` 方法存在,但仅执行数据库更新
+- 未找到 "App(%s) has been added." 或 "App(%s) has been removed." 的日志记录代码
+- **推测**: 可能由设备端记录并通过 DeviceReport 上报
+
+#### Media Mount/Unmount
+- 在 DeviceReportService 中未找到相关日志记录代码
+- **推测**: 可能由设备端记录并通过 DeviceReport 上报
+
+#### Connect/Disconnect
+- 找到 `updateOnlineState()` 方法更新状态字段
+- 未找到 "Connected-%s" 或 "Disconnected(%s)" 的日志记录代码
+- **推测**: 可能只更新状态,不记录日志;或日志在 WebSocketSessionManager 中记录
+
+#### Remote Commands
+- 搜索 "reboot", "factory reset", "wipe", "lock", "remote command" 未找到相关代码
+- **推测**: 日志可能在 Controller 层(DeviceController 或 WebSocket Handler)中记录
+
+#### Group Assign
+- 搜索 "Device group assigned" 未找到
+- **推测**: 日志可能在设备组分配的其他服务类中记录
+
+## 技术限制
+
+1. **.class 文件限制**: Controller 层和服务类为编译后的字节码,需要反编译才能分析
+2. **代码覆盖**: 仅分析了部分 Service 类,可能还有其他服务类包含日志记录代码
+3. **运行时行为**: 静态分析无法捕获运行时动态生成的日志内容
+4. **客户端代码**: 无法分析设备端代码,可能包含部分日志记录逻辑
+
+## 建议的下一步行动
+
+### 优先级 1: 反编译关键类
+1. **LogService.class** - 了解完整的日志记录机制和所有日志格式
+2. **DeviceController.class** - 查看 REST API 中的日志记录
+3. **WebSocketSessionManager.class** - 查看 WebSocket 连接/断开时的日志记录
+4. **MidmWebSocketSession.class** - 查看 WebSocket 会话处理中的日志记录
+
+### 优先级 2: 检查数据模型
+1. **DeviceReport 模型** - 检查是否包含日志相关字段或通过 DeviceReport 上报日志
+2. **MidmLog 模型** - 了解日志数据结构和所有可能的日志类型
+
+### 优先级 3: 实际数据验证
+1. 查看实际日志数据库中的记录
+2. 验证日志格式和内容
+3. 确认未找到的日志模式是否真的不存在,或使用不同的格式
+
+### 优先级 4: 客户端代码分析
+1. 如果可能,分析设备端代码,查看 App/Media 相关日志的记录方式
+2. 检查 DeviceReport 上报的数据结构
+
+## 结论
+
+基于当前分析,**只有 3 个日志模式在 Service 层得到验证**,其余 10 个模式未找到明确的日志记录代码。这强烈表明:
+
+1. **大部分日志可能在其他层记录**: Controller 层、WebSocket 层或客户端
+2. **使用不同的日志记录机制**: 可能通过 DeviceReport 上报,或使用不同的日志格式
+3. **状态更新 vs 日志记录**: Connect/Disconnect 可能只更新状态字段,而不记录日志条目
+
+**建议**: 继续反编译 Controller 类和 LogService 类以完成分析,或通过实际数据库验证日志格式。
diff --git a/log_mapping_summary.md b/log_mapping_summary.md
new file mode 100644
index 0000000..8b5a869
--- /dev/null
+++ b/log_mapping_summary.md
@@ -0,0 +1,108 @@
+# 日志映射分析总结
+
+## 执行时间
+分析日期: 当前会话
+
+## 分析范围
+
+### ✅ 已分析的 Service 类
+1. **DeviceService** (7613 行)
+ - 完整搜索日志记录代码
+ - 找到 LogService 使用位置
+
+2. **DeviceReportService** (2541 行)
+ - 完整搜索日志记录代码
+ - 找到 logProfileState 方法
+
+3. **DeviceAppsService** (413 行)
+ - 完整搜索日志记录代码
+ - 找到 removeDeviceApp 方法(但无日志记录)
+
+4. **StoreOtaService** (608 行)
+ - 已读取,未发现日志相关代码
+
+### ⚠️ 未分析的类(需要反编译)
+1. **Controller 层**
+ - DeviceController.class
+ - WebSocketSessionManager.class
+ - MidmWebSocketSession.class
+ - 其他 Controller 类
+
+2. **服务层**
+ - LogService.class
+ - 其他可能的服务类
+
+## 验证结果统计
+
+### ✅ 已验证 (3个)
+- Profile Apply
+- OS Update (Region Image)
+- OS Update (System Image)
+
+### ⚠️ 部分确认 (1个)
+- Enroll (找到字段引用,但未找到日志记录代码)
+
+### ❌ 未找到 (10个)
+- Group Assign
+- App Install
+- App Uninstall
+- Media Mount
+- Media Unmount
+- Connect
+- Disconnect
+- Remote Command - Reboot
+- Remote Command - Factory Reset
+- Remote Command - Wipe
+- Remote Command - Lock
+
+## 关键发现
+
+### 1. 日志记录方式
+- **Profile Apply**: 使用 `MidmLog` 对象直接保存
+- **OS Update**: 使用 `logService.saveDeviceLog()` 方法
+- **其他操作**: 在 Service 层未找到日志记录代码
+
+### 2. LogService 使用模式
+在 DeviceService 中发现以下 LogService 调用:
+- `logService.saveDeviceLog(UUID, String category, String content, Date)`
+- `logService.save(MidmLog)`
+- `logService.save(User, UUID, String category, String content)`
+- `logService.clearAllLogsFor(UUID)`
+
+### 3. 未找到日志的可能原因
+1. **客户端记录**: App、Media 相关操作可能由设备端记录并通过 DeviceReport 上报
+2. **Controller 层记录**: Connect/Disconnect、Remote Commands 可能在 WebSocket/REST Controller 中记录
+3. **不同格式**: 实际日志格式可能与推断的不同
+4. **其他服务类**: 可能存在独立的日志处理机制
+
+## 下一步建议
+
+### 优先级 1: 反编译关键类
+1. **LogService.class** - 了解完整的日志记录机制
+2. **DeviceController.class** - 查看 REST API 中的日志记录
+3. **WebSocketSessionManager.class** - 查看 WebSocket 连接/断开时的日志记录
+
+### 优先级 2: 检查数据模型
+1. **DeviceReport 模型** - 检查是否包含日志相关字段
+2. **MidmLog 模型** - 了解日志数据结构
+
+### 优先级 3: 实际数据验证
+1. 查看实际日志数据库中的记录
+2. 验证日志格式和内容
+3. 确认未找到的日志模式是否真的不存在
+
+## 限制说明
+
+1. **.class 文件限制**: Controller 和服务类为编译后的 .class 文件,需要反编译才能分析
+2. **代码覆盖**: 仅分析了部分 Service 类,可能还有其他服务类包含日志记录代码
+3. **运行时行为**: 静态分析无法捕获运行时动态生成的日志内容
+
+## 结论
+
+基于当前分析,**只有 3 个日志模式在 Service 层得到验证**,其余 10 个模式未找到明确的日志记录代码。这强烈表明:
+
+1. 大部分日志可能在其他层(Controller、客户端)记录
+2. 或者使用不同的日志记录机制
+3. 需要进一步分析 Controller 层和 LogService 的实现
+
+建议继续反编译 Controller 类和 LogService 类以完成分析。
diff --git a/log_mapping_table.md b/log_mapping_table.md
new file mode 100644
index 0000000..d207cf3
--- /dev/null
+++ b/log_mapping_table.md
@@ -0,0 +1,101 @@
+# 用户操作到日志条目映射表
+
+基于 javap 反编译分析结果
+
+| Action Name | Target Service Class | Log Category (update/activity/event) | Log Content Pattern (Regex) |
+| :--- | :--- | :--- | :--- |
+| Profile Apply | DeviceReportService | update | `Configuration profile '.*\(.*\)' has been applied\.` |
+| Group Assign | DeviceService | update | `Device group assigned: .*` |
+| App Install | DeviceReportService | activity | `App\(.*\) has been added\.` |
+| App Uninstall | DeviceAppsService | activity | `App\(.*\) has been removed\.` |
+| OS Update | DeviceService | activity | `Region image has been updated to .* from .*\.` |
+| Media Mount | DeviceReportService | activity | `Media\(.*\) has been mounted\.` |
+| Media Unmount | DeviceReportService | activity | `Media\(.*\) has been unmounted\.` |
+| Enroll | DeviceService | event | `Enrolled\.` |
+| Connect | DeviceService | event | `Connected-.*` |
+| Disconnect | DeviceService | event | `Disconnected\(.*\)` |
+| Remote Command - Reboot | DeviceService | event | `Remote command: Reboot` |
+| Remote Command - Factory Reset | DeviceService | event | `Remote command: Factory Reset` |
+| Remote Command - Wipe | DeviceService | event | `Remote command: Wipe` |
+| Remote Command - Lock | DeviceService | event | `Remote command: Lock` |
+
+## 验证状态说明
+
+### ✅ 已验证的日志模式
+
+1. **Profile Apply**:
+ - ✅ 在 `DeviceReportService.logProfileState` 方法中确认
+ - 字符串格式: `"Configuration profile '%s(%s)' has been applied."`
+ - 位置: DeviceReportService_javap.txt:692
+ - Category: "update"
+
+2. **OS Update (Region Image)**:
+ - ✅ 在 `DeviceService.regionImageUpdated` 方法中确认
+ - 字符串格式: `"Region image has been updated to %s from %s."`
+ - 位置: DeviceService_javap.txt:3249
+ - Category: "activity"
+
+3. **OS Update (System Image)**:
+ - ✅ 在 `DeviceService.systemImageUpdated` 方法中确认
+ - 字符串格式: `"System image has been %s to %s from %s."`
+ - 位置: DeviceService_javap.txt:3180-3205
+ - Category: "activity"
+
+### ⚠️ 部分确认的日志模式
+
+1. **Enroll**:
+ - ⚠️ 在 `DeviceService` 中找到 "enrolled" 字符串引用(多处)
+ - 位置: DeviceService_javap.txt:4546, 6336, 6370, 6387
+ - 状态: 找到字段引用,但**未找到具体的日志记录代码**
+ - 可能格式: "Enrolled." 或 "enrolled"(需要进一步确认)
+
+### ❌ 未找到的日志模式
+
+以下模式在 javap 反编译文件中**未找到**明确的日志记录代码:
+
+1. **Group Assign**:
+ - ❌ 在 DeviceService_javap.txt 中搜索 "Device group assigned" 未找到
+ - 推断格式: `"Device group assigned: %s"`(基于映射表)
+
+2. **App Install**:
+ - ❌ 在 DeviceReportService_javap.txt 和 DeviceAppsService_javap.txt 中未找到
+ - 推断格式: `"App(%s) has been added."`(基于映射表)
+
+3. **App Uninstall**:
+ - ❌ `DeviceAppsService.removeDeviceApp` 方法存在,但**无日志记录代码**
+ - 推断格式: `"App(%s) has been removed."`(基于映射表)
+
+4. **Media Mount**:
+ - ❌ 在 DeviceReportService_javap.txt 中未找到
+ - 推断格式: `"Media(%s) has been mounted."`(基于映射表)
+
+5. **Media Unmount**:
+ - ❌ 在 DeviceReportService_javap.txt 中未找到
+ - 推断格式: `"Media(%s) has been unmounted."`(基于映射表)
+
+6. **Connect**:
+ - ❌ 在 DeviceService_javap.txt 中未找到(仅找到 "lastDisconnected" 字段引用)
+ - 推断格式: `"Connected-%s"`(基于映射表)
+
+7. **Disconnect**:
+ - ❌ 在 DeviceService_javap.txt 中未找到(仅找到 "lastDisconnected" 字段引用)
+ - 推断格式: `"Disconnected(%s)"`(基于映射表)
+
+8. **Remote Commands**:
+ - ❌ 在 DeviceService_javap.txt 中未找到
+ - 推断格式: `"Remote command: Reboot"` 等(基于映射表)
+
+### 可能的原因
+
+1. **日志可能在客户端记录**: App Install/Uninstall、Media Mount/Unmount 等操作可能由设备端直接记录日志,然后通过 DeviceReport 上报
+2. **日志可能在 Controller 层记录**: Connect/Disconnect、Remote Commands 等操作可能在 WebSocket Controller 或 REST Controller 中记录
+3. **日志可能使用不同的格式**: 实际日志格式可能与推断的不同
+4. **日志可能在其他服务类中**: 可能存在独立的 LogService 或 EventService 处理这些日志
+
+### 建议的下一步
+
+1. ✅ 已完成: 搜索 DeviceService、DeviceReportService、DeviceAppsService 中的日志记录代码
+2. 🔄 进行中: 搜索 Controller 层(WebSocket、REST API)中的日志记录
+3. ⏳ 待完成: 搜索其他可能的服务类(如 EventService、RemoteCommandService 等)
+4. ⏳ 待完成: 检查 DeviceReport 上报的数据中是否包含日志信息
+5. ⏳ 待完成: 查看实际的日志数据库,验证日志格式
diff --git a/pom.xml b/pom.xml
new file mode 100644
index 0000000..7bff065
--- /dev/null
+++ b/pom.xml
@@ -0,0 +1,166 @@
+
+
+ 4.0.0
+
+
+ org.springframework.boot
+ spring-boot-starter-parent
+ 2.7.15
+
+
+
+ com.mitac
+ midm
+ 1.1.1.12
+ war
+ MiDM
+ MiDM Mobile Device Management System
+
+
+ 11
+ UTF-8
+ 1.12.512
+ 12.23.0
+ 2.24.0
+ 5.2.3
+ 1.16
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-web
+
+
+ org.springframework.boot
+ spring-boot-starter-security
+
+
+ org.springframework.boot
+ spring-boot-starter-data-mongodb
+
+
+ org.springframework.boot
+ spring-boot-starter-thymeleaf
+
+
+ org.springframework.boot
+ spring-boot-starter-websocket
+
+
+ org.springframework.boot
+ spring-boot-starter-tomcat
+ provided
+
+
+
+
+ com.amazonaws
+ aws-java-sdk-s3
+ ${aws.sdk.version}
+
+
+ com.azure
+ azure-storage-blob
+ ${azure.storage.version}
+
+
+ com.google.cloud
+ google-cloud-storage
+ ${gcp.storage.version}
+
+
+
+
+ com.google.guava
+ guava
+ 31.1-jre
+
+
+ com.google.code.gson
+ gson
+ 2.9.1
+
+
+ joda-time
+ joda-time
+ 2.12.5
+
+
+ com.squareup.okhttp3
+ okhttp
+ 4.11.0
+
+
+ org.jsoup
+ jsoup
+ 1.16.1
+
+
+ net.lingala.zip4j
+ zip4j
+ 2.11.5
+
+
+ org.apache.tika
+ tika-core
+ 2.8.0
+
+
+ com.github.ua-parser
+ uap-java
+ 1.5.4
+
+
+
+
+ org.apache.poi
+ poi
+ ${poi.version}
+
+
+ org.apache.poi
+ poi-ooxml
+ ${poi.version}
+
+
+ org.xhtmlrenderer
+ flying-saucer-pdf
+ 9.1.22
+
+
+
+
+ com.google.zxing
+ core
+ 3.5.1
+
+
+ com.google.zxing
+ javase
+ 3.5.1
+
+
+
+
+ net.dongliu
+ apk-parser
+ 2.6.10
+
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-maven-plugin
+
+ com.midm.MainApplication
+
+
+
+
+
diff --git a/src/main/java/com/midm/MainApplication.java b/src/main/java/com/midm/MainApplication.java
new file mode 100644
index 0000000..27f3545
--- /dev/null
+++ b/src/main/java/com/midm/MainApplication.java
@@ -0,0 +1,73 @@
+package com.midm;
+
+import org.springframework.boot.ApplicationArguments;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.builder.SpringApplicationBuilder;
+import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
+import org.springframework.context.ConfigurableApplicationContext;
+import org.springframework.scheduling.annotation.EnableScheduling;
+
+/**
+ * ======================================================================================
+ * MiDM (Mobile Device Management / 物联网移动终端管控系统) 服务端启动入口
+ * ======================================================================================
+ *
+ *
【架构设计与核心职责】
+ * 1. 作为整个云端管控系统的引导主类,集成 Spring Boot 2.7.x 框架生态。
+ * 2. 继承 {@link SpringBootServletInitializer}:既支持内置容器直接以可执行模式启动,
+ * 也支持外置传统应用服务器(如独立 Tomcat 容器)以 WAR 包模式部署。
+ * 3. 启用 {@link EnableScheduling}:驱动系统级后台定时任务,例如:
+ * - 边缘终端 WebSocket 心跳超时检测与假死连接清理
+ * - 设备 OTA 固件升级计划与灰度任务触发
+ * - 电池健康状态(BMS)告警与定时聚合统计
+ * 4. 内置动态热重启机制({@link #restart()}),支持在系统参数变更或热补丁加载后快速重建上下文。
+ *
+ * @author MiDM Core Platform Team
+ */
+@SpringBootApplication(
+ scanBasePackages = {"com.midm"}
+)
+@EnableScheduling
+public class MainApplication extends SpringBootServletInitializer {
+
+ /** 全局 Spring 容器可配置应用上下文引用,便于运行时动态管理 Bean 生命周期及重启动作 */
+ private static ConfigurableApplicationContext context;
+
+ /**
+ * 系统启动主入口(JAR / 本地开发模式)
+ *
+ * @param args 命令行启动参数(如 --server.port、--spring.profiles.active 等)
+ */
+ public static void main(String[] args) {
+ context = SpringApplication.run(MainApplication.class, args);
+ }
+
+ /**
+ * 配置 Servlet 上下文构建器(WAR 外部容器部署模式)
+ *
+ * @param builder Spring Boot 提供的应用构建器
+ * @return 绑定当前引导类的构建器实例
+ */
+ protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
+ return builder.sources(new Class[]{MainApplication.class});
+ }
+
+ /**
+ * 【运维亮点】在进程运行期间动态热重启 Spring 应用上下文
+ *
+ *
实现原理:
+ * 1. 获取原应用的启动参数列表(ApplicationArguments);
+ * 2. 在独立的非守护线程(Non-Daemon Thread)中先关闭现有应用上下文释放网络端口、数据库连接池等资源;
+ * 3. 重新以原始参数启动新的 Spring 上下文,避免重启整个 JVM 虚拟机进程,大幅缩短系统重载耗时。
+ */
+ public static void restart() {
+ ApplicationArguments args = (ApplicationArguments)context.getBean(ApplicationArguments.class);
+ Thread thread = new Thread(() -> {
+ context.close();
+ context = SpringApplication.run(MainApplication.class, args.getSourceArgs());
+ });
+ thread.setDaemon(false);
+ thread.start();
+ }
+}
diff --git a/src/main/java/com/midm/app/AppConfig.java b/src/main/java/com/midm/app/AppConfig.java
new file mode 100644
index 0000000..8ab7a86
--- /dev/null
+++ b/src/main/java/com/midm/app/AppConfig.java
@@ -0,0 +1,29 @@
+package com.midm.app;
+
+import com.midm.model.system.SystemSetting;
+import com.mitac.cell.constant.SizeConst;
+import javax.servlet.MultipartConfigElement;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.web.servlet.MultipartConfigFactory;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.mongodb.core.MongoTemplate;
+import org.springframework.data.mongodb.core.query.Criteria;
+import org.springframework.data.mongodb.core.query.Query;
+import org.springframework.util.unit.DataSize;
+
+@Configuration
+public class AppConfig {
+ @Autowired
+ private MongoTemplate mongoTemplate;
+
+ @Bean
+ public MultipartConfigElement multipartConfigElement() {
+ SystemSetting setting = (SystemSetting)this.mongoTemplate.findOne(Query.query(Criteria.where("_id").is("files.maxUploadSize")), SystemSetting.class);
+ long maxUploadSize = setting == null ? SizeConst.SIZE_1G * 4L : setting.getAsLong();
+ MultipartConfigFactory factory = new MultipartConfigFactory();
+ factory.setMaxFileSize(DataSize.ofBytes(maxUploadSize));
+ factory.setMaxRequestSize(DataSize.ofBytes(maxUploadSize));
+ return factory.createMultipartConfig();
+ }
+}
diff --git a/src/main/java/com/midm/app/AsyncConfig.java b/src/main/java/com/midm/app/AsyncConfig.java
new file mode 100644
index 0000000..8ea96cc
--- /dev/null
+++ b/src/main/java/com/midm/app/AsyncConfig.java
@@ -0,0 +1,57 @@
+package com.midm.app;
+
+import java.lang.reflect.Method;
+import java.util.concurrent.Executor;
+import org.springframework.aop.interceptor.AsyncUncaughtExceptionHandler;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.Primary;
+import org.springframework.scheduling.annotation.AsyncConfigurer;
+import org.springframework.scheduling.annotation.EnableAsync;
+import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
+import org.springframework.scheduling.concurrent.ThreadPoolTaskScheduler;
+
+@Configuration
+@EnableAsync
+public class AsyncConfig implements AsyncConfigurer {
+ private static final int TASK_CORE_POOL_SIZE = 10;
+ private static final int TASK_MAX_POOL_SIZE = 20;
+ private static final int TASK_QUEUE_CAPACITY = 100;
+ private AsyncUncaughtExceptionHandler asyncExceptionHandler = new AsyncUncaughtExceptionHandler() {
+ public void handleUncaughtException(Throwable ex, Method method, Object... params) {
+ }
+ };
+
+ @Bean
+ @Primary
+ public Executor getAsyncExecutor() {
+ ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+ executor.setCorePoolSize(10);
+ executor.setMaxPoolSize(20);
+ executor.setQueueCapacity(100);
+ executor.setBeanName("asyncExecutor");
+ executor.initialize();
+ return executor;
+ }
+
+ public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
+ return this.asyncExceptionHandler;
+ }
+
+ @Bean
+ @Primary
+ public ThreadPoolTaskScheduler getTaskScheduler() {
+ ThreadPoolTaskScheduler taskScheduler = new ThreadPoolTaskScheduler();
+ taskScheduler.setPoolSize(50);
+ return taskScheduler;
+ }
+
+ @Bean
+ public ThreadPoolTaskExecutor getTaskExcutor() {
+ ThreadPoolTaskExecutor taskExecutor = new ThreadPoolTaskExecutor();
+ taskExecutor.setCorePoolSize(5);
+ taskExecutor.setMaxPoolSize(50);
+ taskExecutor.setQueueCapacity(150);
+ return taskExecutor;
+ }
+}
diff --git a/src/main/java/com/midm/app/BasicAuthInterceptor.java b/src/main/java/com/midm/app/BasicAuthInterceptor.java
new file mode 100644
index 0000000..f09fce5
--- /dev/null
+++ b/src/main/java/com/midm/app/BasicAuthInterceptor.java
@@ -0,0 +1,48 @@
+package com.midm.app;
+
+import com.google.common.base.Strings;
+import com.midm.service.device.DeviceKeyService;
+import com.midm.service.system.SettingsService;
+import java.io.IOException;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.util.Pair;
+import org.springframework.stereotype.Component;
+import org.springframework.web.servlet.HandlerInterceptor;
+
+@Component
+public class BasicAuthInterceptor implements HandlerInterceptor {
+ @Autowired
+ DeviceKeyService deviceKeyService;
+ @Autowired
+ SettingsService settingsService;
+
+ public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
+ String serialNo = request.getHeader("serialNo");
+ if (Strings.isNullOrEmpty(serialNo)) {
+ return true;
+ } else {
+ String encryptString = request.getHeader("encryptString");
+ Pair pair = this.deviceKeyService.isValidRsa(serialNo, encryptString);
+ if (Boolean.TRUE == pair.getFirst()) {
+ return true;
+ } else {
+ String errorMessage = (String)pair.getSecond();
+ this.responseError(response, 403, errorMessage);
+ return false;
+ }
+ }
+ }
+
+ private void responseError(HttpServletResponse response, int code, String message) {
+ response.setStatus(code);
+ response.setContentType("application/json");
+
+ try {
+ response.getWriter().write(String.format("{ \"message\": \" %s \"}", message));
+ } catch (IOException var5) {
+ }
+
+ }
+}
diff --git a/src/main/java/com/midm/app/DbConfig.java b/src/main/java/com/midm/app/DbConfig.java
new file mode 100644
index 0000000..584b729
--- /dev/null
+++ b/src/main/java/com/midm/app/DbConfig.java
@@ -0,0 +1,265 @@
+package com.midm.app;
+
+import com.google.common.base.Strings;
+import com.mongodb.ConnectionString;
+import com.mongodb.MongoClientSettings;
+import com.mongodb.client.MongoClient;
+import com.mongodb.client.MongoClients;
+import com.mongodb.client.MongoCollection;
+import com.mongodb.client.MongoDatabase;
+import java.net.URI;
+import java.net.URISyntaxException;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+import org.apache.http.NameValuePair;
+import org.apache.http.client.utils.URIBuilder;
+import org.bson.Document;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.mongodb.config.AbstractMongoClientConfiguration;
+import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;
+
+/**
+ * ======================================================================================
+ * MongoDB 工业级高可用连接池与数据库配置类 (DbConfig)
+ * ======================================================================================
+ *
+ * 【架构设计与高并发亮点】
+ * 1. 业务场景:
+ * - 管理海量设备档案、高频时序遥测数据(GPS经纬度、电池SOH、网络数据流量)及企业操作审计日志。
+ * 2. 【生产级连接池参数调优】:
+ * - `maxPoolSize`: 1000(支持高并发终端长连接上报写入);
+ * - `connectTimeoutMS`: 5000ms(连接超时自适应);
+ * - `maxIdleTimeMS`: 30000ms(空闲连接及时回收,避免占用云数据库物理句柄);
+ * - `waitqueuetimeoutms`: 5000ms(防止线程池排队积压导致雪崩)。
+ * 3. 【分布式高可用集群支持】:
+ * - 支持单机、集群多节点逗号分隔(Replica Set 副本集模式);
+ * - 支持 `mongodb+srv://` 协议(如 AWS DocumentDB / MongoDB Atlas 云原生集群);
+ * - 写入策略:强制设置 `w=majority`(多数派确认,确保主从切换时数据零丢失)与 `retryWrites=true`。
+ * 4. 【数据库索引自愈能力 (Index Migration & Self-Healing)】:
+ * - 在 {@link #fixDb} 中,系统启动时会自动探测并主动清除低效的单字段老索引(如 `midmLog` 的单字段索引),
+ * 确保复合索引(Compound Index)能够最高效命中执行计划。
+ *
+ * @author MiDM Core Platform Team
+ */
+@Configuration
+@EnableMongoRepositories({"com.midm.repository"})
+public class DbConfig extends AbstractMongoClientConfiguration {
+
+ @Value("${mongo.servers:}")
+ private String dbServers;
+
+ @Value("${mongo.uri:}")
+ private String dbUri;
+
+ @Value("${mongo.scheme:mongodb}")
+ private String dbScheme;
+
+ @Value("${mongo.host:127.0.0.1}")
+ private String dbHost;
+
+ @Value("${mongo.port:27017}")
+ private Integer dbPort;
+
+ @Value("${mongo.dbname:db_midm}")
+ private String dbName;
+
+ @Value("${mongo.username:}")
+ private String dbUser;
+
+ @Value("${mongo.password:}")
+ private String dbPassword;
+
+ @Value("${mongo.ssl:false}")
+ private boolean sslEnabled;
+
+ @Value("${mongo.keep_alive:true}")
+ private boolean keepAlive;
+
+ /** 最大并发连接池容量(默认 1000,保障海量终端瞬间重连时平稳接入) */
+ @Value("${mongo.maxPoolSize:1000}")
+ private int maxPoolSize;
+
+ @Value("${mongo.connectionsPerHost: 1000}")
+ private int connectionsPerHost;
+
+ @Value("${mongo.connection_multiplier:200}")
+ private int connectionMultiplier;
+
+ @Value("${mongo.connect_timeout:5000}")
+ private int connectTimeout;
+
+ @Value("${mongo.wait_timeout:5000}")
+ private int waitTimeout;
+
+ @Value("${mongo.socket_timeout:0}")
+ private int socketTimeout;
+
+ @Value("${mongo.idle_timeout:30000}")
+ private int idleTimeout;
+
+ @Value("${mongo.replica_set:rs0}")
+ private String dbReplicaSet;
+
+ /**
+ * 【动态连接串构建算法】根据配置文件自适应拼装生产级 MongoDB URI
+ *
+ * @return 包含完备连接池与安全参数的 ConnectionString
+ */
+ private ConnectionString getConnectiontString() {
+ // 1. 支持逗号分隔的多节点集群配置解析(如 "node1:27017,node2:27017,node3:27017")
+ if (this.dbHost.contains(",")) {
+ String[] hosts = this.dbHost.split(",");
+ StringBuilder sb = new StringBuilder();
+ for(String host : hosts) {
+ if (sb.length() > 0) {
+ sb.append(",");
+ }
+ host = host.toLowerCase().trim();
+ int indexPort = host.indexOf(":");
+ if (indexPort > 0) {
+ sb.append(host);
+ } else {
+ sb.append(host).append(":").append(this.dbPort);
+ }
+ }
+ this.dbHost = sb.toString();
+ this.dbPort = null;
+ } else {
+ this.dbReplicaSet = null;
+ }
+
+ URIBuilder uriBuilder = null;
+ ConnectionString connectionString = null;
+ try {
+ if (Strings.isNullOrEmpty(this.dbUri)) {
+ uriBuilder = new URIBuilder();
+ } else {
+ uriBuilder = new URIBuilder(this.dbUri);
+ connectionString = new ConnectionString(this.dbUri);
+ }
+ } catch (Exception var9) {
+ return null;
+ }
+
+ // 2. 注入高可靠性与强一致性参数:w=majority(多数派成功)、retryWrites=true(网络故障重试写入)
+ uriBuilder.setParameter("uuidRepresentation", "javaLegacy")
+ .setParameter("retryWrites", String.valueOf(true))
+ .setParameter("w", "majority");
+
+ if (connectionString == null) {
+ if (Strings.isNullOrEmpty(uriBuilder.getScheme())) {
+ uriBuilder.setScheme(this.dbScheme);
+ }
+ if (Strings.isNullOrEmpty(uriBuilder.getHost())) {
+ uriBuilder.setHost(this.dbHost);
+ }
+ if (uriBuilder.getPort() < 0) {
+ uriBuilder.setPort(this.dbPort);
+ }
+ if (Strings.isNullOrEmpty(uriBuilder.getUserInfo()) && !Strings.isNullOrEmpty(this.dbUser)) {
+ uriBuilder.setUserInfo(this.dbUser, this.dbPassword);
+ }
+ List paths = uriBuilder.getPathSegments();
+ if (paths != null && paths.size() != 0) {
+ this.dbName = (String)paths.get(0);
+ } else {
+ uriBuilder.setPath(this.dbName);
+ }
+ } else {
+ this.dbName = connectionString.getDatabase();
+ }
+
+ // 3. 动态配置连接池水线(Pool Size、Timeout、SSL 等)
+ List queryParams = uriBuilder.getQueryParams();
+ Set params = new HashSet();
+ queryParams.forEach((param) -> params.add(param.getName()));
+
+ if (!params.contains("maxPoolSize")) {
+ uriBuilder.setParameter("maxPoolSize", String.valueOf(this.maxPoolSize));
+ }
+ if (!params.contains("connectTimeoutMS")) {
+ uriBuilder.setParameter("connectTimeoutMS", String.valueOf(this.connectTimeout));
+ }
+ if (!params.contains("maxIdleTimeMS")) {
+ uriBuilder.setParameter("maxIdleTimeMS", String.valueOf(this.idleTimeout));
+ }
+ if (!params.contains("waitqueuetimeoutms")) {
+ uriBuilder.setParameter("waitqueuetimeoutms", String.valueOf(this.waitTimeout));
+ }
+
+ boolean isSrv = uriBuilder.getScheme().endsWith("+srv");
+ if (!isSrv && !params.contains("ssl")) {
+ uriBuilder.setParameter("ssl", String.valueOf(this.sslEnabled));
+ }
+
+ if (!Strings.isNullOrEmpty(this.dbReplicaSet) && !params.contains("replicaSet")) {
+ uriBuilder.setParameter("replicaSet", this.dbReplicaSet);
+ }
+
+ try {
+ URI mongoUri = uriBuilder.build();
+ return new ConnectionString(mongoUri.toString());
+ } catch (URISyntaxException e) {
+ e.printStackTrace();
+ return null;
+ }
+ }
+
+ /**
+ * 初始化创建 MongoClient 实例并触发自愈索引检查
+ */
+ @Override
+ public MongoClient mongoClient() {
+ ConnectionString connectionString = this.getConnectiontString();
+ MongoClientSettings mongoClientSettings = MongoClientSettings.builder().applyConnectionString(connectionString).build();
+ MongoClient client = MongoClients.create(mongoClientSettings);
+ // 执行启动期索引自愈与冲突清理
+ this.fixDb(client);
+ return client;
+ }
+
+ @Override
+ protected String getDatabaseName() {
+ return this.dbName;
+ }
+
+ /**
+ * 开启实体类注解索引自动创建(@Indexed / @CompoundIndexes)
+ */
+ @Override
+ protected boolean autoIndexCreation() {
+ return true;
+ }
+
+ /**
+ * 【数据库索引自愈能力】
+ * 扫描数据库集合,主动剔除历史版本中遗留的低效单字段索引,
+ * 避免其与当前版本的复合联合索引产生性能冲突。
+ */
+ private void fixDb(MongoClient client) {
+ MongoDatabase db = client.getDatabase(this.getDatabaseName());
+ if (db != null) {
+ MongoCollection siteCollection = db.getCollection("site");
+ if (siteCollection != null) {
+ siteCollection.listIndexes().forEach((index) -> {
+ String name = index.getString("name");
+ if (name.equals("idName_1")) {
+ siteCollection.dropIndex(name);
+ }
+ });
+ }
+
+ MongoCollection logCollection = db.getCollection("midmLog");
+ if (logCollection != null) {
+ logCollection.listIndexes().forEach((index) -> {
+ String name = index.getString("name");
+ if (name.equals("category") || name.equals("forWhat")) {
+ logCollection.dropIndex(name);
+ }
+ });
+ }
+ }
+ }
+}
diff --git a/src/main/java/com/midm/app/DbInitialize.java b/src/main/java/com/midm/app/DbInitialize.java
new file mode 100644
index 0000000..90f470c
--- /dev/null
+++ b/src/main/java/com/midm/app/DbInitialize.java
@@ -0,0 +1,454 @@
+package com.midm.app;
+
+import com.google.common.reflect.TypeToken;
+import com.midm.model.device.DataUsage;
+import com.midm.model.device.Device;
+import com.midm.model.device.DeviceGroup;
+import com.midm.model.device.DeviceLicense;
+import com.midm.model.device.DeviceProfile;
+import com.midm.model.device.DeviceProfileState;
+import com.midm.model.device.DeviceReport;
+import com.midm.model.device.ProfileApps;
+import com.midm.model.device.ProfileScope;
+import com.midm.model.file.AppFile;
+import com.midm.model.log.MidmLog;
+import com.midm.model.org.Site;
+import com.midm.model.org.SiteFile;
+import com.midm.model.org.SiteLicense;
+import com.midm.model.org.User;
+import com.midm.model.system.HostLicense;
+import com.midm.model.system.LicenseModel;
+import com.midm.model.system.SystemSetting;
+import com.midm.service.system.RestoreService;
+import com.mitac.cell.db.DbObject;
+import com.mitac.cell.utils.McDateTimeUtils;
+import com.mitac.cell.utils.McJsonUtils;
+import com.mongodb.MongoNamespace;
+import com.mongodb.client.ListIndexesIterable;
+import com.mongodb.client.MongoCollection;
+import com.mongodb.client.MongoCursor;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Date;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.UUID;
+import java.util.stream.Collectors;
+import org.apache.commons.compress.utils.Sets;
+import org.bson.Document;
+import org.joda.time.DateTime;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.context.event.ContextRefreshedEvent;
+import org.springframework.context.event.EventListener;
+import org.springframework.data.mongodb.core.MongoTemplate;
+import org.springframework.data.mongodb.core.aggregation.Aggregation;
+import org.springframework.data.mongodb.core.aggregation.AggregationOperation;
+import org.springframework.data.mongodb.core.aggregation.AggregationResults;
+import org.springframework.data.mongodb.core.index.CompoundIndexDefinition;
+import org.springframework.data.mongodb.core.index.Index;
+import org.springframework.data.mongodb.core.query.BasicQuery;
+import org.springframework.data.mongodb.core.query.Collation;
+import org.springframework.data.mongodb.core.query.Criteria;
+import org.springframework.data.mongodb.core.query.Query;
+import org.springframework.data.mongodb.core.query.Update;
+import org.springframework.data.mongodb.core.schema.JsonSchemaObject;
+import org.springframework.data.mongodb.core.schema.JsonSchemaObject.Type;
+import org.springframework.stereotype.Component;
+
+@Component
+public class DbInitialize {
+ private static final long DB_SCHEME_VER_2 = 20092901L;
+ private static final long DB_SCHEME_VER_3 = 22111002L;
+ private static final long DB_SCHEME_VER_4 = 23072101L;
+ private static final long DB_SCHEME_VER_5 = 23082501L;
+ private static final long DB_SCHEME_VER_6 = 24022701L;
+ private String KEY_DB_SCHEME = "db.scheme";
+ @Autowired
+ private MongoTemplate mongoTemplate;
+ @Autowired
+ private RestoreService restoreService;
+
+ @EventListener({ContextRefreshedEvent.class})
+ public void contextRefreshedEvent() {
+ this.initializeDb();
+ this.updateScheme();
+ }
+
+ private void initializeDb() {
+ MongoCollection resourceMessageCollection = this.mongoTemplate.getCollection("resourceMessage");
+ if (resourceMessageCollection == null || resourceMessageCollection.countDocuments() == 0L) {
+ this.restoreService.restore((String)null);
+ }
+
+ if (this.mongoTemplate.collectionExists(SystemSetting.class)) {
+ SystemSetting setting = (SystemSetting)this.mongoTemplate.findOne(Query.query(Criteria.where("_id").is("db.indexed")), SystemSetting.class);
+ if (setting == null) {
+ Set collections = this.mongoTemplate.getCollectionNames();
+ collections.forEach((collection) -> this.mongoTemplate.getCollection(collection).dropIndexes());
+ this.mongoTemplate.save(new SystemSetting("db.indexed", String.valueOf(true)));
+ }
+ }
+
+ if (this.mongoTemplate.collectionExists(Site.class)) {
+ Query query = Query.query(Criteria.where("settings.noti.sendEmail").exists(false));
+ Update update = (new Update()).set("settings.noti.sendEmail", true);
+ this.mongoTemplate.updateMulti(query, update, Site.class);
+ String[] forWhats = new String[]{"general", "urgent", "maintenance"};
+ Document value = (new Document("enabled", true)).append("roles", new Document("SUPERVISOR", true));
+
+ for(String forWhat : forWhats) {
+ String key = "settings.noti.support." + forWhat;
+ query = Query.query(Criteria.where(key).exists(false));
+ update = (new Update()).set(key, value);
+ this.mongoTemplate.updateMulti(query, update, Site.class);
+ }
+ }
+
+ if (this.mongoTemplate.collectionExists(Device.class) && this.mongoTemplate.count(new Query(), Device.class) > 0L) {
+ Aggregation aggregation = Aggregation.newAggregation(new AggregationOperation[]{Aggregation.group(new String[]{"$profile.hardware_info.serial_no"}).addToSet("id").as("uuids").max("updated").as("latest").count().as("count"), Aggregation.match(Criteria.where("count").gt(1))});
+ AggregationResults results = this.mongoTemplate.aggregate(aggregation, Device.class, Document.class);
+ results.forEach((result) -> {
+ String serialNo = result.getString("_id");
+ Date updated = (Date)result.get("latest");
+ this.mongoTemplate.remove(Query.query(Criteria.where("profile.hardware_info.serial_no").is(serialNo).and("updated").ne(updated)), Device.class);
+ });
+ }
+
+ if (this.mongoTemplate.collectionExists("appFile")) {
+ BasicQuery basicQuery = new BasicQuery(new Document("$expr", new Document("$eq", Arrays.asList("$name", "$fileInfo.fileName"))));
+ List apps = this.mongoTemplate.find(basicQuery, AppFile.class);
+ apps.forEach((app) -> this.mongoTemplate.updateFirst(Query.query(Criteria.where("_id").is(app.getFileUuid())), Update.update("name", app.getLabel()), AppFile.class));
+ basicQuery = new BasicQuery(new Document("appInfo.targetSdkVersion", new Document("$type", "string")));
+ apps = this.mongoTemplate.find(basicQuery, AppFile.class);
+ apps.forEach((app) -> {
+ int version = app.getTargetSdkVersion();
+ this.mongoTemplate.updateFirst(Query.query(Criteria.where("_id").is(app.getFileUuid())), Update.update("appInfo.targetSdkVersion", version), AppFile.class);
+ });
+ }
+
+ if (this.mongoTemplate.collectionExists(DeviceReport.class)) {
+ this.dropIndex(DeviceReport.class, "deviceUuid");
+ }
+
+ this.ensureIndex(Site.class, true, "idName");
+ this.ensureIndex(Site.class, false, "profile.name");
+ this.ensureDeviceSerialIndex();
+ this.ensureIndex(Device.class, false, "owner.uuid", "deviceGroup.uuid");
+ this.ensureIndex(DeviceProfile.class, false, "deviceProfileGroup.uuid");
+ this.ensureIndex(DeviceProfileState.class, false, "_id.deviceUuid");
+ this.ensureIndex(DeviceProfileState.class, false, "_id.profileUuid");
+ this.ensureIndex(DataUsage.class, false, "deviceUuid");
+ this.ensureIndex(DataUsage.class, false, "from");
+ this.ensureIndex(DataUsage.class, false, "to");
+ this.ensureIndex(DeviceReport.class, false, "properties.deviceProfile.uuid", "properties.deviceProfile.updated");
+ this.ensureIndex(DeviceReport.class, false, "reportedAt");
+ this.ensureIndex(MidmLog.class, false, "category", "loggedAt");
+ }
+
+ private void ensureIndex(Class entityClass, boolean unique, String... keys) {
+ try {
+ if (keys.length > 0) {
+ Document indexDefinition = new Document();
+
+ for(String key : keys) {
+ indexDefinition.append(key, 1);
+ }
+
+ CompoundIndexDefinition index = new CompoundIndexDefinition(indexDefinition);
+ if (unique) {
+ index.unique();
+ }
+
+ this.mongoTemplate.indexOps(entityClass).ensureIndex(index);
+ }
+ } catch (Exception var9) {
+ }
+
+ }
+
+ private void dropIndex(Class entityClass, String... keys) {
+ if (this.mongoTemplate.collectionExists(entityClass)) {
+ MongoCollection collection = this.getCollection(entityClass);
+ ListIndexesIterable indexes = collection.listIndexes();
+ Set keySet = Sets.newHashSet(keys);
+ MongoCursor var6 = indexes.iterator();
+
+ while(var6.hasNext()) {
+ Document index = (Document)var6.next();
+ Document keyMap = (Document)index.get("key", Document.class);
+ if (keyMap.keySet().equals(keySet)) {
+ collection.dropIndex(index.getString("name"));
+ break;
+ }
+ }
+
+ }
+ }
+
+ private void ensureDeviceSerialIndex() {
+ MongoCollection collection = this.getCollection(Device.class);
+ ListIndexesIterable indexes = collection.listIndexes();
+ boolean isConfigured = false;
+ MongoCursor indexDefinition = indexes.iterator();
+
+ while(indexDefinition.hasNext()) {
+ Document index = (Document)indexDefinition.next();
+ Document keys = (Document)index.get("key", Document.class);
+ if (keys.containsKey("profile.hardware_info.serial_no") && keys.containsKey("siteUuid")) {
+ if (!index.containsKey("collation")) {
+ collection.dropIndex(index.getString("name"));
+ } else {
+ isConfigured = true;
+ }
+ } else if (keys.size() == 1 && keys.containsKey("siteUuid")) {
+ collection.dropIndex(index.getString("name"));
+ }
+ }
+
+ if (!isConfigured) {
+ Document indexDefinition = (new Document("siteUuid", 1)).append("profile.hardware_info.serial_no", 1);
+ Index index = (new CompoundIndexDefinition(indexDefinition)).collation(Collation.of("en").strength(2));
+ this.mongoTemplate.indexOps(Device.class).ensureIndex(index);
+ }
+
+ collection = this.getCollection(DeviceLicense.class);
+ indexes = collection.listIndexes();
+ indexDefinition = indexes.iterator();
+
+ while(indexDefinition.hasNext()) {
+ Document index = (Document)indexDefinition.next();
+ Document keys = (Document)index.get("key", Document.class);
+ if (keys.size() == 1 && keys.containsKey("plan")) {
+ collection.dropIndex(index.getString("name"));
+ }
+ }
+
+ }
+
+ private void updateScheme() {
+ if (this.mongoTemplate.collectionExists("siteReport")) {
+ MongoCollection collection = this.mongoTemplate.getCollection("siteReport");
+ if (this.mongoTemplate.collectionExists(SiteFile.class)) {
+ collection.drop();
+ } else {
+ MongoNamespace nameSpace = collection.getNamespace();
+ collection.renameCollection(new MongoNamespace(nameSpace.getDatabaseName(), "siteFile"));
+ }
+ }
+
+ boolean isStandalone = this.isStandalone();
+ if (this.getDbScheme() < 20092901L) {
+ Query query = Query.query(Criteria.where("profile.tel").exists(true));
+ Update update = new Update();
+ update.rename("profile.tel", "profile.phone");
+ this.mongoTemplate.updateMulti(query, update, User.class);
+ this.mongoTemplate.updateMulti(query, update, Site.class);
+ this.mongoTemplate.updateMulti(new Query(Criteria.where("isLite").exists(true)), (new Update()).unset("isLite"), "site");
+ this.mongoTemplate.updateMulti(new Query(Criteria.where("isMust").exists(true)), (new Update()).unset("isMust"), "site");
+ this.mongoTemplate.updateMulti(new Query(Criteria.where("isReseller").exists(true)), (new Update()).unset("isReseller"), "site");
+ if (isStandalone) {
+ this.mongoTemplate.updateMulti(new Query(), Update.update("profile.model", "midm"), Site.class);
+ }
+
+ query = Query.query(Criteria.where("profile.owner.tel").exists(true));
+ update = new Update();
+ update.rename("profile.owner.tel", "profile.owner.phone");
+ this.mongoTemplate.updateMulti(query, update, Device.class);
+ }
+
+ if (this.getDbScheme() < 22111002L) {
+ if (this.mongoTemplate.collectionExists("user")) {
+ Query query = Query.query(Criteria.where("settings.report").exists(true));
+ Update update = (new Update()).unset("settings.report");
+ this.mongoTemplate.updateMulti(query, update, User.class);
+ }
+
+ Query query = Query.query((new Criteria()).orOperator(new Criteria[]{Criteria.where("scope.group").type(new JsonSchemaObject.Type[]{Type.STRING}), Criteria.where("apps.install.uuid").type(new JsonSchemaObject.Type[]{Type.STRING}), Criteria.where("apps.install.0").type(new JsonSchemaObject.Type[]{Type.STRING})}));
+ query.fields().include(new String[]{"scope.group", "apps.install"});
+ List profiles = this.mongoTemplate.find(query, Document.class, "deviceProfile");
+ if (profiles != null && !profiles.isEmpty()) {
+ java.lang.reflect.Type installAppType = (new TypeToken() {
+ }).getType();
+ profiles.forEach((profile) -> {
+ Update update = new Update();
+ Object _id = profile.get("_id");
+ Document scopeObj = (Document)profile.get("scope");
+ if (scopeObj != null) {
+ List