docs(v0.11): 同步 Maven 聚合说明与本地编译文档

Made-with: Cursor

docs/architecture/Maven工作区子工程版本一览.md

@@ -1,6 +1,6 @@
 # Maven 工作区子工程版本一览
 
-> **范围**：`/media/zebra/9e8fa357-7db6-4d70-88ed-d5de5a059a663/星河湾星中星/反编译` 下全部 `pom.xml`（共 **5** 个聚合工程、**17** 个 `pom.xml` 文件）。  
+> **范围**：`/media/zebra/9e8fa357-7db6-4d70-88ed-d5de5a059a663/星河湾星中星/反编译` 下 `maven-*` 目录内全部 `pom.xml`（**主聚合工程 5 个 + 补充反应堆 7 个**，合计 **44** 个 `pom.xml` 文件）。  
 > **说明**：子模块未单独声明 `<version>` 时，与**反应堆（reactor）父 POM** 的 `<version>` 一致。  
 > **生成方式**：走查各 `pom.xml` 的 `parent`、`groupId`、`artifactId`、`version`、`properties` 关键项。  
 > **版本演进（主版本升级）**：相对历史反编译/私服线，本工作区工程坐标已整体抬升主版本号以便区分 —— 电梯 **2.0-SNAPSHOT**、intelligent **3.0.0-xinghewan**、cloudwalk-cloud **4.0.0-Brussels-SRX**、ninca-crk **2.0.0**、ninca-qk-alarm **1.0.0-SNAPSHOT**；`cloudwalk.internal.version` 与 intelligent 依赖属性已同步。
@@ -9,6 +9,8 @@
 
 ## 1. 聚合工程总表
 
+### 1.1 主链（业务五工程）
+
 | 工程目录 | 反应堆 `groupId` | 反应堆 `artifactId` | **工程版本** | **Spring Boot parent** | Spring Cloud（属性） |
 |----------|------------------|----------------------|--------------|------------------------|----------------------|
 | `maven-cw-elevator-application/` | `cn.cloudwalk.elevator` | `cw-elevator-application-reactor` | **`2.0-SNAPSHOT`** | `2.1.18.RELEASE` | 见反应堆 `pom.xml`（与 Boot 2.1 栈配套） |
@@ -17,6 +19,18 @@
 | `maven-ninca-crk/` | `cn.cloudwalk.ninca` | `ninca-crk-reactor` | **`2.0.0`** | **`1.5.22.RELEASE`** | **`Edgware.SR6`** |
 | `maven-ninca-qk-alarm/` | `cn.cloudwalk.ninca` | `ninca-qk-alarm-reactor` | **`1.0.0-SNAPSHOT`** | `2.1.18.RELEASE` | （反应堆未统一声明 spring-cloud BOM，以依赖为准） |
 
+### 1.2 补充反应堆（私服缺父 POM 时本地 install）
+
+| 工程目录 | 反应堆 / 父 `artifactId` | 版本 | 说明 |
+|----------|---------------------------|------|------|
+| `maven-cloudwalk-device-sdk/` | `cloudwalk-device-sdk`（`cn.cloudwalk`） | **`2.2.0`** | 子模块 **`cloudwalk-device-sdk-protocol-entity`**；与 intelligent 中 **`cloudwalk.device.sdk.version`** 一致。 |
+| `maven-cloudwalk-device-manager/` | `cloudwalk-device-manager`（`cn.cloudwalk.cloud`） | **`2.0.2`** | 子模块 **`cloudwalk-device-manager-common`**、**`cloudwalk-device-manager-interface`**；依赖 **`cloudwalk-common-result:3.7.2-Brussels-SRX`**（须先 **`maven-cloudwalk-legacy-public`**）。 |
+| `maven-cloudwalk-legacy-public/` | `cloudwalk-legacy-public-reactor`（`cn.cloudwalk.cloud`） | **`1.0.0-SNAPSHOT`** | 安装 **`cloudwalk-cloud-common:3.7.2-Brussels-SRX`**、**`cloudwalk-common-result`/`web`/`serial`**、**`cwos-sdk-event:1.5.0-SNAPSHOT`**、**`cloudwalk-intelligent-component-lock:1.1.1-SNAPSHOT`**；源码来自 **`反1/*.jar.src.zip`**。 |
+| `maven-cwos-resource/` | `cwos-resource-reactor`（`cn.cloudwalk.cloud`） | **`1.0.0-SNAPSHOT`** | 含 **`cwos-component-resource`**、**`cwos-portal`** 父 POM、**`cwos-java-sdk-resource`**、**`cwos-device-pkg-stub`** 等；与电梯 **`cwos.sdk.resource.version`** 对齐。 |
+| `maven-cloudwalk-intelligent-davinci-manager/` | `cloudwalk-intelligent-davinci-manager`（`cn.cloudwalk.intelligent`） | **`1.1.7-SNAPSHOT`** | 子模块 **`davinci-manager-common`**、**`davinci-manager-storage`**；与电梯 **`davinci.manager.storage.version`** 一致。 |
+| `maven-cwos-common-aks/` | **`cwos-common-aks`**（`cn.cloudwalk.cloud`） | **`1.0.0-SNAPSHOT`** | 子模块 **`cwos-common-aks-interface`**；与 **`cw_lib`** / **`反1`** 对齐；须先 **`maven-cloudwalk-legacy-public`**（**`cloudwalk-common-result`**）。 |
+| `maven-cwos-device-authentication/` | **`cwos-device-authentication`**（`cn.cloudwalk.cloud`） | **`1.0.0-SNAPSHOT`** | 子模块 **`cwos-device-authentication-interface`**；依赖 **device-sdk**、**device-manager**、**`maven-cloudwalk-cloud`**（**`cloudwalk-common-service`**）、**`cwos-common-aks-interface`**；须在 **`maven-cwos-common-aks`** 与 **`maven-cloudwalk-cloud`** 之后 install。 |
+
 ---
 
 ## 2. 按工程展开：子模块坐标与版本
@@ -83,24 +97,143 @@
 
 ---
 
