ether-docs/01-REQUIREMENTS/menu-and-permission.md

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

---