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.
22 lines
1.4 KiB
Markdown
22 lines
1.4 KiB
Markdown
# 08 `maven-cwos-common-aks` + `maven-cwos-device-authentication` — 阿里巴巴规范走查（整理版）
|
||
|
||
**范围**：两工程合计约 **17 + 29** 个 `*.java`；均为 **Feign/接口与 DTO**，无业务实现。
|
||
|
||
## 主要发现
|
||
|
||
| 级别 | 说明 |
|
||
|------|------|
|
||
| **强制** | 鉴权相关接口使用 **`JSONObject` 作入参**（`AksAuthService`、`ApiSecretService` 等），类型约束弱，不符合「优先强类型 DTO」。 |
|
||
| **强制** | 包路径 **`.../authetication/...`** 拼写错误（应为 `authentication`），影响检索与协作。 |
|
||
| **推荐** | 根 `pom`：**Spring Boot 2.1.18**、**Java 8**、**fastjson 1.2.83** — 需持续安全与维护评估。 |
|
||
| **推荐** | `CloudwalkDeviceAuthResult` 等同时使用 **`@JsonProperty` 与 `@JSONField`**，双 JSON 栈需团队约定。 |
|
||
| **推荐** | 大量 **>120 列** 行、**行尾空白**、形参 **`paramXxx`** 反编译痕迹 — 建议 EditorConfig + 一次性格式化。 |
|
||
| **推荐** | 常量工具类未 **`private` 构造**防误实例化（`AksConstant` 等）。 |
|
||
| **正向** | 未发现 `System.out`、`printStackTrace`、空 `catch`、`TODO/FIXME`（启发式）。 |
|
||
|
||
## 建议优先级
|
||
|
||
1. 修正 **包名拼写**（或文档声明永久别名与序列化兼容策略）。
|
||
2. 将 **`JSONObject` 入参** 渐进替换为 **强类型 DTO**。
|
||
3. 统一 **JSON 单栈** 与 **行宽/空白** 规约。
|