# 5.3 组织管理

本文档从《基础平台产品设计》第 5 章拆分而来，用于独立描述基础平台功能模块的业务需求、规则和验收标准。

上级文档：[基础平台产品设计](../基础平台产品设计.md)

## 5.3.1 功能说明

组织管理用于维护客户内部组织结构，是用户归属、角色授权、数据范围控制和业务系统数据隔离的基础。

基础平台组织用于表达客户内部管理结构，例如总部、分公司、部门、品牌、大区、区域、门店、平台商户等。组织管理只维护基础组织档案和组织层级，不承载门店经营、品牌经营、供应链、财务核算等业务属性。

## 5.3.2 功能范围

- 查询组织树
- 查看组织详情
- 新增组织
- 编辑组织
- 启用 / 停用组织
- 调整上级组织
- 维护组织负责人
- 维护组织类型
- 查看组织操作记录

## 5.3.3 字段要求

组织基础信息至少包括：

| 字段 | 说明 | 是否必填 |
| --- | --- | --- |
| 所属客户 | 组织归属客户 | 是 |
| 组织名称 | 组织展示名称 | 是 |
| 组织简称 | 用于列表、选择器等场景的短名称 | 否 |
| 组织编码 | 当前客户下唯一的组织编码 | 是 |
| 组织类型 | 公司、分公司、部门、品牌、大区、区域、门店、平台商户、其他 | 是 |
| 上级组织 | 当前组织的父级组织 | 否 |
| 组织负责人 | 当前组织的主要负责人 | 否 |
| 联系方式 | 组织负责人或组织联系手机号、电话、邮箱 | 否 |
| 启用状态 | 组织是否可继续使用 | 是 |
| 排序 | 同级组织展示顺序 | 否 |
| 组织说明 | 组织用途或补充说明 | 否 |
| 创建时间 | 组织档案创建时间 | 是 |
| 更新时间 | 组织档案最近更新时间 | 是 |

### 5.3.3.1 组织编码规则

组织编码用于在基础平台内唯一识别客户下的组织。

编码规则：

- 组织编码在同一客户下唯一。
- 不同客户之间允许存在相同组织编码。
- 组织编码创建后原则上不允许修改。
- 组织编码可由系统生成，也可由平台管理员或客户管理员按客户已有编码维护。
- 系统生成时建议格式为：`O` + 6 位流水号。
- 示例：`O000001`、`O000002`。
- 流水号按客户维度递增，不按组织类型分别递增。
- 删除或停用组织后，原组织编码不得在同一客户下复用。
- 组织编码仅用于系统识别、用户归属、权限范围、日志追踪和系统间关联，不承载组织层级含义。

编码校验要求：

- 新增组织时，系统需要校验同一客户下组织编码是否已存在。
- 组织编码为空、重复或格式不符合规则时，不允许保存组织。
- 导入或迁移组织数据时，如外部数据包含组织编码，需要校验是否在当前客户下唯一。

### 5.3.3.2 组织类型定义

基础平台 1.0 支持以下组织类型：

| 组织类型 | 定义 | 适用示例 |
| --- | --- | --- |
| 公司 | 客户内部最高层级或法人 / 管理主体 | 总部公司、品牌公司、业务公司 |
| 分公司 | 公司下设的分支经营或管理机构 | 省级分公司、城市分公司、区域分公司 |
| 部门 | 公司或组织下的职能部门 | 财务部、加盟部、直营部、运营部 |
| 品牌 | 连锁集团下的品牌管理单元 | 小吃品牌、茶饮品牌、火锅品牌 |
| 大区 | 品牌或业务线下的大区管理组织 | 华东大区、华南大区 |
| 区域 | 大区下的区域管理组织 | 上海区域、杭州区域 |
| 门店 | 连锁客户下的门店管理单元 | 加盟店、直营店、联营店 |
| 平台商户 | 平台型客户下的商户或经营主体 | 物流承运商、充电站运营商 |
| 其他 | 暂未归入标准类型的组织 | 临时组织、特殊协作组织 |

业务规则：

