# 组织架构

> 模块编码：org
> 端侧：Web + 小程序（双端）
> 关联文档：01-模块划分 §3.4 / 02-功能清单-物业公司 §4 / 03-业务流转逻辑-物业公司 §4 / 05-接口规范 §9.2

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 组织架构 |
| 子菜单 | 班组管理、人员管理、人员分配、排班管理、技能管理、打卡点分配、下属账号管理 |
| 功能编号 | PR-O-01 ~ PR-O-11 |
| 权限编码前缀 | org:team:* / org:staff:* |

---

## 页面1：班组管理页

**页面编号**：PR-O-01-P01
**端侧归属**：Web专属
**页面路径**：/org/teams

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 组织架构 > 班组管理                                       │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 班组名称[____] 班组类型[▼] 状态[▼]                  [查询] [重置]  │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增班组]                                              │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号| 班组名称 | 类型 | 班组长 | 人数 | 负责区域 | 状态 | 操作     │
│ 1  | 水电维修班| 维修 | 张三   | 8    | 门诊楼   | 启用 | 编辑 停用│
│ 2  | 巡检一班  | 巡检 | 李四   | 5    | 全院     | 启用 | 编辑 停用│
│ 3  | 保洁早班  | 保洁 | 王五   | 12   | 门诊+住院| 启用 | 编辑 停用│
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共10条                                                    │
└──────────────────────────────────────────────────────────────────┘
```

### 表单字段（新增/编辑弹窗）

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 班组名称 | 文本输入 | 是 | — | 自填 | 最大30字，同租户唯一 |
| 班组类型 | 下拉单选 | 是 | — | 字典管理-班组类型 | 维修/巡检/保洁/综合 |
| 班组长 | 下拉单选 | 是 | — | 人员列表 | — |
| 负责区域 | 级联多选 | 否 | — | 区域五级架构 | — |
| 描述 | 多行文本 | 否 | — | 自填 | 最大200字 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 新增班组 | org:team:create | 操作栏 | 始终 | — |
| 编辑 | org:team:update | 行操作 | 始终 | — |
| 停用 | org:team:update | 行操作 | 始终 | 有未完成任务时不可停用 |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 列表查询 | /api/v1/teams | GET | — |
| 新增 | /api/v1/teams | POST | — |
| 编辑 | /api/v1/teams/{id} | PUT | — |

---

## 页面2：人员管理页

**页面编号**：PR-O-02-P01
**端侧归属**：Web专属
**页面路径**：/org/staffs

### 查询条件

| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|--------|----------|------|--------|------|
| 姓名 | 文本输入 | 否 | — | 模糊匹配 |
| 所属班组 | 下拉单选 | 否 | 全部 | — |
| 技能标签 | 下拉多选 | 否 | 全部 | — |
| 状态 | 下拉单选 | 否 | 全部 | 在职/离职 |

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 姓名 | 80px | 否 | — |
| 2 | 手机号 | 120px | 否 | 脱敏显示 |
| 3 | 所属班组 | 120px | 是 | 支持一人多班组，逗号分隔 |
| 4 | 技能标签 | 150px | 否 | 标签样式 |
| 5 | 角色 | 100px | 否 | 下属账号角色 |
| 6 | 状态 | 80px | 是 | 在职/离职 |
| 7 | 操作 | 160px | — | 编辑/分配/查看排班 |

### 表单字段（新增/编辑弹窗）

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 姓名 | 文本输入 | 是 | — | 自填 | 最大20字 |
| 手机号 | 文本输入 | 是 | — | 自填 | 手机号格式 |
| 所属班组 | 下拉多选 | 是 | — | 班组列表 | 支持一人多班组 |
| 技能标签 | 下拉多选 | 否 | — | 技能管理 | — |
| 入职日期 | 日期选择 | 否 | — | 自填 | — |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 新增人员 | org:staff:create | 操作栏 | 始终 | — |
| 编辑 | org:staff:update | 行操作 | 始终 | — |
| 分配 | org:staff:update | 行操作 | 始终 | 分配到班组/区域 |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 列表查询 | /api/v1/staffs | GET | — |
| 新增 | /api/v1/staffs | POST | — |
| 编辑 | /api/v1/staffs/{id} | PUT | — |

---

## 页面3：排班管理页

**页面编号**：PR-O-04-P01
**端侧归属**：Web专属
**页面路径**：/org/schedules

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 组织架构 > 排班管理                                       │
├──────────────────────────────────────────────────────────────────┤
│ [视图切换]  📅周视图  📆月视图    班组：[▼]         [◀ 本周 ▶]    │
├──────────────────────────────────────────────────────────────────┤
│ [周视图]                                                          │
│ 人员   | 周一   | 周二   | 周三   | 周四   | 周五   | 周六  | 周日│
│ 张三   | 早班   | 早班   | 晚班   | 早班   | 早班   | 休息  | 休息│
│ 李四   | 晚班   | 晚班   | 早班   | 晚班   | 晚班   | 休息  | 休息│
├──────────────────────────────────────────────────────────────────┤
│ [操作]  [保存] [批量排班] [模板排班] [导出]                        │
└──────────────────────────────────────────────────────────────────┘
```

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 批量排班 | org:team:create | 操作栏 | 始终 | 选择多人同一班次 |
| 模板排班 | org:team:create | 操作栏 | 始终 | 从已有模板加载 |
| 保存 | org:team:update | 操作栏 | 始终 | — |
| 导出 | org:team:export | 操作栏 | 始终 | 导出排班表 |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 排班查询 | /api/v1/team-schedules | GET | — |
| 保存 | /api/v1/team-schedules/batch | POST | — |

