当前位置：首页 > news >正文

领域模型

news 2026/5/12 22:34:34

智慧停车托管平台 —— 核心领域模型
- 模型图（ER）
- 解说
  - 1. 多租户与客户
  - 2. 组织层级与项目归属
  - 3. 运营账号、角色与子账号（坐席的体现方式）
  - 4. 项目、车道、设备与工单
  - 5. 事件与工单生命周期
- 与需求文档对齐要点
- 文档维护

智慧停车托管平台 —— 核心领域模型

本文档描述 AI 托管平台（与智慧停车等业务场景对齐）的核心业务实体及其关系。用于产品对齐与后续设计时的参考锚点。

模型图（ER）

erDiagram客户 ||--|| 租户 : "签约"租户 ||--|| 组织 : "关联顶层组织"组织 ||--o{ 组织 : "上下级（自关联树）"组织 ||--o{ 运营账号 : "归属"组织 ||--o{ 项目 : "管理"角色 }o--o{ 运营账号 : "分配"运营账号 ||--o{ 运营子账号 : "创建"运营子账号 }o--o{ 项目 : "授权访问"项目 ||--o{ 车道 : "包含"项目 ||--o{ 工单 : "归属"车道 ||--o{ 设备 : "绑定"车道 ||--o{ 工单 : "触发于"事件 ||--o| 工单 : "派单后转化"

若在本地预览打不开图，可使用 mermaid.live 粘贴上述代码块内容进行渲染。

解说

1. 多租户与客户

实体	说明
客户	与客户签约的商业主体（可视为合同与客户关系上的法人/集团）。
租户	平台侧的隔离边界（数据与配置常以租户为根）。
客户 ↔ 租户	通常为一对一：一个客户在平台开通一个租户空间（若未来存在「一个大客户多套环境」，可演进为一对多）。

2. 组织层级与项目归属

关系	说明
租户 → 组织（顶层）	租户与该租户的根组织一对一关联；多级组织由其子节点延伸。图中只出现一个「组织」类型，避免画两个矩形造成「顶层只管账号、下级只管项目」的误读。
组织自关联	一棵树：支持普通组织、托管组织等业务类型时在实现层用枚举/类型字段区分即可。

项目归属：项目挂在 某一个组织节点（不必只是根节点）；需求上「项目以组织维度进行管理」与本模型一致——项目从属于组织，不因组织在树中所处深度而不同。

3. 运营账号、角色与子账号（坐席的体现方式）

需求中的「系统管理员、组织管理员、子账号、坐席人员」统一到 运营账号：坐席不设独立实体，而是 账号 + 「坐席」等角色（RBAC）。

关系	说明
组织 → 运营账号	多对一：每个运营账号只属于一个组织；不存在「一个账号管理多个租户组织」的常见形态。
角色 ↔ 运营账号	多对多：同一账号可多角色（如管理员兼配置员）；同一角色可分配给多名账号。坐席工作台登录用户通常为「运营账号 + 坐席角色」。
运营账号 → 运营子账号	一对多：由主账号或其授权人员在组织语境下创建的子账号。
运营子账号 ↔ 项目	多对多（授权）：子账号可被授权访问组织下多个项目；这是权限范围扩展，不改变「账号仍只属于一个组织」的归属约束。

特殊约定：若在实现中存在「跨租户无组织」的系统管理员账号，可作为平台特例在数据模型中省略与组织的关联或使用独立「平台租户」建模，与本图租户内主体区分即可。

4. 项目、车道、设备与工单

实体	说明
项目	托管业务单元（如园区级/业务级项目），内含车道管理与策略配置等业务含义。
车道	出入口通行与呼叫现场单元；工单常携带车道上下文。
设备	对讲、识别相机、控制机等绑定在车道（或经由车道视图呈现）的基础设施。

关系	说明
项目 → 车道 / 工单	项目下有多条车道、多条工单均为一对多。
车道 → 工单	一对多：同一条车道可持续产生多张工单（不同时间、不同类型事件）；工单侧需记录所属车道以实现现场还原与派单归属解析（如车道→项目→组织）。

5. 事件与工单生命周期

需求区分 事件池中的事件 与进入坐席处理流程的工单：

关系	说明
事件 → 工单	事件被领取或系统派单后转化为工单；建模为至多一对一（`

与需求文档对齐要点

组织多级、项目按组织管理、车道与对讲设备绑定、事件去重后出现「工单」、坐席信息与「归属组织、可处理项目」等叙述，均可映射到上图关系。
坐席在线/挂起/离线、繁忙度等为 运行时状态：宜作为运营账号侧的扩展聚合（如会话/状态聚合根）或与调度领域对象关联，而非必须在本概念图中再放一个「坐席」实体以免与账号重复。