chore: 工作区反编译与 Maven/文档/脚本同步到发布分支

- artifacts/decompiled 树与相关源码变更
- maven-cw-elevator-application 业务 docs 与 package-info
- scripts 下 formatter 校验与辅助脚本
- 其他子工程/接口与发布线一并纳入版本控制

Made-with: Cursor

Former-commit-id: e102e8cab64e575bcd23c9a66a598aa1892bb492
This commit is contained in:
反编译工作区
2026-04-25 09:35:35 +08:00
parent 1c28fcedfc
commit dee355b4a7
2000 changed files with 133077 additions and 169300 deletions
@@ -0,0 +1,42 @@
# 07 横切与公共(`common` / `cacheable` / 基类)
## 7.1 `AcsApplicationService`
- 方法 `getApplicationId`:按业务/租户等解析 **应用 ID**`AcsApplicationServiceImpl` 实现,细节见类)。
## 7.2 `AcsAreaTreeCacheableService`
- 包装 `SysettingAreaService#tree`
- `@Cacheable``ACS_AreaTreeCache`key 与 `CacheOverrideConfig`**租户前缀** 拼出,减少区域树 **重复远程调用**
## 7.3 基类
| 类 | 作用 |
|----|------|
| `AbstractCloudwalkService` | 与 Cloudwalk 框架通用基能力(见父类/模块) |
| `AbstractAcsDeviceService` | 设备域公用:区域树展平、构造带 `FeignThreadLocalUtil``CloudwalkCallContext` 等(见 `common/AbstractAcsDeviceService` |
| `AbstractAcsPassService` | 通行/规则子域抽取(见 `passrule/impl` |
## 7.4 空接口
- `SendRecordTimeService`:无方法;若需扩展 **发送记录时间** 类能力,可在此增方法并由实现类承载。
## 7.5 包级 `package-info`
各子包在源码中已逐步补充 `package-info.java``device`/`record`/`mqtt`/`visitor` 等),可与本 `docs` 互参。
## 7.6 多维度总览表(维度矩阵)
| 维度 | 读者关注点 | 建议文档 |
|------|------------|----------|
| 业务价值 | 电梯设备、规则、人员、记录 | 01–03 |
| 集成 | 访客、MQTT、Feign | 04, 00 |
| 可运维 | 缓存、异步、任务进度 | 01, 07, 04 |
| 可观测 | 事件、topic、锁 | 03, 04, 03-锁 |
**读文档优先级(示意,非绝对)**
| | 远程依赖多 | 本地/缓存多 |
|--|------------|-------------|
| **写路径多** | 设备任务、规则+人员 | (较少) |
| **读路径多** | 记录 openRecord | 区域树缓存、电梯码 map |