---

## 页面4：技能管理页

**页面编号**：PR-O-05-P01
**端侧归属**：Web专属
**页面路径**：/org/skills

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 技能名称 | 150px | 否 | 如：水电维修、空调维修 |
| 2 | 关联班组 | 150px | 否 | 使用该技能的班组 |
| 3 | 持有人员数 | 100px | 是 | — |
| 4 | 操作 | 100px | — | 编辑/删除 |

### 表单字段（新增/编辑弹窗）

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 技能名称 | 文本输入 | 是 | — | 自填 | 最大30字，同租户唯一 |
| 关联班组 | 下拉多选 | 否 | — | 班组列表 | — |
| 描述 | 多行文本 | 否 | — | 自填 | 最大200字 |

---

## 页面5：打卡点分配页

**页面编号**：PR-O-06-P01
**端侧归属**：Web专属
**页面路径**：/org/check-in-points

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 班组 | 120px | 否 | — |
| 2 | 打卡点名称 | 150px | 否 | — |
| 3 | 位置 | 150px | 否 | — |
| 4 | 蓝牙Beacon | 120px | 否 | — |
| 5 | 适用角色 | 100px | 否 | 全部/主管/员工 |
| 6 | 操作 | 100px | — | 编辑/删除 |

### 表单字段（新增/编辑弹窗）

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 打卡点名称 | 文本输入 | 是 | — | 自填 | 最大30字 |
| 适用班组 | 下拉单选 | 是 | — | 班组列表 | — |
| 位置描述 | 文本输入 | 是 | — | 自填 | — |
| 蓝牙Beacon | 下拉单选 | 是 | — | 蓝牙设备管理 | — |
| 适用角色 | 下拉多选 | 是 | 全部 | 固定选项 | — |

---

## 页面6：下属账号管理页

