mirror of https://github.com/hpd840321/starRiverProperty.git synced 2026-06-10 00:40:30 +08:00

Files

T

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

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

Made-with: Cursor

Former-commit-id: e102e8cab64e575bcd23c9a66a598aa1892bb492

2026-04-25 09:35:35 +08:00

3.5 KiB

Raw Blame History

`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 渲染）

与仓库级文档的关系

全仓约定、走查、接口不变等说明见仓库根下 ../../../docs/（相对本文件）。
本目录专注 本 service 模块内 类职责与业务流程梳理，不替代对外 API 合同文档。

分册导航

文档	内容摘要
00-overview.md	模块定位、包结构、领域全景、组件依赖图
01-device-and-task.md	设备 CRUD、绑定楼层/人员、设备任务与并行推进
02-passrule-and-person.md	通行规则、图库规则引用、人员规则、人员管理
03-record-recognition.md	电梯通行记录、识别记录、图库文件、分析统计
04-mqtt-visitor-event.md	MQTT 推送、访客查询差异、域事件 `VisitorRecordPushEvent`
05-zone-code.md	区域树/分页、电梯区域编码
06-export-download-storage.md	异步导出、下载中心、分片存储
07-cross-cutting.md	缓存、公共应用 ID、基类、空接口等横切项
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 反编译/还原代码为准；若与线上运行版本不一致，以发布制品为准。

3.5 KiB Raw Blame History Unescape Escape

cw-elevator-application-service 业务逻辑文档总索引