# 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 |