- 组织类型创建组织时必须选择。
- 组织类型支持后续编辑，但变更后不自动改变用户、角色、数据范围和历史业务数据。
- 分公司用于表达客户内部具有相对独立经营或管理职责的分支机构；大区、区域更偏运营管理层级，不默认等同于分公司。
- 门店可以作为组织类型纳入基础平台组织数据，用于用户归属、数据范围和权限控制；但万店规模客户不应在组织树中默认展开全部门店及其下级节点。
- 组织管理主页面的左侧管理组织树默认只展示管理组织，门店及其下级节点应通过右侧门店列表、门店检索或权限配置中的指定门店选择器进行展示和选择。
- 平台商户用于平台型客户的组织归属和权限范围，不等同于分账系统中的结算主体或账户。
- 督导、区域经理、店长等属于岗位、角色或人员职责，不作为组织类型维护；督导负责哪些门店应通过用户所属组织、角色授权和数据范围配置表达。
- 新增组织类型需由产品负责人确认后维护到数据字典。

## 5.3.4 组织树管理

### 5.3.4.1 功能说明

组织树管理用于按客户展示管理组织层级，并支持在组织树上进行新增、编辑、启停和调整上级组织。

对于门店数量较多的连锁客户，门店及其下级节点不在左侧管理组织树中默认作为节点逐级展开。门店仍可作为组织类型存在，但应通过门店列表、门店检索、分页表格或指定门店选择器承载。

### 5.3.4.2 功能范围

- 按客户查看管理组织树。
- 按组织名称、组织编码、组织类型、启用状态查询管理组织。
- 展开 / 收起组织层级。
- 查看选中管理组织下的门店列表和门店数量。
- 新增同级组织。
- 新增下级组织。
- 编辑组织信息。
- 启用 / 停用组织。
- 调整组织上级。

### 5.3.4.3 业务规则

- 组织必须归属于某个客户。
- 组织树按客户隔离，不允许跨客户查看或维护组织。
- 一个组织最多只能有一个上级组织。
- 顶层组织在客户初始化时创建，组织管理主页面不提供新增顶层组织按钮。
- 组织管理主页面新增组织时必须选择已有组织作为上级组织。
- 组织管理主页面不允许新增无上级组织的组织。
- 顶层组织允许没有上级组织，但仅由客户初始化流程创建。
- 左侧管理组织树默认展示公司、分公司、部门、品牌、大区、区域、平台商户、其他等管理组织。
- 门店组织及其下级节点不在左侧管理组织树中默认展示，避免万店客户组织树过深、节点过多、加载和操作困难。
- 新增或编辑组织时如选择组织类型为门店，保存后该组织进入右侧下级门店页签或门店检索结果，不进入左侧管理组织树默认展示范围。
- 如门店下存在档口、店中店、外摆点等特殊经营节点，默认跟随门店进入门店相关列表或后续门店业务系统，不进入左侧管理组织树默认展示范围。
- 如需要维护门店与区域、大区、品牌之间的归属关系，应在右侧门店列表或后续门店生命周期系统中完成。
- 不允许将组织调整到其他客户下。
- 不允许将组织调整到自己或自己的下级组织下。
- 调整上级组织不自动改变历史业务数据归属。
- 组织树默认只展示当前客户下启用和停用的管理组织，不展示已删除历史数据。

## 5.3.5 组织负责人维护

### 5.3.5.1 功能说明

组织负责人用于标识当前组织的管理责任人，便于后续消息通知、待办分派、权限初始化和问题排查。

### 5.3.5.2 功能范围

- 设置组织负责人。
- 更换组织负责人。
- 清空组织负责人。
- 查看组织负责人联系方式。

### 5.3.5.3 业务规则

- 组织负责人必须是当前客户下的用户。
- 停用用户不可被新增设置为组织负责人。
- 组织负责人变更不自动改变该用户的角色和权限。
- 组织负责人停用后，组织负责人字段保留历史展示，但系统应提示负责人已停用。
- 组织负责人变更需要记录操作日志。

## 5.3.6 启用 / 停用组织

### 5.3.6.1 功能说明

启用 / 停用组织用于控制组织是否可继续作为用户归属、角色授权和数据范围选择对象。

### 5.3.6.2 业务规则

