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

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

Made-with: Cursor

Former-commit-id: e102e8cab64e575bcd23c9a66a598aa1892bb492

maven-cw-elevator-application/cw-elevator-application-service/docs/INDEX.md

@@ -0,0 +1,55 @@
+# `cw-elevator-application-service` 业务逻辑文档总索引
+
+本目录以 **本 Maven 模块源码根**（`src/main/java/cn/cloudwalk/elevator`）为范围，对电梯应用 **业务编排层** 作多维度说明：分域业务、接口级能力、用例/时序/流程等图（Mermaid）及与外部系统的协作关系。
+
+| 元数据 | 说明 |
+|--------|------|
+| 模块路径 | `maven-cw-elevator-application/cw-elevator-application-service` |
+| 文档根 | 本目录 `.../cw-elevator-application-service/docs/` |
+| 源码包根 | `cn.cloudwalk.elevator` |
+| 产出形态 | Markdown + Mermaid（可用支持 Mermaid 的 IDE、Git 站点或 [mermaid.live](https://mermaid.live) 渲染） |
+
+## 与仓库级文档的关系
+
+- 全仓约定、走查、接口不变等说明见仓库根下 **`../../../docs/`**（相对本文件）。
+- 本目录专注 **本 service 模块内** 类职责与业务流程梳理，不替代对外 API 合同文档。
+
+## 分册导航
+
+| 文档 | 内容摘要 |
+|------|----------|
+| [00-overview.md](00-overview.md) | 模块定位、包结构、领域全景、组件依赖图 |
+| [01-device-and-task.md](01-device-and-task.md) | 设备 CRUD、绑定楼层/人员、设备任务与并行推进 |
+| [02-passrule-and-person.md](02-passrule-and-person.md) | 通行规则、图库规则引用、人员规则、人员管理 |
+| [03-record-recognition.md](03-record-recognition.md) | 电梯通行记录、识别记录、图库文件、分析统计 |
+| [04-mqtt-visitor-event.md](04-mqtt-visitor-event.md) | MQTT 推送、访客查询差异、域事件 `VisitorRecordPushEvent` |
+| [05-zone-code.md](05-zone-code.md) | 区域树/分页、电梯区域编码 |
+| [06-export-download-storage.md](06-export-download-storage.md) | 异步导出、下载中心、分片存储 |
+| [07-cross-cutting.md](07-cross-cutting.md) | 缓存、公共应用 ID、基类、空接口等横切项 |
+| [08-visitor-registration-and-elevator-auth.md](08-visitor-registration-and-elevator-auth.md) | **访客：登记/授权边界、派梯 `add/visitor` 全链路、记录打标、时序/活动图** |
+
+## 包 → 主入口（速查）
+
+| 包路径 | 主要 `*Service` 接口 / 类 |
+|--------|---------------------------|
+| `device` | `AcsElevatorDeviceService`、`AcsDeviceTaskService` |
+| `device/setting` | `AcsDeviceSettingService`、`AcsDeviceImageStoreAppBindService` |
+| `passrule` | `AcsPassRuleService`、`ImageRuleRefService` |
+| `person` | `AcsPersonService`、`PersonRuleService` |
+| `record` | `AcsElevatorRecordService`、`AcsRecogRecordService`、`PersonFileService`、`SendRecordTimeService`（空） |
+| `zone` | `ZoneService` |
+| `codeElevatorArea` | `AcsElevatorCodeService` |
+| `mqtt` | `MqttService` |
+| `export` | `AcsAbstractExportAsyncService` 子类如 `ElevatorDeviceExportService` |
+| `downloadcenter` | `AcsDownloadCenterService` |
+| `storage` | `AcsFileStorageService` |
+| `common` | `AcsApplicationService` |
+| `cacheable` | `AcsAreaTreeCacheableService`（非 interface，为 `@Service` 包装） |
+
+## 图例说明
+
+- **用例图**：采用 Mermaid `flowchart` / `C4` 简图表达参与者与用例分箱；需要标准 UML 用例图时可自工具导出。
+- **时序图**：`sequenceDiagram` 表示一次调用链。
+- **活动/状态**：`flowchart TB` 或 `stateDiagram-v2` 表示分支与状态。
+
+最后更新与源码版本以当前工作区 `cw-elevator-application-service` 反编译/还原代码为准；若与线上运行版本不一致，以发布制品为准。