docs(v0.11): 纳入阿里巴巴 Java 走查索引与分模块报告（2026-04-24）

Made-with: Cursor
2026-06-12 01:40:30 +08:00 · 2026-04-24 23:49:37 +08:00
parent b6e8442479
commit bf20a13c96
13 changed files with 2900 additions and 0 deletions
@@ -0,0 +1,20 @@
+# 07 `maven-cwos-resource` — 阿里巴巴规范走查（整理版）
+
+**范围**：约 **494** 个 `*.java`；含 `cwos-java-sdk-resource`、portal/resource 接口与桩。
+
+## 主要发现
+
+| 严重度 | 说明 |
+|--------|------|
+| **高** | `RestPortalUserServiceImpl` 等大量方法 **`return null`** 且部分**未** `@Deprecated`，登录/改密等路径易导致调用方 **NPE 或静默失败**。 |
+| **高** | `getDefaultPwd()` 返回 **null** 与「默认密码」语义矛盾。 |
+| **中** | `ResourceClient` 在**字段初始化**中 `SpringContext.getBean`，容器时序与单测风险。 |
+| **中** | `*Delt*`、`Resrouce`、`BacK` 等命名拼写与可读性问题。 |
+| **低** | `apidoc` 下大量**空 Controller 壳**；需文档说明为 OpenAPI 占位。 |
+| **正向** | 未发现 `System.out` / `printStackTrace`；空 `catch` 启发式未命中。 |
+
+## 建议
+
+1. 对「桩实现」统一 **`@Deprecated` + 明确失败结果`**，禁止静默 `null`。  
+2. 收敛 **`ResourceClient` 初始化时机**（`@PostConstruct` / 懒工厂）。  
+3. 全模块 **格式化** + 建立 **错误码/校验 message** 常量表。