- 停用组织后，该组织不可继续分配给新用户。
- 停用组织后，该组织不可继续作为新增角色数据范围。
- 停用组织不影响历史用户归属、历史角色授权和历史业务数据归属。
- 停用组织时，如果存在启用状态的下级组织，系统需要提示影响范围。
- 是否允许停用存在启用下级组织的组织，由平台配置决定；1.0 建议允许停用但需要二次确认。
- 启用上级组织不自动启用下级组织。
- 停用上级组织后，下级组织在组织树中仍展示原层级，但需要体现上级已停用状态。
- 停用组织和启用组织均需要记录操作日志。

## 5.3.7 业务规则

- 组织必须归属于某个客户。
- 组织编码在同一客户下唯一。
- 组织支持多级结构。
- 一个客户至少应有一个顶层组织。
- 用户可归属于一个或多个组织，但必须有一个默认组织，具体规则在用户与账号管理中定义。
- 数据权限可按全部、本组织及下级组织、本组织、指定组织、指定门店等范围生效，具体规则在角色管理中定义。
- 对于加盟连锁企业的督导场景，督导本人可归属于区域、大区或运营部门，实际负责门店通过角色数据范围选择指定门店，不通过新增组织类型表达。
- 组织调整不自动改变历史业务单据、历史对账数据、历史分账数据等业务数据归属。
- 客户停用后，不允许继续新增该客户下组织。
- 组织停用不删除组织档案。

## 5.3.8 界面设计

### 5.3.8.1 功能入口与访问权限

组织管理作为基础平台的客户内管理功能，建议放置在基础平台左侧菜单：

```text
基础平台
└── 组织管理
```

页面访问规则：

- 平台超级管理员、实施人员、具备组织管理权限的平台用户可维护所有客户组织。
- 客户管理员只能维护本客户下组织。
- 普通业务用户不可访问组织管理页面。
- 无组织管理权限的用户不展示组织管理菜单。

### 5.3.8.2 组织管理主页面

点击基础平台 > 组织管理后，直接进入组织管理主页面。组织管理主页面是组织管理的实际工作页面，用于展示管理组织树、组织详情和组织下门店列表。

展示方式：

- 平台用户进入页面后，顶部展示客户选择器和组织查询条件。
- 客户管理员或归属于某个客户的用户进入页面后，系统默认当前客户，不展示客户查询条件。
- 左侧为管理组织树，默认不展示门店及其下级节点。
- 右侧为组织详情区，采用 Tab 页签展示基础信息、下级门店、操作记录。
- 下级门店页签采用查询区域 + 数据表格 + 分页展示。

简化版原型图：

```text
┌──────────────────────────────────────────────────────────────────────────────┐
│ 基础平台 > 组织管理                                                           │
├──────────────────────────────────────────────────────────────────────────────┤
│ 客户： [客户选择器/当前客户只读]  组织名称：[        ]  组织编码：[        ]  │
│ 组织类型：[全部 v]  启用状态：[全部 v]                         [查询] [重置] │
├───────────────────────┬──────────────────────────────────────────────────────┤
│ 管理组织树             │ 组织详情                                             │
│                       │                                                      │
│ [新增下级组织]         │  当前组织：华东大区                         [编辑] │
│                       │                                      [调整上级] [停用]│
│ ▼ XX集团总部           │                                                      │
│   ▼ 餐饮品牌公司       │  ┌──────────┬──────────┬──────────┐                │
│     ▼ 华东大区         │  │ 基础信息 │ 下级门店 │ 操作记录 │                │
│       上海区域  门店128│  └──────────┴──────────┴──────────┘                │
│       杭州区域  门店86 │                                                      │
│     ▼ 华南大区         │  基础信息页签：                                      │
│       广州区域  门店92 │  组织名称：华东大区                                  │
│                       │  组织编码：O000123                                   │
│ 说明：左侧不展示门店及 │  组织类型：大区                                      │
│ 其下级节点，只展示门店 │  上级组织：餐饮品牌公司                              │
│ 数量。                 │  组织负责人：张三                                    │
│                       │  启用状态：启用                                      │
├───────────────────────┴──────────────────────────────────────────────────────┤
│ 下级门店页签示例：                                                            │
│ 门店名称：[        ]  门店编码：[        ]  启用状态：[全部 v]      [查询]    │
│ ┌──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐        │
│ │ 门店名称 │ 门店编码 │ 所属品牌 │ 所属大区 │ 所属区域 │ 操作     │        │
│ ├──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤        │
│ │ 上海001店│ S000001  │ 餐饮品牌 │ 华东大区 │ 上海区域 │ 查看 编辑│        │
│ │ 上海002店│ S000002  │ 餐饮品牌 │ 华东大区 │ 上海区域 │ 查看 编辑│        │
│ └──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘        │
│                                                            < 1 / 20 >        │
└──────────────────────────────────────────────────────────────────────────────┘
```

