mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 08:20:31 +08:00
hpd840321
7b2bd307f1
- backend/: 13 Maven modules (cw-elevator-application, cloudwalk-cloud, intelligent-cwoscomponent, ninca-crk, etc.) - frontend/: 4 Vue projects (elevator-front, cwos-portal, alarm-front, front_acs) + decompiled + scripts - scripts/: build, test-env, tools (Docker Compose, service templates, API parity) - docs/: AGENTS.md, superpowers specs, architecture docs - .gitignore: standard Java/Maven exclusions Moved from legacy maven-*/ root layout to backend/ organized structure.
19 lines
1.2 KiB
Markdown
19 lines
1.2 KiB
Markdown
# 03 `maven-cloudwalk-device-sdk` — 阿里巴巴规范走查（整理版）
|
||
|
||
**范围**：`maven-cloudwalk-device-sdk/**/*.java`（排除 `target/`），约 **162** 个文件。
|
||
|
||
## 主要发现
|
||
|
||
| 类别 | 说明 |
|
||
|------|------|
|
||
| **序列化** | 大量 `implements Serializable` 的 DTO/Param **未声明 `serialVersionUID`**（约数十个文件）；内部静态类序列化缺独立 UID。 |
|
||
| **命名** | `NotifyUploadPanoramamResult`（Panorama）、`FaceRegistionParam`（Registration）等拼写疑点；内部类名 `deviceData`、`helmetsData` 等小写开头不符合类型 UpperCamelCase。 |
|
||
| **格式** | 部分文件 `package` 与类型声明间**大段空行**；若仍残留 `/* N */` 行号注释，应继续跑 `scripts/strip_jdcore_java_noise.py`。 |
|
||
| **启发式** | 与 `00-heuristic-scan.md` 一致：`DeviceV2CommonBaseDTO` 等存在**行尾空白**；未见 `System.out`、空 catch。 |
|
||
|
||
## 建议优先级
|
||
|
||
1. 为对外 DTO 统一 **`serialVersionUID`** 策略（或评估 Protobuf/JSON 单一序列化路径）。
|
||
2. 修正对外可见的**拼写错误**类名时评估协议兼容（`@JSONField` 别名等）。
|
||
3. IDE **格式化** + 去除反编译行号噪声。
|