386 lines
21 KiB
Markdown
386 lines
21 KiB
Markdown
# Ether 系统菜单规划与角色权限
|
||
|
||
**文档版本**: v3.0
|
||
**更新日期**: 2026-02-27
|
||
|
||
---
|
||
|
||
## 1. 菜单结构规划
|
||
|
||
### 1.1 菜单排序原则
|
||
|
||
| 排序规则 | 说明 |
|
||
| ------------ | ------------------------------------------------------------- |
|
||
| 业务流程优先 | 按业务流程顺序排列（项目→合同→设备→巡检→工单→业主→访客→收费） |
|
||
| 系统管理次之 | 用户、角色、权限等系统配置 |
|
||
|
||
### 1.2 菜单结构
|
||
|
||
```
|
||
├── 项目管理 (sortOrder: 1)
|
||
│ └── 空间管理（含车位、公共设施）
|
||
├── 合同管理 (sortOrder: 2)
|
||
├── 设备管理 (sortOrder: 3)
|
||
├── 巡检管理 (sortOrder: 4)
|
||
│ ├── 巡检计划
|
||
│ ├── 巡检任务
|
||
│ └── 巡检点管理
|
||
├── 工单管理 (sortOrder: 5)
|
||
│ ├── 工单列表
|
||
│ └── 工单统计
|
||
├── 业主管理 (sortOrder: 6)
|
||
│ ├── 业主列表
|
||
│ └── 家庭成员
|
||
├── 访客管理 (sortOrder: 7)
|
||
│ ├── 访客预约
|
||
│ └── 访客记录
|
||
├── 收费管理 (sortOrder: 8)
|
||
│ ├── 账单管理
|
||
│ └── 缴费记录
|
||
├── 用户管理 (sortOrder: 10)
|
||
├── 角色管理 (sortOrder: 11)
|
||
├── 权限管理 (sortOrder: 12)
|
||
└── 系统管理 (sortOrder: 13)
|
||
```
|
||
|
||
---
|
||
|
||
## 2. 角色体系设计
|
||
|
||
### 2.1 角色总览
|
||
|
||
| 类型 | 角色编码 | 角色名称 | 数据范围 | 终端类型 | 一线人员 |
|
||
| ------------ | ----------------- | ---------- | ---------- | ----------- | -------- |
|
||
| **系统级** |
|
||
| 系统管理 | SUPER_ADMIN | 超级管理员 | ALL | ALL | 否 |
|
||
| 系统管理 | SYS_ADMIN | 系统管理员 | ALL | ADMIN_ONLY | 否 |
|
||
| **项目管理** |
|
||
| 项目管理 | PROPERTY_MANAGER | 物业经理 | PROJECT | ALL | 否 |
|
||
| 项目管理 | PROJECT_MANAGER | 项目经理 | PROJECT | ALL | 否 |
|
||
| **部门主管** |
|
||
| 工程管理 | ENGINEERING_LEAD | 工程主管 | DEPARTMENT | ALL | 否 |
|
||
| 安保管理 | SECURITY_LEAD | 安保主管 | DEPARTMENT | ALL | 否 |
|
||
| 保洁管理 | CLEANING_LEAD | 保洁主管 | DEPARTMENT | ALL | 否 |
|
||
| 财务管理 | FINANCE_LEAD | 财务主管 | DEPARTMENT | ALL | 否 |
|
||
| **一线执行** |
|
||
| 工程执行 | MAINTENANCE_STAFF | 维修人员 | SELF | MOBILE_ONLY | 是 |
|
||
| 安保执行 | SECURITY_STAFF | 安保人员 | SELF | MOBILE_ONLY | 是 |
|
||
| 保洁执行 | CLEANING_STAFF | 保洁人员 | SELF | MOBILE_ONLY | 是 |
|
||
| **服务支持** |
|
||
| 业主服务 | CS_STAFF | 客服人员 | PROJECT | ALL | 否 |
|
||
| **外部用户** |
|
||
| 业主 | OWNER | 业主 | SELF | OWNER_APP | 否 |
|
||
|
||
### 2.2 角色职责说明
|
||
|
||
#### 2.2.1 系统级角色
|
||
|
||
| 角色 | 职责范围 | 典型场景 |
|
||
| -------------- | -------------------------------- | ------------------------------ |
|
||
| **超级管理员** | 系统最高权限，管理所有项目和用户 | 系统初始化、用户创建、项目创建 |
|
||
| **系统管理员** | 系统配置管理，不参与业务操作 | 系统参数配置、日志查看 |
|
||
|
||
#### 2.2.2 项目管理角色
|
||
|
||
| 角色 | 职责范围 | 典型场景 |
|
||
| ------------ | -------------------------------------- | -------------------------------- |
|
||
| **物业经理** | 项目经营第一负责人，拥有本项目全部权限 | 项目整体运营、费用审核、合同审批 |
|
||
| **项目经理** | 单项目管理，拥有本项目全部业务权限 | 工单管理、人员分配、报表查看 |
|
||
|
||
#### 2.2.3 部门主管角色
|
||
|
||
| 角色 | 管理模块 | 职责范围 | 典型场景 |
|
||
| ------------ | -------------------- | ------------------ | -------------------------------- |
|
||
| **工程主管** | 工单、设备、工程巡检 | 本部门工程事务管理 | 工单分配、设备管理、巡检计划制定 |
|
||
| **安保主管** | 安保巡检、访客管理 | 本部门安保事务管理 | 安保巡检计划、访客核验监督 |
|
||
| **保洁主管** | 保洁巡检、品质检查 | 本部门保洁事务管理 | 保洁巡检计划、品质检查 |
|
||
| **财务主管** | 账单、收费、费用审核 | 本部门财务事务管理 | 账单生成、费用审核、报表导出 |
|
||
|
||
#### 2.2.4 一线执行角色
|
||
|
||
| 角色 | 执行范围 | 终端限制 | 典型场景 |
|
||
| ------------ | ------------------ | -------- | ------------------------------ |
|
||
| **维修人员** | 工单处理、设备巡检 | 仅移动端 | 接单、维修、填报费用、设备巡检 |
|
||
| **安保人员** | 安保巡检、访客核验 | 仅移动端 | 扫码签到、访客核验、异常报送 |
|
||
| **保洁人员** | 保洁巡检、品质检查 | 仅移动端 | 扫码签到、品质异常报送 |
|
||
|
||
#### 2.2.5 服务支持角色
|
||
|
||
| 角色 | 职责范围 | 典型场景 |
|
||
| ------------ | ---------------------------- | -------------------------------- |
|
||
| **客服人员** | 业主服务接口，不参与工单流程 | 业主咨询、资料维护、访客辅助核验 |
|
||
|
||
#### 2.2.6 外部用户角色
|
||
|
||
| 角色 | 权限范围 | 典型场景 |
|
||
| -------- | ---------------- | ------------------------------ |
|
||
| **业主** | 本人房产相关数据 | 在线报修、缴费、访客邀请、评价 |
|
||
|
||
---
|
||
|
||
## 3. 菜单权限矩阵
|
||
|
||
### 3.1 菜单可见性矩阵
|
||
|
||
| 菜单 | 超级管理员 | 物业经理 | 项目经理 | 工程主管 | 安保主管 | 保洁主管 | 财务主管 | 维修人员 | 安保人员 | 保洁人员 | 客服人员 | 业主 |
|
||
| -------- | :--------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :--: |
|
||
| 项目管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||
| 合同管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||
| 设备管理 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | 👁️ | ❌ | ❌ | 👁️ | ❌ |
|
||
| 巡检管理 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅\* | ✅\* | ✅\* | ❌ | ❌ |
|
||
| 工单管理 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅\* | ❌ | ❌ | ❌ | ✅\* |
|
||
| 业主管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
|
||
| 访客管理 | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅\* | ❌ | ✅ | ✅\* |
|
||
| 收费管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | 👁️ | ✅\* |
|
||
| 用户管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||
| 角色管理 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||
| 权限管理 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||
| 系统管理 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||
|
||
**图例说明**：
|
||
|
||
- ✅ 完全权限（可查看、可操作）
|
||
- 👁️ 只读权限（仅查看）
|
||
- ✅\* 受限权限（仅本人相关数据）
|
||
- ❌ 无权限（菜单不可见）
|
||
|
||
### 3.2 菜单权限详细说明
|
||
|
||
| 菜单 | 维修人员 | 安保人员 | 保洁人员 | 客服人员 | 业主 |
|
||
| ------------ | ---------------------- | ---------------------- | ---------------------- | ---------------- | -------------------- |
|
||
| **巡检管理** | 仅查看分配给自己的任务 | 仅查看分配给自己的任务 | 仅查看分配给自己的任务 | 不可见 | 不可见 |
|
||
| **工单管理** | 仅查看分配给自己的工单 | 不可见 | 不可见 | 不可见 | 仅查看本人提交的工单 |
|
||
| **访客管理** | 不可见 | 仅查看待核验访客 | 不可见 | 可查看全部访客 | 仅查看本人邀请的访客 |
|
||
| **收费管理** | 不可见 | 不可见 | 不可见 | 仅查看，不可操作 | 仅查看本人账单 |
|
||
|
||
---
|
||
|
||
## 4. 按钮级权限矩阵
|
||
|
||
### 4.1 工单管理按钮权限
|
||
|
||
| 操作按钮 | 物业经理 | 项目经理 | 工程主管 | 维修人员 | 业主 |
|
||
| -------- | :------: | :------: | :------: | :------: | :--: |
|
||
| 新增工单 | ✅ | ✅ | ✅ | ✅\* | ✅ |
|
||
| 编辑工单 | ✅ | ✅ | ✅ | ❌ | ❌ |
|
||
| 删除工单 | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
| 分配工单 | ✅ | ✅ | ✅ | ❌ | ❌ |
|
||
| 接单 | ❌ | ❌ | ❌ | ✅ | ❌ |
|
||
| 开始处理 | ❌ | ❌ | ❌ | ✅ | ❌ |
|
||
| 完成工单 | ✅ | ✅ | ✅ | ✅ | ❌ |
|
||
| 转单 | ✅ | ✅ | ✅ | ✅\*\* | ❌ |
|
||
| 关闭工单 | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
| 评价工单 | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||
| 填报费用 | ✅ | ✅ | ✅ | ✅ | ❌ |
|
||
| 费用审核 | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
|
||
**说明**：
|
||
|
||
- ✅\* 维修人员仅能创建"自发现"类型工单
|
||
- ✅\*\* 维修人员仅能申请转单，需主管审批
|
||
|
||
### 4.2 巡检管理按钮权限
|
||
|
||
| 操作按钮 | 物业经理 | 工程主管 | 安保主管 | 保洁主管 | 维修人员 | 安保人员 | 保洁人员 |
|
||
| ---------- | :------: | :------: | :------: | :------: | :------: | :------: | :------: |
|
||
| 创建计划 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
| 编辑计划 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
| 删除计划 | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||
| 分配任务 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
| 开始巡检 | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
|
||
| 完成巡检 | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
|
||
| 强制闭环 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
| 生成二维码 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
|
||
### 4.3 设备管理按钮权限
|
||
|
||
| 操作按钮 | 物业经理 | 工程主管 | 维修人员 | 客服人员 |
|
||
| ---------- | :------: | :------: | :------: | :------: |
|
||
| 新增设备 | ✅ | ✅ | ❌ | ❌ |
|
||
| 编辑设备 | ✅ | ✅ | ❌ | ❌ |
|
||
| 删除设备 | ✅ | ❌ | ❌ | ❌ |
|
||
| 报告故障 | ✅ | ✅ | ✅ | ✅ |
|
||
| 生成二维码 | ✅ | ✅ | ❌ | ❌ |
|
||
| 扫码查看 | ✅ | ✅ | ✅ | ❌ |
|
||
|
||
### 4.4 访客管理按钮权限
|
||
|
||
| 操作按钮 | 物业经理 | 安保主管 | 安保人员 | 客服人员 | 业主 |
|
||
| ------------ | :------: | :------: | :------: | :------: | :--: |
|
||
| 创建访客邀请 | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||
| 访客核验 | ✅ | ✅ | ✅ | ✅ | ❌ |
|
||
| 取消访客邀请 | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||
| 查看访客记录 | ✅ | ✅ | ✅\* | ✅ | ✅\* |
|
||
|
||
**说明**：
|
||
|
||
- ✅\* 安保人员仅查看待核验访客，业主仅查看本人邀请的访客
|
||
|
||
### 4.5 收费管理按钮权限
|
||
|
||
| 操作按钮 | 物业经理 | 财务主管 | 客服人员 | 业主 |
|
||
| -------- | :------: | :------: | :------: | :--: |
|
||
| 新增账单 | ✅ | ✅ | ❌ | ❌ |
|
||
| 编辑账单 | ✅ | ✅ | ❌ | ❌ |
|
||
| 删除账单 | ❌ | ❌ | ❌ | ❌ |
|
||
| 费用减免 | ✅ | ✅ | ❌ | ❌ |
|
||
| 导出账单 | ✅ | ✅ | ❌ | ❌ |
|
||
| 缴费 | ❌ | ❌ | ❌ | ✅ |
|
||
|
||
---
|
||
|
||
## 5. 数据权限设计
|
||
|
||
### 5.1 数据范围级别
|
||
|
||
| 数据范围 | 编码 | 说明 | SQL预设 |
|
||
| -------- | ---------- | ------------ | ----------------------------------------------------------------- |
|
||
| 全部 | ALL | 所有项目数据 | `WHERE 1=1` |
|
||
| 项目 | PROJECT | 本项目数据 | `WHERE project_id = $current_project` |
|
||
| 部门 | DEPARTMENT | 本部门数据 | `WHERE project_id = $current_project AND dept_id = $current_dept` |
|
||
| 本人 | SELF | 仅本人数据 | `WHERE assigned_to = $current_user` |
|
||
|
||
### 5.2 角色数据范围映射
|
||
|
||
| 角色 | 数据范围 | 可见数据 |
|
||
| ---------- | ---------- | -------------------------- |
|
||
| 超级管理员 | ALL | 所有项目的全部数据 |
|
||
| 系统管理员 | ALL | 系统配置数据 |
|
||
| 物业经理 | PROJECT | 本项目全部数据 |
|
||
| 项目经理 | PROJECT | 本项目全部数据 |
|
||
| 工程主管 | DEPARTMENT | 本部门工单、设备、巡检数据 |
|
||
| 安保主管 | DEPARTMENT | 本部门安保巡检、访客数据 |
|
||
| 保洁主管 | DEPARTMENT | 本部门保洁巡检数据 |
|
||
| 财务主管 | DEPARTMENT | 本部门账单、收费数据 |
|
||
| 维修人员 | SELF | 分配给自己的工单和巡检任务 |
|
||
| 安保人员 | SELF | 分配给自己的巡检任务 |
|
||
| 保洁人员 | SELF | 分配给自己的巡检任务 |
|
||
| 客服人员 | PROJECT | 本项目业主、访客数据 |
|
||
| 业主 | SELF | 本人房产相关数据 |
|
||
|
||
---
|
||
|
||
## 6. 菜单详细配置
|
||
|
||
| 菜单名称 | 路由路径 | 图标 | 排序 | 权限代码 |
|
||
| -------- | ------------------- | ------------------ | ---- | ---------------------- |
|
||
| 项目管理 | /mdm/projects | HomeOutlined | 1 | system:project:menu |
|
||
| 合同管理 | /mdm/contract | FileTextOutlined | 2 | mdm:contract:menu |
|
||
| 设备管理 | /mdm/equipments | ToolOutlined | 3 | mdm:equipment:menu |
|
||
| 巡检管理 | /mdm/inspections | FileSearchOutlined | 4 | mdm:inspection:menu |
|
||
| 工单管理 | /ops/work-order | FileTextOutlined | 5 | ops:work-order:menu |
|
||
| 业主管理 | /mdm/owners | TeamOutlined | 6 | mdm:owner:menu |
|
||
| 访客管理 | /mdm/visitors | UserAddOutlined | 7 | mdm:visitor:menu |
|
||
| 收费管理 | /mdm/fee | DollarOutlined | 8 | mdm:fee:menu |
|
||
| 用户管理 | /system/users | UserOutlined | 10 | system:user:menu |
|
||
| 角色管理 | /system/roles | TeamOutlined | 11 | system:role:menu |
|
||
| 权限管理 | /system/permissions | SafetyOutlined | 12 | system:permission:menu |
|
||
| 系统管理 | /system/settings | SettingOutlined | 13 | system:settings:menu |
|
||
|
||
---
|
||
|
||
## 7. 特殊说明
|
||
|
||
### 7.1 超级管理员
|
||
|
||
- 超级管理员是系统级角色（project_id = NULL）
|
||
- 可以看到所有项目的数据
|
||
- 不显示项目选择器
|
||
- 只显示系统管理相关菜单
|
||
|
||
### 7.2 项目管理角色（物业经理/项目经理）
|
||
|
||
- 需要先选择项目才能访问业务功能
|
||
- 可以管理本项目内的所有用户和业务数据
|
||
- 不能创建/删除项目，不能管理系统角色和权限
|
||
|
||
### 7.3 部门主管角色
|
||
|
||
- 只能看到本部门的数据
|
||
- 可以分配工单给本部门员工
|
||
- 可以查看本部门的统计数据
|
||
- 各主管仅管理自己负责的业务模块
|
||
|
||
### 7.4 一线执行角色
|
||
|
||
- 只能处理分配给自己的工单和任务
|
||
- 使用移动端APP进行操作
|
||
- 可以创建巡检记录和工单反馈
|
||
- 不能查看统计数据
|
||
|
||
### 7.5 客服人员
|
||
|
||
- 不参与工单流程
|
||
- 主要职责是业主服务
|
||
- 查看业主信息时敏感字段脱敏
|
||
- 可协助访客核验
|
||
|
||
### 7.6 业主用户
|
||
|
||
- 只能查看自己的缴费信息
|
||
- 可以提交工单
|
||
- 可以邀请访客
|
||
- 可以评价工单
|
||
|
||
---
|
||
|
||
## 8. 业务流程角色模拟
|
||
|
||
### 8.1 业主报修工单流程
|
||
|
||
| 步骤 | 操作 | 角色 | 权限编码 |
|
||
| ---- | ---------------- | ----------------- | ------------------------- |
|
||
| 1 | 业主提交报修 | 业主 | 无（自有房产） |
|
||
| 2 | 工单分配 | 项目经理/工程主管 | ops:work_order:assign |
|
||
| 3 | 维修工接单 | 维修人员 | ops:work_order:accept |
|
||
| 4 | 开始处理 | 维修人员 | ops:work_order:start |
|
||
| 5 | 完成工单 | 维修人员 | ops:work_order:complete |
|
||
| 6 | 填报费用（如有） | 维修人员 | ops:work_order:report_fee |
|
||
| 7 | 费用审核（如有） | 项目经理/财务主管 | ops:work_order:audit_fee |
|
||
| 8 | 业主评价 | 业主 | 无（仅报修人） |
|
||
| 9 | 关闭工单 | 项目经理 | ops:work_order:close |
|
||
|
||
### 8.2 巡检任务流程
|
||
|
||
| 步骤 | 操作 | 角色 | 权限编码 |
|
||
| ---- | ---------------- | -------------------------- | ------------------------------- |
|
||
| 1 | 制定巡检计划 | 工程主管/安保主管/保洁主管 | ops:inspection_plan:create |
|
||
| 2 | 任务分配 | 主管 | ops:inspection_task:assign |
|
||
| 3 | 扫码开始巡检 | 维修/安保/保洁人员 | ops:inspection_task:start |
|
||
| 4 | 提交巡检结果 | 执行人员 | ops:inspection_task:complete |
|
||
| 5 | 强制闭环（逾期） | 主管 | ops:inspection_task:force_close |
|
||
|
||
### 8.3 访客来访流程
|
||
|
||
| 步骤 | 操作 | 角色 | 权限编码 |
|
||
| ---- | ------------ | ----------------- | ------------------ |
|
||
| 1 | 业主邀请访客 | 业主 | 无（自有房产） |
|
||
| 2 | 门岗核验 | 安保人员 | mdm:visitor:verify |
|
||
| 3 | 异常处理 | 客服人员/安保人员 | mdm:visitor:verify |
|
||
|
||
### 8.4 费用收缴流程
|
||
|
||
| 步骤 | 操作 | 角色 | 权限编码 |
|
||
| ---- | -------- | ----------------- | ------------------- |
|
||
| 1 | 生成账单 | 财务主管 | finance:bill:create |
|
||
| 2 | 业主缴费 | 业主 | 无（自有房产） |
|
||
| 3 | 费用减免 | 物业经理/财务主管 | finance:bill:reduce |
|
||
| 4 | 账单导出 | 财务主管 | finance:bill:export |
|
||
|
||
---
|
||
|
||
## 9. 变更记录
|
||
|
||
| 日期 | 变更内容 | 变更人 |
|
||
| ---------- | ---------------------------------- | ------------ |
|
||
| 2026-02-18 | 更新菜单排序为业务流程顺序 | AI Assistant |
|
||
| 2026-02-18 | 添加主数据模块说明 | AI Assistant |
|
||
| 2026-02-18 | 移除独立的空间节点管理菜单 | AI Assistant |
|
||
| 2026-02-27 | 重构角色体系，新增13个角色 | AI Assistant |
|
||
| 2026-02-27 | 新增按钮级权限矩阵 | AI Assistant |
|
||
| 2026-02-27 | 新增数据权限设计 | AI Assistant |
|
||
| 2026-02-27 | 新增业务流程角色模拟 | AI Assistant |
|
||
| 2026-02-27 | 调整客服人员职责，不再参与工单流程 | AI Assistant |
|
||
|
||
---
|