+### 2.6 `maven-cloudwalk-device-sdk`（设备 SDK 父链）
+
+| 模块路径 | `artifactId` | 版本 | 父 POM |
+|----------|----------------|------|--------|
+| 根 | `cloudwalk-device-sdk` | **2.2.0** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `cloudwalk-device-sdk-protocol-entity/` | `cloudwalk-device-sdk-protocol-entity` | **2.2.0**（继承） | `cloudwalk-device-sdk`（`../pom.xml`） |
+
+---
+
+### 2.6b `maven-cloudwalk-device-manager`（设备管理 common / interface）
+
+| 模块路径 | `artifactId` | 版本 | 父 POM |
+|----------|----------------|------|--------|
+| 根 | `cloudwalk-device-manager` | **2.0.2** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `cloudwalk-device-manager-common/` | `cloudwalk-device-manager-common` | **2.0.2**（继承） | `cloudwalk-device-manager`（`../pom.xml`） |
+| `cloudwalk-device-manager-interface/` | `cloudwalk-device-manager-interface` | **2.0.2**（继承） | `cloudwalk-device-manager`（`../pom.xml`） |
+
+**反应堆内常用属性（节选）**：`cloudwalk.common.result.version` **3.7.2-Brussels-SRX**（与 **`maven-cloudwalk-legacy-public`** 中 **`cloudwalk-common-result`** 一致）。
+
+---
+
+### 2.7 `maven-cwos-resource`（CWOS 资源 / 门户 / SDK）
+
+| 模块路径 | `artifactId` | 版本 | 父 POM |
+|----------|----------------|------|--------|
+| 根 | `cwos-resource-reactor` | **1.0.0-SNAPSHOT** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `cwos-component-resource/` | `cwos-component-resource` | **1.0.0-SNAPSHOT** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `cwos-component-resource-data/` | `cwos-component-resource-data` | **1.0.0-SNAPSHOT**（继承） | `cwos-component-resource` |
+| `cwos-component-resource-interface/` | `cwos-component-resource-interface` | **1.0.0-SNAPSHOT**（继承） | `cwos-component-resource` |
+| `cwos-device-pkg-stub/` | `cwos-device-pkg-stub` | **1.0.0-SNAPSHOT**（继承） | `cwos-resource-reactor` |
+| `cwos-portal/` | `cwos-portal` | **1.0.0-SNAPSHOT** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `cwos-portal-interface/` | `cwos-portal-interface` | **1.0.0-SNAPSHOT**（继承） | `cwos-portal` |
+| `cwos-java-sdk-resource/` | `cwos-java-sdk-resource` | **1.0.0-SNAPSHOT**（继承） | `cwos-resource-reactor` |
+
+**反应堆内常用属性（节选）**：`spring-cloud.version` **Greenwich.SR6**；`cloudwalk.legacy.public.version` **3.7.2-Brussels-SRX**；`mybatis.version` **3.5.6**。
+
+---
+
+### 2.8 `maven-cloudwalk-intelligent-davinci-manager`（Davinci 存储）
+
+| 模块路径 | `artifactId` | 版本 | 父 POM |
+|----------|----------------|------|--------|
+| 根 | `cloudwalk-intelligent-davinci-manager` | **1.1.7-SNAPSHOT** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `davinci-manager-common/` | `davinci-manager-common` | **1.1.7-SNAPSHOT**（继承） | `cloudwalk-intelligent-davinci-manager`（`../pom.xml`） |
+| `davinci-manager-storage/` | `davinci-manager-storage` | **1.1.7-SNAPSHOT**（继承） | `cloudwalk-intelligent-davinci-manager`（`../pom.xml`） |
+
+**反应堆内常用属性（节选）**：`spring-cloud.version` **Greenwich.SR6**；`feign-form.version` **3.0.3**；`commons-io.version` **2.5**。
+
+---
+
+### 2.9 `maven-cloudwalk-legacy-public`（反1 公共线）
+
+| 模块路径 | `artifactId` | 版本 | 父 POM |
+|----------|----------------|------|--------|
+| 根 | `cloudwalk-legacy-public-reactor` | **1.0.0-SNAPSHOT** | （无 Spring parent，聚合 `pom`） |
+| `cloudwalk-cloud-common/` | `cloudwalk-cloud-common` | **3.7.2-Brussels-SRX** | `spring-boot-starter-parent` **1.5.22.RELEASE** |
+| `cloudwalk-common-result/` | `cloudwalk-common-result` | **3.7.2-Brussels-SRX**（继承） | `cloudwalk-cloud-common` |
+| `cloudwalk-common-web/` | `cloudwalk-common-web` | **3.7.2-Brussels-SRX**（继承） | `cloudwalk-cloud-common` |
+| `cloudwalk-common-serial/` | `cloudwalk-common-serial` | **3.7.2-Brussels-SRX**（继承） | `cloudwalk-cloud-common` |
+| `cwos-sdk-event/` | `cwos-sdk-event` | **1.5.0-SNAPSHOT** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `cloudwalk-intelligent-component-lock/` | `cloudwalk-intelligent-component-lock` | **1.1.1-SNAPSHOT** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+
+---
+
+### 2.10 `maven-cwos-common-aks`（AKS 公共接口）
+
+| 模块路径 | `artifactId` | 版本 | 父 POM |
+|----------|----------------|------|--------|
+| 根 | `cwos-common-aks` | **1.0.0-SNAPSHOT** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `cwos-common-aks-interface/` | `cwos-common-aks-interface` | **1.0.0-SNAPSHOT**（继承） | `cwos-common-aks`（`../pom.xml`） |
+
+**反应堆内常用属性（节选）**：`cloudwalk.legacy.public.version` **3.7.2-Brussels-SRX**；`fastjson.version` **1.2.83**。
+
+---
+
+### 2.11 `maven-cwos-device-authentication`（设备认证 interface）
+
+| 模块路径 | `artifactId` | 版本 | 父 POM |
+|----------|----------------|------|--------|
+| 根 | `cwos-device-authentication` | **1.0.0-SNAPSHOT** | `spring-boot-starter-parent` **2.1.18.RELEASE** |
+| `cwos-device-authentication-interface/` | `cwos-device-authentication-interface` | **1.0.0-SNAPSHOT**（继承） | `cwos-device-authentication`（`../pom.xml`） |
+
+**反应堆内常用属性（节选）**：`cloudwalk-common.version` **3.7.2-Brussels-SRX**；`cloudwalk-device.version` **2.0.2**；`cloudwalk-aks.version` **1.0.0-SNAPSHOT**；`cloudwalk.device.sdk.version` **2.2.0**；`fastjson.version` **1.2.83**。
+
+---
+
 ## 3. 跨工程对齐关系（便于联调）
 
 | 概念 | 常见取值 | 出现在 |
 |------|----------|--------|
 | 云从内部线版本 | **4.0.0-Brussels-SRX** | 电梯、intelligent、cloudwalk-cloud、ninca-crk、ninca-qk-alarm 的 `cloudwalk.internal.version` 等 |
 | intelligent 组件线 | **3.0.0-xinghewan** | intelligent 反应堆；电梯 `intelligent.cwoscomponent.version`；ninca-crk `intelligent.cwoscomponent.rest.version` |
+| 设备 SDK 协议实体 | **2.2.0** | intelligent `cloudwalk.device.sdk.version`；**`maven-cloudwalk-device-sdk`** 反应堆版本 |
+| 设备管理 common/interface | **2.0.2** | **`maven-cloudwalk-device-manager`**；依赖 **`cloudwalk-common-result` 3.7.2**（**`maven-cloudwalk-legacy-public`**） |
+| AKS / 设备认证 interface | **1.0.0-SNAPSHOT** | **`maven-cwos-common-aks`**（**`cwos-common-aks-interface`**）、**`maven-cwos-device-authentication`**（**`cwos-device-authentication-interface`**）；与 **`cw_lib`** 同名 JAR 对齐；**device-authentication** 另依赖 **`cloudwalk-common-service`**（**`maven-cloudwalk-cloud`**）、**device-manager-interface**、**protocol-entity** |
+| CWOS Java SDK 资源 | **1.0.0-SNAPSHOT** | 电梯 `cwos.sdk.resource.version`；**`maven-cwos-resource`** 中 **`cwos-java-sdk-resource`** 等 |
+| Davinci 存储 | **1.1.7-SNAPSHOT** | 电梯 `davinci.manager.storage.version`；**`maven-cloudwalk-intelligent-davinci-manager`** 中 **`davinci-manager-storage`** |
+| 反1 公共线（legacy） | **3.7.2 / 1.5.0-SNAPSHOT / 1.1.1-SNAPSHOT** | **`maven-cloudwalk-legacy-public`**：`common-result`/`web`/`serial`、`cwos-sdk-event`、`component-lock`；与 **`cloudwalk.legacy.public.version`**、**`cwos.sdk.event.version`**、**`intelligent.lock.version`** 对齐 |
 | Spring Boot 主线 | **2.1.18.RELEASE** | 电梯、intelligent、cloudwalk-cloud、ninca-qk-alarm |
 | Spring Boot 旧线 | **1.5.22.RELEASE** | **仅 ninca-crk** |
 
 ---
 