**页面编号**：PR-O-07-P01
**端侧归属**：Web专属
**页面路径**：/org/subordinates

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 组织架构 > 下属账号管理                                    │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 姓名[____] 班组[▼] 角色[▼] 状态[▼]                 [查询] [重置]  │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增下属] [批量分配角色] [批量启停]                      │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ ☐| 姓名 | 手机号   | 班组    | 角色     | 状态 | 操作             │
│ ☐| 张三 | 138****12| 水电班  | 主管     | 启用 | 编辑 角色 权限 启停│
│ ☐| 李四 | 139****34| 水电班  | 维修员   | 启用 | 编辑 角色 权限 启停│
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共50条  每页[20▼]  < 1 2 3 >                              │
└──────────────────────────────────────────────────────────────────┘
```

### 查询条件

| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|--------|----------|------|--------|------|
| 姓名 | 文本输入 | 否 | — | 模糊匹配 |
| 班组 | 下拉单选 | 否 | 全部 | — |
| 角色 | 下拉单选 | 否 | 全部 | 数据来源：超管定义的角色 |
| 状态 | 下拉单选 | 否 | 全部 | 启用/禁用 |

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | ☐勾选 | 40px | — | 批量操作用 |
| 2 | 姓名 | 80px | 否 | — |
| 3 | 手机号 | 120px | 否 | 脱敏 |
| 4 | 所属班组 | 120px | 是 | — |
| 5 | 角色 | 120px | 否 | — |
| 6 | 数据权限 | 100px | 否 | 本班组/指定区域 |
| 7 | 状态 | 80px | 是 | — |
| 8 | 操作 | 220px | — | 编辑/分配角色/权限覆盖/启停 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 新增下属 | org:staff:create | 操作栏 | 始终 | 弹窗 |
| 批量分配角色 | permission:user:update | 操作栏 | 勾选≥1条 | 弹窗选择角色 |
| 批量启停 | org:staff:update | 操作栏 | 勾选≥1条 | 二次确认 |
| 编辑 | org:staff:update | 行操作 | 始终 | — |
| 分配角色 | permission:user:update | 行操作 | 始终 | 选择角色 |
| 权限覆盖 | permission:user:update | 行操作 | 始终 | 在角色基础上自定义权限(四级树形) |
| 启停 | org:staff:update | 行操作 | 始终 | 二次确认 |

### 新增下属弹窗

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 姓名 | 文本输入 | 是 | — | 自填 | 最大20字 |
| 手机号 | 文本输入 | 是 | — | 自填 | 手机号格式 |
| 所属班组 | 下拉多选 | 是 | — | 班组列表 | — |
| 分配角色 | 下拉单选 | 是 | — | 超管定义的角色列表 | — |
| 是否自定义权限 | 开关 | 否 | 否 | — | 开启后显示四级权限树 |
| 数据权限范围 | 下拉单选 | 是 | 本班组 | 固定选项 | 本班组/指定区域 |

### 通知触发

| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|----------|----------|----------|----------|----------|
| 下属账号创建 | 下属人员 | 小程序推送 | 账号开通通知 | 03-物业公司 §4 |
| 角色变更 | 下属人员 | Redis Pub/Sub | 权限实时生效 | 03-物业公司 §4 |
| 账号禁用 | 下属人员 | — | session失效+小程序下线 | 03-物业公司 §4 |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 列表查询 | /api/v1/subordinates | GET | — |
| 新增 | /api/v1/subordinates | POST | — |
| 分配角色 | /api/v1/subordinates/{id}/assign-role | PUT | — |
| 权限覆盖 | /api/v1/subordinates/{id}/override-permissions | PUT | 四级树形权限 |
| 批量操作 | /api/v1/subordinates/batch | POST | 批量启停/分配角色 |

---

## 需求追溯

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| PR-O-01 | 班组管理 | 02-物业公司 §4 | 班组→人员分配→排班 | 巡检管理(巡检班组) / 保洁管理(保洁班组) |
| PR-O-02 | 人员管理 | 02-物业公司 §4 | 人员→技能标签→工单分配 | 在线报修(维修人员) |
| PR-O-03 | 人员分配 | 02-物业公司 §4 | 分配→班组关联 | 班组管理 / 技能管理 |
| PR-O-04 | 排班管理 | 02-物业公司 §4 | 排班→保洁任务生成 | 保洁管理(排班) / 小程序端我的排班(MP-OR-02) |
| PR-O-05 | 技能管理 | 02-物业公司 §4 | 技能→工单自动分配依据 | 在线报修(自动分配) |
| PR-O-06 | 打卡点分配 | 02-物业公司 §4 | 打卡点→考勤蓝牙绑定 | 考勤打卡(打卡点管理) / 系统配置(蓝牙设备) |
| PR-O-07 | 下属账号管理 | 02-物业公司 §4 / 03-物业公司 §4 | 创建下属→分配角色→权限覆盖 | 超管权限管理(角色定义) |
| PR-O-08 | 下属角色分配 | 02-物业公司 §4 | 选择超管定义的角色→分配 | 超管权限管理(角色管理) |
| PR-O-09 | 下属权限覆盖 | 02-物业公司 §4 / 03-物业公司 §4 | 在角色基础上调整权限(四级树形) | 超管权限管理(权限分配) |
| PR-O-10 | 下属批量操作 | 02-物业公司 §4 | 批量启停/分配角色 | — |
| PR-O-11 | 下属数据权限 | 02-物业公司 §4 / 01 §1.3 | 设置数据可见范围 | 数据权限校验 |

## 业务规则

1. **一人多班组**：支持一个人员属于多个班组（来源：02-物业公司 PR-O-02）
2. **下属角色来源于超管**：物业公司管理员从超管定义的角色中选择，分配给下属（来源：03-物业公司 §4 / 01 §8.4）
3. **权限覆盖**：可在角色权限基础上自定义调整，使用四级树形勾选（来源：03-物业公司 §4）
4. **下属不单独设有效期**：随物业公司管理员账号到期而自动失效（来源：01 §1.4）
5. **数据权限**：主管仅看本班组数据，员工仅看本人数据（来源：01 §1.3）
6. **权限实时生效**：角色/权限变更后毫秒级生效，无需重新登录（来源：01 §8.3）
7. **操作日志**：下属创建、角色分配、权限覆盖均记录审计日志（来源：06 §4.5）