客户选择规则：

| 用户类型 | 客户选择方式 | 说明 |
| --- | --- | --- |
| 平台用户 | 客户选择器 | 需要先选择客户，再查看该客户组织 |
| 实施人员 | 客户选择器 | 可按项目需要选择客户 |
| 客户管理员 | 只读当前客户 | 默认当前客户，不允许切换 |
| 客户内普通管理用户 | 只读当前客户 | 默认当前客户，不允许切换 |

管理组织查询条件：

| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
| --- | --- | --- | --- |
| 组织名称 | 文本输入框 | 人工录入 | 支持模糊查询 |
| 组织编码 | 文本输入框 | 人工录入 | 支持精确或模糊查询 |
| 组织类型 | 下拉框 | 系统字典：公司、分公司、部门、品牌、大区、区域、平台商户、其他 | 可为空，不包含门店 |
| 启用状态 | 下拉框 | 系统字典：全部、启用、停用 | 默认全部 |
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |

管理组织树字段：

| 字段 | 说明 |
| --- | --- |
| 组织名称 | 按层级展示组织名称 |
| 组织类型 | 展示组织类型标签 |
| 启用状态 | 停用组织需要展示停用标识 |
| 下级门店数 | 如当前组织下存在门店，展示门店数量，不展开门店及其下级节点 |

右侧基础信息页签字段：

| 字段 | 说明 |
| --- | --- |
| 组织名称 | 当前选中组织名称 |
| 组织简称 | 当前选中组织简称 |
| 组织编码 | 当前选中组织编码 |
| 组织类型 | 当前选中组织类型 |
| 上级组织 | 当前组织父级 |
| 组织负责人 | 当前组织负责人 |
| 联系方式 | 组织负责人或组织联系方式 |
| 启用状态 | 当前组织启用或停用 |
| 排序 | 同级排序 |
| 组织说明 | 组织用途说明 |
| 创建时间 | 组织创建时间 |
| 更新时间 | 最近更新时间 |

右侧下级门店页签：

| 区域 | 展示方式 | 说明 |
| --- | --- | --- |
| 门店查询区域 | 查询表单 | 按门店名称、门店编码、启用状态查询 |
| 门店列表 | 数据表格 + 分页 | 展示当前组织及下级组织范围内的门店 |

门店列表字段：

| 字段 | 说明 |
| --- | --- |
| 门店名称 | 门店组织名称 |
| 门店编码 | 门店组织编码 |
| 所属品牌 | 门店归属品牌组织 |
| 所属大区 | 门店归属大区组织 |
| 所属区域 | 门店归属区域组织 |
| 启用状态 | 启用、停用 |
| 操作 | 查看、编辑、调整归属、启用、停用 |

页面操作：

- 新增下级组织
- 查看下级门店
- 编辑组织
- 调整上级组织
- 启用组织
- 停用组织

### 5.3.8.3 组织新增 / 编辑页

组织新增 / 编辑页用于创建或维护客户下的组织档案。新增和编辑使用同一个页面或弹窗，根据操作模式控制默认值、只读字段和保存规则。

展示方式：

- 采用表单方式展示。
- 不使用表格或 Tab 页签。

表单字段：

| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
| --- | --- | --- | --- |
| 所属客户 | 下拉框 / 客户选择器 / 只读文本 | 客户管理中已启用客户 | 平台用户选择；客户管理员只读显示当前客户 |
| 组织名称 | 文本输入框 | 人工录入 | 必填 |
| 组织简称 | 文本输入框 | 人工录入 | 选填 |
| 组织编码 | 文本输入框 | 系统生成或人工录入 | 必填，当前客户下唯一 |
| 组织类型 | 下拉框 | 系统字典：公司、分公司、部门、品牌、大区、区域、门店、平台商户、其他 | 必填 |
| 上级组织 | 树形选择器 | 当前客户组织树 | 新增模式必填，新增下级组织时系统默认带入 |
| 组织负责人 | 用户选择器 | 当前客户下启用用户 | 选填 |
| 联系方式 | 文本输入框 | 人工录入或根据负责人带出 | 选填 |
| 启用状态 | Switch | 人工选择 | 默认启用 |
| 排序 | 数字输入框 | 人工录入 | 选填 |
| 组织说明 | 多行文本框 | 人工录入 | 选填 |

新增模式规则：

- 所属客户、组织名称、组织编码、组织类型为必填。
- 平台用户新增组织时必须先选择客户。
- 客户管理员新增组织时，所属客户默认为当前客户且不可修改。
- 新增下级组织时，上级组织默认带入当前选中组织。
- 新增模式下上级组织必填，不允许新增无上级组织的顶层组织。
- 组织编码可由系统生成或人工录入，保存时校验当前客户下唯一。
- 创建时间、更新时间由系统生成，不在新增表单中录入。

编辑模式规则：

- 所属客户、组织编码、创建时间、更新时间采用只读文本展示。
- 组织编码编辑时不允许修改。
- 组织名称、组织简称、组织类型、上级组织、组织负责人、联系方式、启用状态、排序、组织说明可编辑。
- 启用状态采用 Switch 维护；停用组织时需要提示影响范围。
- 上级组织如在编辑页支持调整，需要执行调整上级组织校验规则。

模式差异：

| 字段 / 规则 | 新增模式 | 编辑模式 |
| --- | --- | --- |
| 所属客户 | 平台用户选择；客户管理员只读当前客户 | 只读展示 |
| 组织编码 | 系统生成或人工录入 | 只读展示，不允许修改 |
| 上级组织 | 必填，新增下级时默认带入 | 可按规则调整 |
| 创建时间 | 不展示或系统生成 | 只读展示 |
| 更新时间 | 不展示或系统生成 | 只读展示 |
| 保存结果 | 创建组织档案 | 更新组织档案 |

### 5.3.8.4 调整上级组织弹窗

调整上级组织用于修改组织树层级。

展示方式：

- 采用表单 + 树形选择器方式展示。
- 不使用数据表格。

表单字段：

| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
| --- | --- | --- | --- |
| 当前组织 | 只读文本 | 当前选中组织 | 系统自动带入 |
| 当前上级组织 | 只读文本 | 当前组织父级 | 系统自动带入 |
| 新上级组织 | 树形选择器 | 当前客户组织树 | 必填 |
| 调整原因 | 多行文本框 | 人工录入 | 选填 |

页面规则：

- 新上级组织不能选择当前组织。
- 新上级组织不能选择当前组织的下级组织。
- 新上级组织必须属于同一客户。
- 新上级组织不能为空，组织管理主页面不允许通过调整上级组织生成新的顶层组织。
- 保存后刷新管理组织树。
- 调整上级组织需要记录操作日志。

### 5.3.8.5 操作记录页签

操作记录用于查看组织相关关键变更。

展示方式：

- 位于组织详情区下方。
- 采用数据表格展示。
- 不设置复杂筛选条件，默认展示当前组织相关操作记录。

列表字段：

| 字段 | 说明 |
| --- | --- |
| 操作时间 | 操作发生时间 |
| 操作人 | 执行操作的用户 |
| 操作类型 | 新增、编辑、启用、停用、调整上级组织、负责人变更 |
| 操作内容 | 操作摘要 |
| 操作说明 | 操作原因或备注 |

## 5.3.9 使用导航

### 5.3.9.1 查看管理组织树

操作路径：

```text
基础平台 > 组织管理
```

操作步骤：

1. 进入组织管理主页面。
2. 平台用户选择客户；客户管理员和客户内用户默认当前客户，不展示客户查询条件。
3. 按组织名称、组织编码、组织类型或启用状态查询。
4. 在左侧管理组织树查看组织层级。
5. 点击组织节点，在右侧查看组织详情。

