mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 16:30:29 +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.
43 lines
1.8 KiB
Markdown
43 lines
1.8 KiB
Markdown
# 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 |
|