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
This commit is contained in:
rick committed 2026-11-16 17:28:23 +08:00
1 parent 9d7e42eda8
commit 10aa1829f5
346 files changed
+42404 -622

No files matched your search

+57 -8
View File
@@ -130,23 +130,72 @@ iot_m/
## 🚀 本地快速启动
### 1. 环境准备
- **JDK**:OpenJDK 11 或更高
- **构建工具**:Apache Maven 3.6+
- **数据库**:MongoDB 4.x+(本地启动或使用 Docker 容器)
### 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. 配置与启动
检查 `src/main/resources/application.properties`,确认 MongoDB 连接配置后执行:
```bash
### 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
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)。