### 5.3.9.2 查看下级门店

操作路径：

```text
基础平台 > 组织管理 > 组织详情 > 下级门店
```

操作步骤：

1. 进入组织管理主页面。
2. 平台用户选择客户；客户管理员和客户内用户默认当前客户。
3. 在左侧管理组织树选择品牌、大区、区域或其他管理组织。
4. 打开右侧下级门店页签。
5. 按门店名称、门店编码或启用状态查询门店。
6. 在门店列表中分页查看当前组织及下级组织范围内的门店。

### 5.3.9.3 新增组织

操作路径：

```text
基础平台 > 组织管理 > 组织新增 / 编辑页
```

操作步骤：

1. 进入组织管理主页面。
2. 选择客户。
3. 选择一个已有组织。
4. 点击新增下级组织。
5. 系统打开组织新增 / 编辑页，并进入新增模式，上级组织默认带入当前选中组织。
6. 填写组织名称、组织编码、组织类型。
7. 按需选择组织负责人，填写联系方式、排序和组织说明。
8. 设置启用状态。
9. 保存组织。
10. 系统刷新管理组织树并记录操作日志。

### 5.3.9.4 编辑组织

操作路径：

```text
基础平台 > 组织管理 > 组织新增 / 编辑页
```

操作步骤：

1. 进入组织管理主页面。
2. 查询并选择目标组织。
3. 点击编辑组织。
4. 系统打开组织新增 / 编辑页，并进入编辑模式。
5. 修改组织名称、组织简称、组织类型、上级组织、组织负责人、联系方式、启用状态、排序或组织说明。
6. 保存修改。
7. 系统刷新组织详情并记录操作日志。

### 5.3.9.5 调整上级组织

操作路径：

```text
基础平台 > 组织管理 > 组织树 > 调整上级组织
```

操作步骤：

1. 进入组织管理主页面。
2. 查询并选择目标组织。
3. 点击调整上级组织。
4. 在弹窗中选择新上级组织。
5. 系统校验是否同一客户、是否选择自身或下级组织。
6. 保存调整。
7. 系统刷新管理组织树并记录操作日志。

### 5.3.9.6 启用 / 停用组织

操作路径：

```text
基础平台 > 组织管理 > 组织树 > 启用 / 停用
```

操作步骤：

1. 进入组织管理主页面。
2. 查询并选择目标组织。
3. 点击启用或停用。
4. 停用组织时，系统提示停用影响。
5. 确认操作。
6. 系统更新组织状态并记录操作日志。

停用影响：

- 停用组织不可继续分配给新用户。
- 停用组织不可继续作为新增角色数据范围。
- 停用组织不删除历史组织档案。
- 停用组织不影响历史业务数据归属。

## 5.3.10 验收标准

- 可按客户维护管理组织树。
- 平台用户可选择客户查看组织；客户管理员只能查看和维护本客户组织。
- 组织编码在同一客户下唯一，重复时不允许保存。
- 可在已有组织下新增下级组织。
- 顶层组织由客户初始化流程创建，组织管理主页面不提供新增顶层组织按钮。
- 可编辑组织名称、简称、类型、负责人、联系方式、启用状态、排序和说明。
- 可调整组织上级，且不能调整到其他客户、自己或自己的下级组织下。
- 可启用和停用组织。
- 停用组织后不可继续分配给新用户。
- 停用组织后不可继续作为新增角色数据范围。
- 组织负责人只能选择当前客户下启用用户。
- 组织管理主页面采用查询区域 + 左侧管理组织树 + 右侧详情区展示。
- 客户管理员和客户内用户进入组织管理主页面时，默认当前客户，不展示客户查询条件。
- 左侧管理组织树默认不展示门店及其下级节点。
- 组织类型为门店的组织保存后进入门店列表和门店检索结果，不进入左侧管理组织树默认展示范围。
- 门店通过右侧下级门店页签的查询区域 + 数据表格 + 分页展示。
- 新增组织、编辑组织复用组织新增 / 编辑页，并采用表单方式展示。
- 调整上级组织采用表单 + 树形选择器方式展示。
- 操作记录采用数据表格展示。
- 组织新增、编辑、启用、停用、调整上级组织、负责人变更均生成操作日志。