-## 4. `pom.xml` 物理路径清单（17）
+## 4. `pom.xml` 物理路径清单（44）
 
 ```
 maven-cloudwalk-cloud/pom.xml
 maven-cloudwalk-cloud/cloudwalk-cloud-common/pom.xml
 maven-cloudwalk-cloud/cloudwalk-common-event/pom.xml
 maven-cloudwalk-cloud/cloudwalk-common-service/pom.xml
+maven-cloudwalk-device-sdk/pom.xml
+maven-cloudwalk-device-sdk/cloudwalk-device-sdk-protocol-entity/pom.xml
+maven-cloudwalk-device-manager/pom.xml
+maven-cloudwalk-device-manager/cloudwalk-device-manager-common/pom.xml
+maven-cloudwalk-device-manager/cloudwalk-device-manager-interface/pom.xml
+maven-cloudwalk-legacy-public/pom.xml
+maven-cloudwalk-legacy-public/cloudwalk-cloud-common/pom.xml
+maven-cloudwalk-legacy-public/cloudwalk-common-result/pom.xml
+maven-cloudwalk-legacy-public/cloudwalk-common-web/pom.xml
+maven-cloudwalk-legacy-public/cloudwalk-common-serial/pom.xml
+maven-cloudwalk-legacy-public/cwos-sdk-event/pom.xml
+maven-cloudwalk-legacy-public/cloudwalk-intelligent-component-lock/pom.xml
+maven-cloudwalk-intelligent-davinci-manager/pom.xml
+maven-cloudwalk-intelligent-davinci-manager/davinci-manager-common/pom.xml
+maven-cloudwalk-intelligent-davinci-manager/davinci-manager-storage/pom.xml
+maven-cwos-resource/pom.xml
+maven-cwos-resource/cwos-component-resource/pom.xml
+maven-cwos-resource/cwos-component-resource-data/pom.xml
+maven-cwos-resource/cwos-component-resource-interface/pom.xml
+maven-cwos-resource/cwos-device-pkg-stub/pom.xml
+maven-cwos-resource/cwos-portal/pom.xml
+maven-cwos-resource/cwos-portal-interface/pom.xml
+maven-cwos-resource/cwos-java-sdk-resource/pom.xml
+maven-cwos-common-aks/pom.xml
+maven-cwos-common-aks/cwos-common-aks-interface/pom.xml
+maven-cwos-device-authentication/pom.xml
+maven-cwos-device-authentication/cwos-device-authentication-interface/pom.xml
 maven-cw-elevator-application/pom.xml
 maven-cw-elevator-application/cw-elevator-application-common/pom.xml
 maven-cw-elevator-application/cw-elevator-application-data/pom.xml
@@ -133,6 +266,12 @@ maven-ninca-qk-alarm/ninca-qk-alarm-app-starter/pom.xml
 | 2026-04-24 | 初稿：工作区 `pom` 走查 |
 | 2026-04-24 | **主版本升级**（与历史反编译/私服坐标区分）：电梯 **2.0-SNAPSHOT**、intelligent **3.0.0-xinghewan**、cloudwalk-cloud **4.0.0-Brussels-SRX**、ninca-crk **2.0.0**、ninca-qk-alarm **1.0.0-SNAPSHOT**；`cloudwalk.internal.version`、电梯与 ninca-crk 中 intelligent 属性已对齐 |
 | 2026-04-24 | **`cloudwalk.legacy.public.version`（3.7.2-Brussels-SRX）**：私服未发布新主版本的 `cloudwalk-common-result` / `web` / `serial` 时，与反应堆 **4.0.0** 解耦；本地编译说明见 [docs/build/本地编译说明.md](../build/本地编译说明.md) |
+| 2026-04-24 | 补充反应堆 **`maven-cloudwalk-device-sdk`**（`cloudwalk-device-sdk` **2.2.0**）、**`maven-cwos-resource`**（CWOS 资源/门户/SDK）；`pom` 总数 **17 → 27**；编译顺序见 [本地编译说明.md](../build/本地编译说明.md) §3 |
+| 2026-04-24 | 补充反应堆 **`maven-cloudwalk-intelligent-davinci-manager`**（**`cloudwalk-intelligent-davinci-manager` 1.1.7-SNAPSHOT**、`davinci-manager-common`、`davinci-manager-storage`）；`pom` 总数 **27 → 30**；编译顺序见 [本地编译说明.md](../build/本地编译说明.md) §3 |
+| 2026-04-24 | 补充反应堆 **`maven-cloudwalk-legacy-public`**（**`反1`**：`cloudwalk-cloud-common` **3.7.2**、`common-result`/`web`/`serial`、**`cwos-sdk-event`**、**`component-lock`**）；`pom` 总数 **30 → 37**；须在 **`maven-cloudwalk-cloud`** 之前 install；见 [本地编译说明.md](../build/本地编译说明.md) §3 |
+| 2026-04-24 | 补充反应堆 **`maven-cloudwalk-device-manager`**（**`cloudwalk-device-manager` 2.0.2**、**common**、**interface**；**`反1`** zip）；`pom` 总数 **37 → 40**；须在 **`maven-cloudwalk-legacy-public`** 之后 install；见 [本地编译说明.md](../build/本地编译说明.md) §3 |
+| 2026-04-24 | 补充反应堆 **`maven-cwos-common-aks`**、**`maven-cwos-device-authentication`**（**`反1`**：`cwos-common-aks-interface`、`cwos-device-authentication-interface`）；`pom` 总数 **40 → 44**；**device-authentication** 须在 **`maven-cloudwalk-cloud`** 与 **`maven-cwos-common-aks`** 之后 install；见 [本地编译说明.md](../build/本地编译说明.md) §3 |
+| 2026-04-24 | **`intelligent-cwoscomponent-rest`**：`FeignClient` 由 **`org.springframework.cloud.netflix.feign`** 改为 **`org.springframework.cloud.openfeign`**，与 **Greenwich + `spring-cloud-starter-openfeign`** 一致 |
 
 ---
 

docs/architecture/Maven聚合工程说明.md

@@ -1,7 +1,7 @@
 # Maven 聚合工程说明（starRiverProperty）
 
-> **适用范围**：本仓库根目录下五个以 `maven-` 为前缀的 **Maven Reactor（聚合父工程）**，用于本地编译、走查与增量修改。  
-> **不适用范围**：各工程依赖的大量 **NINCA / 云从内部 JAR** 仍须通过 Nexus 等私服解析，本文仅描述**本仓库内可见的模块边界与协作关系**。
+> **适用范围**：本仓库根目录下以 `maven-` 为前缀的 **Maven Reactor**：其中 **五个** 为主业务聚合工程；另有 **七个** 补充反应堆（`maven-cloudwalk-device-sdk`、`maven-cloudwalk-device-manager`、`maven-cwos-resource`、`maven-cloudwalk-intelligent-davinci-manager`、**`maven-cloudwalk-legacy-public`**、**`maven-cwos-common-aks`**、**`maven-cwos-device-authentication`**）用于在私服缺父 POM 或缺历史公共 JAR 时 **本地 `install` 闭合** `cloudwalk-device-sdk`、`cloudwalk-device-manager`、`cwos-component-resource`、`cwos-portal`、`cwos-java-sdk-resource`、**`cloudwalk-intelligent-davinci-manager` / `davinci-manager-storage`**、**`cloudwalk-common-result` / `web` / `serial`（3.7.2）**、**`cwos-sdk-event`**、**`cloudwalk-intelligent-component-lock`**、**`cwos-common-aks` / `cwos-device-authentication`** 等坐标（**`反1/`** 下对应 `*.jar.src.zip` 已接入各反应堆）。  
+> **不适用范围**：各工程依赖的 **NINCA / 云从内部** 等大量 JAR 仍多须 Nexus 解析；本文描述**本仓库内可见的模块边界与协作关系**，补充反应堆仅覆盖文档化缺口中的一段。
 
 ---
 
@@ -13,7 +13,9 @@
 
 ---
 
-## 2. 五工程一览
+## 2. 工程一览
+
+### 2.1 主业务五工程
 
 | 仓库目录 | 聚合 artifactId（父 POM） | `groupId` | 版本（父 POM） | 子模块（`modules`） |
 |----------|---------------------------|-----------|----------------|----------------------|
@@ -23,6 +25,18 @@
 | `maven-ninca-crk/` | `ninca-crk-reactor` | `cn.cloudwalk.ninca` | `2.0.0` | `ninca-crk-gpu-std` |
 | `maven-ninca-qk-alarm/` | `ninca-qk-alarm-reactor` | `cn.cloudwalk.ninca` | `1.0.0-SNAPSHOT` | `ninca-qk-alarm-app-starter`（其下再含 web / interface 等子模块） |
 
+### 2.2 补充反应堆（编译链）
+
+| 仓库目录 | 说明 |
+|----------|------|
+| `maven-cloudwalk-device-sdk/` | 安装 **`cn.cloudwalk:cloudwalk-device-sdk:2.2.0`**（`pom`）与 **`cloudwalk-device-sdk-protocol-entity`**，供 **`maven-intelligent-cwoscomponent`** 解析 `protocol-entity` 描述符。 |
+| `maven-cloudwalk-device-manager/` | 安装 **`cn.cloudwalk.cloud:cloudwalk-device-manager:2.0.2`**（`pom`）及 **`cloudwalk-device-manager-common`**、**`cloudwalk-device-manager-interface`**；依赖 **`cloudwalk-common-result:3.7.2-Brussels-SRX`**（须先 **`maven-cloudwalk-legacy-public`** `install`）。 |
+| `maven-cwos-resource/` | 安装 **`cwos-component-resource`**、**`cwos-portal`** 父 POM 及 **`cwos-java-sdk-resource`** 等，供 **`cw-elevator-application-service`** 解析 `cwos-java-sdk-resource` 的传递父链。`cwos-portal-interface` 为 **裁剪 + 占位** 以闭合 SDK，详见 [本地编译说明.md](../build/本地编译说明.md) §3。 |
+| `maven-cloudwalk-intelligent-davinci-manager/` | 安装 **`cn.cloudwalk.intelligent:cloudwalk-intelligent-davinci-manager:1.1.7-SNAPSHOT`**（父 `pom`）及 **`davinci-manager-common`**、**`davinci-manager-storage`**，供电梯 **`cw-elevator-application-service`** 解析 **`davinci-manager-storage`**（`davinci.manager.storage.version`）。源码基底来自历史 **1.1.5** 反编译 zip，与 V1 运行包 **1.1.7-SNAPSHOT** 坐标一致；**`SpringMvcContract` / `FeignClientsConfiguration`** 与 **Greenwich + OpenFeign** 对齐。 |
+| `maven-cloudwalk-legacy-public/` | 安装 **`cn.cloudwalk.cloud:cloudwalk-cloud-common:3.7.2-Brussels-SRX`**（与 **`cloudwalk-common-result` / `web` / `serial`** 反编译 POM 的 parent 一致）、**`cwos-sdk-event:1.5.0-SNAPSHOT`**、**`cloudwalk-intelligent-component-lock:1.1.1-SNAPSHOT`**。源码自 **`反1/*.jar.src.zip`** 解压；**`cwos-sdk-event`** 已替换 **`reflections-maven`** 为 **`org.reflections:reflections`**，并修正 **`KafkaConsumer#setListenerClass`** / **`EventClient`** 的编译问题。 |
+| `maven-cwos-common-aks/` | 安装 **`cn.cloudwalk.cloud:cwos-common-aks:1.0.0-SNAPSHOT`** 与 **`cwos-common-aks-interface`**；源码自 **`反1/cwos-common-aks-interface-1.0.0-SNAPSHOT.jar.src.zip`**；须先 **`maven-cloudwalk-legacy-public`**（**`cloudwalk-common-result`**）。 |
+| `maven-cwos-device-authentication/` | 安装 **`cn.cloudwalk.cloud:cwos-device-authentication:1.0.0-SNAPSHOT`** 与 **`cwos-device-authentication-interface`**；源码自 **`反1/cwos-device-authentication-interface-1.0.0-SNAPSHOT.jar.src.zip`**；依赖 **device-sdk**、**device-manager**、**`maven-cloudwalk-cloud`**（**`cloudwalk-common-service`**）、**`cwos-common-aks-interface`**，须在上述反应堆与 **`maven-cwos-common-aks`** 之后 **`install`**。 |
+
 > **版本说明**：上表为当前源码树反应堆版本（相对历史反编译/私服线已做**主版本号升级**，便于区分）。与 `cw-elevator-application-V1.0.0.20211103` 等**历史运行包内 JAR 文件名**不必一致，详见 `docs/build/ORIGINAL_BUILD_JDK.txt` 文首说明及 [Maven工作区子工程版本一览](Maven工作区子工程版本一览.md)。
 
 ---
@@ -131,17 +145,96 @@
 
 ---
 
+### 3.6 `maven-cloudwalk-device-sdk` — 设备 SDK 父 POM（协议实体）
+
+**定位**  
+私服常缺失 **`cn.cloudwalk:cloudwalk-device-sdk:2.2.0`** 父 `pom`，导致无法解析 **`cloudwalk-device-sdk-protocol-entity`**。本反应堆在本地 **`install`** 后，**`maven-intelligent-cwoscomponent`** 的 **`intelligent-cwoscomponent-interface`** 可正常解析该依赖。
+
+**子模块**  
+- **`cloudwalk-device-sdk-protocol-entity`**：源码来自 `反1` 反编译 zip，与运行包 **2.2.0** 坐标一致。
+
+---
+
+### 3.7 `maven-cwos-resource` — CWOS 资源 / 门户 / Java SDK
+
+**定位**  
+补齐 **`cwos-component-resource`**、**`cwos-portal`** 父 POM 及 **`cwos-java-sdk-resource`**，使 **`cw-elevator-application-service`** 不再因私服缺 **`cwos-component-resource:pom`**、**`cwos-portal:pom`** 而失败。
+
+**子模块要点**  
+- **`cwos-component-resource-data`** / **`cwos-component-resource-interface`**：反编译源码。  
+- **`cwos-portal-interface`**：为闭合 **`cwos-java-sdk-resource`** 的编译 classpath，已 **裁剪** 非 SDK 所需包，并含 **`cwos-device-pkg-stub`**（`DeviceUpgradeResult` 占位）。  
+- **`cwos-java-sdk-resource`**：Feign 注解由 **`org.springframework.cloud.netflix.feign.FeignClient`** 迁移为 **`org.springframework.cloud.openfeign.FeignClient`**，与 **Greenwich + `spring-cloud-starter-openfeign`** 一致；**`ResourceBeanConfig`** 补全缺失的 `import`。
+
+---
+
+### 3.8 `maven-cloudwalk-intelligent-davinci-manager` — Davinci 存储父链
+
+**定位**  
+私服常缺失 **`cn.cloudwalk.intelligent:cloudwalk-intelligent-davinci-manager:1.1.7-SNAPSHOT`** 父 `pom`，导致无法解析 **`davinci-manager-storage`**（电梯 **`cw-elevator-application-service`** 直接依赖）。本反应堆在本地 **`install`** 后，可闭合该父链。
+
+**子模块**  
+- **`davinci-manager-common`**：`DavinciResult`、`DavinciServiceException` 等。  
+- **`davinci-manager-storage`**：文件/分片上传 Feign 与 **`FileStorageManager` / `FilePartManager`** 实现；**`io.github.openfeign:feign-okhttp`** 替代原 POM 中的 **`com.netflix.feign:feign-okhttp`**，与 **Spring Cloud Greenwich** 管理的 OpenFeign 一致。
+
+---
+
+### 3.9 `maven-cloudwalk-legacy-public` — 反1 私服公共线（3.7.2 + cwos-sdk-event + lock）
+
+**定位**  
+将 **`反1/`** 内 **`cloudwalk-common-*-3.7.2-Brussels-SRX.jar.src.zip`**、**`cwos-sdk-event-1.5.0-SNAPSHOT.jar.src.zip`**、**`cloudwalk-intelligent-component-lock-1.1.1-SNAPSHOT.jar.src.zip`** 解压为 Maven 子模块并 **`install`**，闭合 **`cloudwalk.legacy.public.version`**、**`cwos.sdk.event.version`**、**`intelligent.lock.version`** 等横切依赖。
+
+**子模块要点**  
+- **`cloudwalk-cloud-common`**：**`3.7.2-Brussels-SRX`** 父 `pom`（继承 **Boot 1.5.22**）；与 **`maven-cloudwalk-cloud`** 中 **4.0.0** 的 stub **`cloudwalk-cloud-common`** 为**不同版本**，勿混用。  
+- **`cloudwalk-common-result`**：在反编译依赖外补 **Spring / Jackson / Joda / SLF4J / validation-api**。  
+- **`cwos-sdk-event`**：**`reflections-maven`** → **`org.reflections:reflections`**；**`KafkaConsumer`** 实现 **`Consumer#setListenerClass(Class)`**；**`EventClient`** 使用 **`commons-lang3.StringUtils`**。
+
+---
+
+### 3.10 `maven-cloudwalk-device-manager` — 设备管理 common / interface（2.0.2）
+
+**定位**  
+私服常缺失 **`cn.cloudwalk.cloud:cloudwalk-device-manager:2.0.2`** 父 `pom`，导致无法解析 **`cloudwalk-device-manager-common`**、**`cloudwalk-device-manager-interface`**。本反应堆在本地 **`install`** 后闭合该父链。
+
+**子模块**  
+- **`cloudwalk-device-manager-common`**、**`cloudwalk-device-manager-interface`**：源码来自 **`反1/`** 下 **`cloudwalk-device-manager-*-2.0.2.jar.src.zip`**。父 POM 将 **`cloudwalk-common-result`** 锁定为 **`3.7.2-Brussels-SRX`**（与 **`maven-cloudwalk-legacy-public`** 一致）；**`hibernate-validator`** 与 **Boot 2.1.18** 栈对齐（**6.0.22.Final**）。
+
+**与其它工程关系**  
+须在 **`maven-cloudwalk-legacy-public`** 成功 **`install`**（提供 **`cloudwalk-common-result:3.7.2`**）之后，再 **`install`** 本反应堆。
+
+---
+
+### 3.11 `maven-cwos-common-aks` / `maven-cwos-device-authentication` — AKS 与设备认证 interface（1.0.0-SNAPSHOT）
+
+**定位**  
+与 **`cw-elevator-application-V1.0.0.20211103/cw_lib`** 中 **`cwos-common-aks-interface`**、**`cwos-device-authentication-interface`** 同名坐标对齐；私服若缺 **`cwos-common-aks`**、**`cwos-device-authentication`** 父 POM，可在本地 **`install`** 闭合。
+
+**子模块**  
+- **`cwos-common-aks-interface`**、**`cwos-device-authentication-interface`**：源码来自 **`反1/`** 对应 **`*.jar.src.zip`**。  
+- **device-authentication** 的 **`pom`** 依赖 **`cloudwalk-common-service`**、**`cloudwalk-device-manager-interface`**、**`cwos-common-aks-interface`**、**`cloudwalk-device-sdk-protocol-entity`** 等，编译顺序见 [本地编译说明.md](../build/本地编译说明.md) §3。
+
+---
+
 ## 4. 工程间依赖与协作（简图）
 
 下列关系表示 **Maven 依赖 / 常见运行时调用方向**，非严格部署拓扑。
 
 ```mermaid
 flowchart LR
+  subgraph devsdk [maven-cloudwalk-device-sdk]
+    PE[protocol-entity]
+  end
+  subgraph cwos [maven-cwos-resource]
+    SDK[cwos-java-sdk-resource]
+  end
+  subgraph davinci [maven-cloudwalk-intelligent-davinci-manager]
+    DMS[davinci-manager-storage]
+  end
   subgraph cloud [maven-cloudwalk-cloud]
     CE[cloudwalk-common-event]
     CS[cloudwalk-common-service]
   end
   subgraph intel [maven-intelligent-cwoscomponent]
+    II[intelligent-cwoscomponent-interface]
     IR[intelligent-cwoscomponent-rest]
   end
   subgraph elev [maven-cw-elevator-application]
@@ -154,6 +247,10 @@ flowchart LR
   subgraph alarm [maven-ninca-qk-alarm]
     ST[ninca-qk-alarm-app-starter]
   end
+  PE --> II
+  II --> IR
+  SDK --> ES
+  DMS --> ES
   CE --> ES
   CS --> ES
   IR --> ES
@@ -165,6 +262,7 @@ flowchart LR
 
 **文字归纳**  
 
+- **`maven-cloudwalk-device-sdk`** 为 **`intelligent-cwoscomponent-interface`** 提供 **`cloudwalk-device-sdk-protocol-entity`**；**`maven-cwos-resource`** 为 **`cw-elevator-application-service`** 提供 **`cwos-java-sdk-resource`**（及 portal/resource 父链）；**`maven-cloudwalk-intelligent-davinci-manager`** 为 **`cw-elevator-application-service`** 提供 **`davinci-manager-storage`** 父链；**`maven-cloudwalk-legacy-public`** 为 **`cloudwalk-common-event`**、电梯 **common**、**`cwos-resource`** 等提供 **`cloudwalk-common-result`/`web`/`serial`（3.7.2）**、**`cwos-sdk-event`**、**`component-lock`**；**`maven-cloudwalk-device-manager`** 提供 **`cloudwalk-device-manager:2.0.2`** 及 **common/interface**（依赖前述 **`cloudwalk-common-result:3.7.2`**）；**`maven-cwos-common-aks`**、**`maven-cwos-device-authentication`** 与 **`cw_lib`** 中 AKS / 设备认证 **interface** 坐标对齐（详见 §3.11）。前序 **`install`** 顺序见 [本地编译说明.md](../build/本地编译说明.md) §3。  
 - **电梯应用** 依赖 **公共云模块** + **智能组件 REST**，对外暴露电梯 HTTP API；智能组件再通过 Feign 回调电梯、组织等。  
 - **CRK GPU 标准后端** 依赖公共事件、智能组件等，与考勤/访客等 **NINCA 模块** 打成一个可部署单元（具体以 `ninca-crk-gpu-std/pom.xml` 为准）。  
 - **告警应用** 相对独立，主要挂 **CloudWalk Web 公共栈**。
@@ -195,5 +293,5 @@ flowchart LR
 
 ## 7. 文档维护
 
-- 若新增第六个聚合工程，请在本表与各节补充 **目录、artifactId、modules、与其它工程的依赖边**。  
+- 若新增其它 `maven-*` 反应堆，请在本表与各节补充 **目录、artifactId、modules、与其它工程的依赖边**，并更新 [Maven工作区子工程版本一览](Maven工作区子工程版本一览.md) 与 [本地编译说明.md](../build/本地编译说明.md) §3。  
 - 若 Spring Boot / Cloud 版本升级，请以各 **`maven-*/pom.xml`** 为准同步更新本文「技术栈摘要」小节。

docs/build/本地编译说明.md

@@ -18,21 +18,79 @@ java -version   # 应显示 1.8.x
 
 ## 3. 推荐编译顺序（依赖链）
 
-在仓库根下按顺序 **install**（或至少 **compile** 前序模块并 install 到本地 `~/.m2`）：
+在仓库根下按顺序 **install**（或至少 **compile** 前序模块并 install 到本地仓库；若使用自定义 `settings.xml` 的 `localRepository`，构件会写入该路径）：
 
-1. **`maven-cloudwalk-cloud`**：`mvn -DskipTests clean install`  
-2. **`maven-intelligent-cwoscomponent`**：`mvn -DskipTests clean install`（依赖 cloudwalk 与私服 `cloudwalk-device-sdk` 等）  
-3. **`maven-cw-elevator-application`**：`mvn -DskipTests clean install`  
-4. 其余：`maven-ninca-crk`、`maven-ninca-qk-alarm` 按需单独编译。
+1. **`maven-cloudwalk-device-sdk`**：`mvn -DskipTests clean install` — 提供 **`cn.cloudwalk:cloudwalk-device-sdk:2.2.0`** 父 POM 与 **`cloudwalk-device-sdk-protocol-entity`**（替代私服缺失父工程）。  
+2. **`maven-cloudwalk-legacy-public`**：`mvn -DskipTests clean install` — 自 **`反1/*.jar.src.zip`** 提供 **`cloudwalk-cloud-common:3.7.2-Brussels-SRX`**、**`cloudwalk-common-result` / `web` / `serial`**、**`cwos-sdk-event:1.5.0-SNAPSHOT`**、**`cloudwalk-intelligent-component-lock:1.1.1-SNAPSHOT`**（闭合 **`cloudwalk.legacy.public.version`**、**`cwos.sdk.event`**、电梯 **lock** 等；**须在 `maven-cloudwalk-cloud` 之前**安装，以便 **`cloudwalk-common-event`** 解析 **`cwos-sdk-event`**）。  
+3. **`maven-cloudwalk-device-manager`**：`mvn -DskipTests clean install` — 自 **`反1/cloudwalk-device-manager-*-2.0.2.jar.src.zip`** 提供 **`cn.cloudwalk.cloud:cloudwalk-device-manager:2.0.2`** 父 POM 与 **`cloudwalk-device-manager-common`**、**`cloudwalk-device-manager-interface`**（依赖第 2 步的 **`cloudwalk-common-result`**；**须在依赖其 interface 的其它工程之前**安装）。  
+4. **`maven-cwos-resource`**：`mvn -DskipTests clean install` — 提供 **`cwos-component-resource`**、**`cwos-portal`** 父 POM 及 **`cwos-java-sdk-resource`** 等（替代私服缺失的 CWOS 资源/门户父链）。  
+5. **`maven-cloudwalk-intelligent-davinci-manager`**：`mvn -DskipTests clean install` — 提供 **`cn.cloudwalk.intelligent:cloudwalk-intelligent-davinci-manager:1.1.7-SNAPSHOT`** 父 POM 与 **`davinci-manager-common`**、**`davinci-manager-storage`**（替代私服缺失的 Davinci 父链；与电梯 **`davinci.manager.storage.version`** 对齐）。  
+6. **`maven-cloudwalk-cloud`**：`mvn -DskipTests clean install` — 提供 **`cloudwalk-common-event`**、**`cloudwalk-common-service`** 等（**`maven-cwos-device-authentication`** 依赖 **`cloudwalk-common-service`**，故 **aks / device-authentication 须排在本步之后**）。  
+7. **`maven-cwos-common-aks`**：`mvn -DskipTests clean install` — 自 **`反1/cwos-common-aks-interface-1.0.0-SNAPSHOT.jar.src.zip`** 提供 **`cn.cloudwalk.cloud:cwos-common-aks:1.0.0-SNAPSHOT`** 与 **`cwos-common-aks-interface`**（依赖第 2 步 **`cloudwalk-common-result`**）。  
+8. **`maven-cwos-device-authentication`**：`mvn -DskipTests clean install` — 自 **`反1/cwos-device-authentication-interface-1.0.0-SNAPSHOT.jar.src.zip`** 提供 **`cn.cloudwalk.cloud:cwos-device-authentication:1.0.0-SNAPSHOT`** 与 **`cwos-device-authentication-interface`**（依赖第 1、3、6、7 步及 **`cwos-common-aks-interface`**）。  
+9. **`maven-intelligent-cwoscomponent`**：`mvn -DskipTests clean install`（依赖第 1 步的 **protocol-entity** 与 cloudwalk 模块）  
+10. **`maven-cw-elevator-application`**：`mvn -DskipTests clean install`（`service` 若仍失败，多为其它私服构件或业务源码问题，见下文）  
+11. 其余：`maven-ninca-crk`、`maven-ninca-qk-alarm` 按需单独编译。
 
 单工程示例：
 
 ```bash
-cd maven-cloudwalk-cloud && mvn -DskipTests clean install
+cd maven-cloudwalk-device-sdk && mvn -DskipTests clean install
+cd ../maven-cloudwalk-legacy-public && mvn -DskipTests clean install
+cd ../maven-cloudwalk-device-manager && mvn -DskipTests clean install
+cd ../maven-cwos-resource && mvn -DskipTests clean install
+cd ../maven-cloudwalk-intelligent-davinci-manager && mvn -DskipTests clean install
+cd ../maven-cloudwalk-cloud && mvn -DskipTests clean install
+cd ../maven-cwos-common-aks && mvn -DskipTests clean install
+cd ../maven-cwos-device-authentication && mvn -DskipTests clean install
 cd ../maven-intelligent-cwoscomponent && mvn -DskipTests clean install
 cd ../maven-cw-elevator-application && mvn -DskipTests clean compile
 ```
 
+**说明**：`maven-cwos-resource` 内 **`cwos-portal-interface`** 已按 **`cwos-java-sdk-resource`** 实际引用面裁剪（仅保留 `common`/`enterprise`/`user` 等与 SDK 相关的包），并含 **`cwos-device-pkg-stub`** 占位 **`DeviceUpgradeResult`**；与线上一致「全量 portal 接口」不等价，仅用于 **本地编译闭合**。
+
+**与 `cw_lib` 的 outer 类对照**：可用仓库根目录下 **`scripts/compare_jar_to_sources.py`**（参数为 **`cw-elevator-application-V1.0.0.20211103/cw_lib` 中某 `.jar` 的绝对路径** + **对应 `maven-*` 子模块目录**），快速检查 JAR 内每个 outer 类是否在源码树中有同名 `.java`；**`cwos-portal-interface`** 因裁剪会出现大量「缺失」，属预期。**`package-info.java`** 可能报告为「多出的源码」，一般可忽略。
+
+### `cw_lib` 审核结论摘要（outer 类级，相对 `cw-elevator-application-V1.0.0.20211103/cw_lib`）
+
+| 类型 | 模块 / 构件 | 结论 | 原因说明 |
+|------|----------------|------|----------|
+| **JAR 有类、本地缺 outer `.java`** | 除 **`cwos-portal-interface`** 外，与 `cw_lib` 成对映射的 **`maven-*` 子模块** | **未发现** | 已用脚本对 `cw_lib` 内各业务/公共 JAR 全量扫描；**仅** portal 因裁剪出现大量「缺失」。 |
+| **JAR 有类、本地缺 outer `.java`** | **`maven-cwos-resource/cwos-portal-interface`** | **约 438 个 outer 类无对应 `.java`** | **有意裁剪**：仅保留 **`cwos-java-sdk-resource`** 实际引用到的包，与 **`cw_lib` 全量 `cwos-portal-interface`** 不对等；非反编译丢文件。 |
+| **本地有业务类型、对应 JAR 无 outer 类** | **`cw-elevator-application-data`**：`TenantVisitorFloorPolicyDao` / `Dto` / `DaoImpl` / `Mapper` | **4 个类型仅存在于本地** | **`cw_lib` 中 `cw-elevator-application-data` / `service` JAR 均无 `TenantVisitor` 相关 `.class`**；与运行包相比，当前 Maven 源码含 **租户访客默认楼层策略** 增量（见 [租户访客默认楼层-数据库阶段变更记录.md](../business/租户访客默认楼层-数据库阶段变更记录.md)），属**业务演进**，不是「从 JAR 反编译漏解压」。 |
+| **本地多 `package-info.java`** | 若干模块 | 可忽略 | JAR 未必含 `package-info.class`，脚本会将 `package-info` 记为「多出」。 |
+| **占位桩** | **`cwos-device-pkg-stub`** | 无同名「全量」于 `cw_lib` | 仅为 **`DeviceUpgradeResult`** 等编译占位，与 portal 裁剪配套。 |
+| **无 `src/main/java`（非缺陷）** | **`maven-cloudwalk-cloud/cloudwalk-cloud-common`**（**`4.0.0-Brussels-SRX`**）与 **`maven-cloudwalk-legacy-public/cloudwalk-cloud-common`**（**`3.7.2-Brussels-SRX`**） | **目录下仅有 `pom.xml`，`packaging=pom`** | **`cloudwalk-cloud-common` 在上游即为 BOM/聚合父 POM**，不提供带 `.class` 的业务 JAR；**`cw_lib` 中也不存在 `cloudwalk-cloud-common-*.jar`**，只有各子构件（如 **`cloudwalk-common-result`**）的 `pom` 把 parent 指向该坐标。工作区维护 **两套版本**：**3.7.2**（与 **`反1`** / 历史 JAR 的 parent 一致）与 **4.0.0 stub**（与电梯等 **`cloudwalk.internal.version`** 对齐），**勿混用**。详见 [Maven聚合工程说明](../architecture/Maven聚合工程说明.md)（「为何存在 `cloudwalk-cloud-common` 子模块」及 **§3.x** 中 3.7.2 / 4.0.0 说明）。 |
+
+**说明**：outer 类级对照**不能**发现「同一类内方法体与线上一致」；若需核对 **service** 内既有类（如 **`PersonRuleServiceImpl`**）与 `cw_lib` 字节码是否一致，应对该类单独做反编译 diff 或回归测试。
+
+### `maven-*` 子模块走查：无 `src/main/java`（属正常，非「缺解压」）
+
+以下路径**仅有父 `pom.xml`、无 Java 源码目录**，`packaging` 为 **`pom`**，用于 **BOM / 聚合 / 占位**，与私服中「只发 POM、不发 JAR」的构件一致；**勿**当作反编译漏文件去 **`反1`** 补同名 `src`。
+
+| 路径 | 作用简述 |
+|------|----------|
+| **`maven-cloudwalk-cloud/cloudwalk-cloud-common`** | **`4.0.0`** 父坐标桩，见上文审核表。 |
+| **`maven-cloudwalk-legacy-public/cloudwalk-cloud-common`** | **`3.7.2`** 父 POM，承接 **`cloudwalk-common-result` / `web` / `serial`**。 |
+| **`maven-cwos-resource/cwos-component-resource`** | **`cwos-component-resource`** 聚合父。 |
+| **`maven-cwos-resource/cwos-portal`** | **`cwos-portal`** 聚合父。 |
+| **`maven-intelligent-cwoscomponent/intelligent-cwoscomponent-parent`** | intelligent 组件父 POM。 |
+| 各 **`maven-*/pom.xml` 反应堆根** | 仅 `pom` 聚合，无 `src`。 |
+
+### 反编译（JD-Core）遗留批量排除
+
+大量 **`反1`** 解压的 `.java` 含 **行首 `/*    */` / `/* N */`** 及文件尾部 **`/* Location: ... * JD-Core Version: ... */`**。已提供脚本在 **`maven-*`** 树内批量剔除（**不改**业务逻辑，仅删注释噪声；**`artifacts/decompiled/`** 下归档树默认不处理，除非显式传入路径参数）：
+
+```bash
+cd /path/to/反编译
+# 先预览将改动的文件数
+python3 scripts/strip_jdcore_java_noise.py --dry-run
+# 实际写回（默认处理仓库根下全部 maven-* 目录）
+python3 scripts/strip_jdcore_java_noise.py
+```
+
+写回后建议对常用反应堆执行 **`mvn -DskipTests clean compile`** 做抽样验证。
+
 ## 4. 版本与私服坐标说明
 
 - **`cloudwalk.internal.version`（如 4.0.0-Brussels-SRX）**：表示本仓库 **`cloudwalk-common-event` / `cloudwalk-common-service`** 等**已迁入源码**构件的版本。  
@@ -46,7 +104,7 @@ cd ../maven-cw-elevator-application && mvn -DskipTests clean compile
 |------|------|
 | `maven-cloudwalk-cloud` | 在可访问 Nexus 时，`mvn clean install` 可通过。 |
 | `maven-cw-elevator-application` 之 **common / data** | 已补齐 `spring-web`、`CollectionUtils` 与部分 DTO 反编译错误后，`mvn clean compile` 可编过至 **data** 模块。 |
-| `cw-elevator-application-service` | 依赖 **`cwos-component-resource`、`cwos-portal`、`davinci-manager-storage`** 等父工程，**须私服完整** 方可继续解析。 |
+| `cw-elevator-application-service` | **`cwos-*-resource` / `cwos-portal`** 父链可由 **`maven-cwos-resource`** 本地 install 解决；**`davinci-manager-storage`** 由 **`maven-cloudwalk-intelligent-davinci-manager`**；**`cloudwalk-common-result`/`web`/`serial`、`cwos-sdk-event`、`cloudwalk-intelligent-component-lock`** 由 **`maven-cloudwalk-legacy-public`**（**`反1`** zip）；若仍失败，多为 **其它私服构件** 或 **业务源码**（如反编译残留语法错误）。 |
 
 若仅修改电梯 **data/service 内业务代码**，可在完整依赖环境执行：
 
@@ -57,4 +115,74 @@ mvn -pl cw-elevator-application-service -am -DskipTests clean compile
 
 ---
 
+## 6. 编译日志排查（典型失败链）
+
+以下与一次真实日志一致：`cloudwalk-cloud` 成功 → `intelligent-cwoscomponent-interface` 失败 → 电梯 **common/data** 成功 → **service** 失败。
+
+### 6.1 第一层失败：`intelligent-cwoscomponent-interface`
+
+| 现象 | 含义 |
+|------|------|
+| `Failed to read artifact descriptor for ... cloudwalk-device-sdk-protocol-entity:jar:2.2.0` | 解析该 JAR 的 **有效 POM** 时失败。 |
+| `cloudwalk-device-sdk:pom:2.2.0 (absent) was not found in ... maven-public` | 私服 **没有** 或 **路径不对**：父构件 **`cn.cloudwalk:cloudwalk-device-sdk:2.2.0`**（packaging `pom`）未发布到当前使用的 `repository/maven-public`。 |
+| `This failure was cached in the local repository` | Maven 已把「解析失败」缓存在本地（`~/.m2` 或你配置的 **`localRepository`**，如日志中的 `/data/local/repo`），在 **update 间隔** 内会**不再重试**，表现为持续失败。 |
+
+**处理建议**（择一或组合）：
+
+1. 在 Nexus 补齐 **`cn.cloudwalk:cloudwalk-device-sdk:2.2.0`**（含 `protocol-entity` 子模块坐标），或改用团队约定的 **其他仓库**（`settings.xml` 里增加 `mirror`/`repository`）。  
+2. 强制刷新缓存后重编：  
+   `mvn -U -DskipTests clean install`（`-U` 即 `--update-snapshots`，并促使重新检查 release 元数据）。  
+3. 若确认私服已修好，可删除本地缓存目录后再编（路径示例，按坐标替换）：  
+   `rm -rf ~/.m2/repository/cn/cloudwalk/cloudwalk-device-sdk`  
+   若 `localRepository` 为 `/data/local/repo`，则同样删除其下 `cn/cloudwalk/cloudwalk-device-sdk`。
+
+`intelligent-cwoscomponent-interface` 直接依赖见：
+
+```29:32:maven-intelligent-cwoscomponent/intelligent-cwoscomponent-interface/pom.xml
+        <dependency>
+            <groupId>cn.cloudwalk</groupId>
+            <artifactId>cloudwalk-device-sdk-protocol-entity</artifactId>
+        </dependency>
+```
+
+（版本由反应堆 `dependencyManagement` 中的 **`cloudwalk.device.sdk.version`** 指定。）
+
+---
+
+### 6.2 第二层失败：`cw-elevator-application-service`（依赖未装全时的连锁）
+
+| 现象 | 含义 |
+|------|------|
+| `cwos-component-resource:pom:1.0.0-SNAPSHOT` absent | 接口包 **`cwos-component-resource-interface`** 所引用的 **父 POM** 未在私服。 |
+| `cwos-portal:pom:1.0.0-SNAPSHOT` absent | 同上，**`cwos-portal-interface`** 的父工程未发布。 |
+| `cloudwalk-intelligent-davinci-manager:pom:1.1.7-SNAPSHOT` absent | **`davinci-manager-storage`** 的父 POM 未在私服（或曾失败被缓存）。 |
+| `The POM for ... intelligent-cwoscomponent-rest:jar:3.0.0-xinghewan is missing` | 因 **6.1** 失败，**interface/rest 未 install** 到本地仓库，电梯解析 `intelligent-cwoscomponent-rest` 时只能报「无 POM/无依赖信息」。 |
+
+**结论**：`service` 的失败 **不是** 电梯业务源码语法问题，而是 **Maven 依赖图不完整**（私服缺件 + 上一步 intelligent 未成功）。
+
+**处理建议**：先解决 **6.1** 并执行 `maven-intelligent-cwoscomponent` 全量 `install` 成功；对 **cwos / davinci** 父链优先在本仓库执行 **`maven-cwos-resource`**、**`maven-cloudwalk-intelligent-davinci-manager`** 的 `install`；其余缺失再在 Nexus 补齐，或对构件执行 **`mvn install:install-file`** 安装到本地/私服。
+
+---
+
+### 6.3 警告（非本次失败主因，可后续治理）
+
+| 日志 | 说明 |
+|------|------|
+| `cloudwalk-common-web:jar:3.7.2-Brussels-SRX is invalid` … `cloudwalk-common-result` / `jsoup` **version is missing** | 私服上该 JAR 内嵌的 **POM 不完整**，Maven 构建「有效模型」时告警；**传递依赖可能不完整**。当前 **common/data** 已通过，但若运行期缺类，需在电梯反应堆 **`dependencyManagement`** 中显式补 `jsoup` 等版本。 |
+| 同上对 **`cloudwalk-common-serial`** 的 invalid 警告 | 同上，多为历史发布物 POM 质量问题。 |
+
+---
+
+### 6.4 推荐复现命令（修私服 / 清缓存后）
+
+```bash
+export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
+export PATH="$JAVA_HOME/bin:$PATH"
+cd maven-cloudwalk-cloud && mvn -U -DskipTests clean install
+cd ../maven-intelligent-cwoscomponent && mvn -U -DskipTests clean install
+cd ../maven-cw-elevator-application && mvn -U -DskipTests clean install
+```
+
+---
+
 *随 POM 与私服策略变更请更新本文。*