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

Files

T

hpd840321 7b2bd307f1 Initial commit: reorganized source tree

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

2026-05-09 09:56:45 +08:00

2.9 KiB

Raw Blame History

02 通行规则与人员（`passrule` / `person`）

2.1 业务目标

通行规则：按 区域/楼层/图库/标签/组织 等维护通行策略，与平台图库、设备绑定任务配合。
图库规则引用（ImageRuleRefService）：从 图库/图片 ID 视角查规则列表、只增规则、人员列表、分页等，与 AcsPassRuleService 的「规则主 CRUD」互补。
人员：AcsPersonService 面向业务侧人员维护；PersonRuleService 在 规则上下文 下做人员/访客的增删改查及 与图库人员 的关联（如 personDetail）。

2.2 `AcsPassRuleService` 方法表

方法	概要
`listFloor`	规则关联楼层列表
`getIsDefaultByZoneId`	区域下是否默认规则等标识
`add` / `update` / `delete` / `detail` / `page` / `list`	标准 CRUD 与详情分页
`listByImageId`	按图库/图片查规则 DTO 列表，供设备或绑定流使用

2.3 `ImageRuleRefService` 方法表

方法	概要
`page`	图库规则分页（与规则查询参数共用部分字段）
`listFloor`	图库侧楼层规则列表
`listByPersonInfo`	按人维度列规则/楼层
`listByPersonList`	批量人列表与规则关系
`detail`	单条图库规则详情
`addOnlyRule`	仅建规则（设备任务中「非人员」线可能走此路）
`update` / `delete`	更新/删除，与 `AcsPassRuleService` 分工依实现类而定

实现基类提示：passrule/impl/AbstractAcsPassService.java 可抽取与远程/DAO 的共性。

2.4 `AcsPersonService` 与 `PersonRuleService`

接口	特点
`AcsPersonService`	`add` / `edit` / `delete` / `page` / `timeDetail` / `pageByApp`
`PersonRuleService`	在规则域增加 `addVisitor`、`personDetail(图库人员)` 等

2.5 用例图（简）

flowchart LR
  Admin((管理员))
  Admin --> P1[维护通行规则]
  Admin --> P2[按图查规则/楼层]
  Admin --> P3[维护人员/访客]
  P1 --> S1[AcsPassRuleService]
  P2 --> S2[ImageRuleRefService]
  P3 --> S3[PersonRuleService / AcsPersonService]

2.6 时序：仅创建规则（与设备任务线关联）

sequenceDiagram
  participant Task as AcsDeviceTaskServiceImpl
  participant IMG as ImageRuleRefService
  Task->>IMG: addOnlyRule(区域/标签/组织)
  IMG-->>Task: CloudwalkResult
  Note over Task: 成功后再推进 bind 进度

2.7 与设备任务关系（概念）

人员绑定：updateFloors 中若带 personId，走 PersonRuleService.add/delete 按 楼层/区域 维度。
非人员（标签/组织）：建/删 规则名 与 ImageRuleRef DAO，并调 imageRuleRefService 的删除或 addOnlyRule。

更多细节以 AcsPassRuleServiceImpl.java、AcsDeviceTaskServiceImpl.java 源码为准。

2.9 KiB Raw Blame History Unescape Escape

02 通行规则与人员（passrule / person）