rlz/docs/角色权限矩阵.md

瑞来健康 — 角色权限矩阵

更新日期: 2026-06-08

---

一、角色定义

role_id	role_key	角色名称	user_type	适用端
1	admin	超级管理员	0C	管理后台
2	common	普通用户	00	小程序
103	operations	运营经理	03	管理后台/小程序
104	service	客服专员	04	管理后台/小程序
105	dispatcher	调度员	05	管理后台/小程序
106	promoter	推广员	06	管理后台/小程序
-	caregiver	陪诊师	01	小程序/App
-	patient	患者/客户	00	小程序

---

二、用户类型 (user_type) 枚举

user_type	名称	说明
00	患者/客户	需要陪诊服务的用户
01	陪诊师	提供陪诊服务的从业人员
03	运营经理	管理指定区域业务
04	客服专员	处理退款/纠纷工单
05	调度员	订单派单与陪诊师调度
06	推广员	推广获客赚佣金
0B	机构	医疗机构/合作伙伴
0C	管理员	平台超级管理员

---

三、管理后台菜单权限

菜单	超级管理员	运营经理	客服	调度员	推广员
系统管理-用户管理	O	O	-	-	-
系统管理-角色管理	O	-	-	-	-
系统管理-菜单管理	O	-	-	-	-
系统管理-部门管理	O	-	-	-	-
系统管理-岗位管理	O	-	-	-	-
系统管理-字典管理	O	O	-	-	-
系统管理-通知公告	O	O	O	O	O
系统管理-医院管理	O	O	-	-	-
系统管理-服务类型	O	O	-	-	-
推广管理	O	O	-	-	O
区域管理	O	O	-	-	-
调度管理	O	O	-	O	-
财务管理-退款审核	O	O	O	-	-
财务管理-结算管理	O	O	-	-	-
财务管理-平台配置	O	O	-	-	-
财务管理-分润记录	O	O	O	O	O
财务管理-收益明细	O	O	-	-	-
运营看板	O	O	-	-	-

O = 有权限, - = 无权限

---

四、API 权限 (@PreAuthorize)

4.1 推广服务 /system/promotion/**

端点	方法	权限	admin	ops	service	dispatcher	promoter
/list	GET	-	O	O	-	-	-
/relations	GET	-	O	O	-	-	-
/{id}	GET	-	O	O	-	-	-
/data/{userId}	GET	-	O	O	-	-	-
/byInvited/{id}	GET	-	O	O	-	-	-
/byPromoter/{id}	GET	-	O	O	-	-	-
POST /	POST	system:promotion:add	O	-	-	-	-
PUT /	PUT	system:promotion:edit	O	-	-	-	-
DELETE /{ids}	DELETE	system:promotion:remove	O	-	-	-	-
/myStats	GET	-	O	O	O	O	O
/team	GET	-	O	O	O	O	O
/myCommission	GET	-	O	O	O	O	O
/generateCode	POST	-	O	O	O	O	O

4.2 分润服务 /system/profit/**

端点	方法	权限	admin	ops	service	dispatcher	promoter
/list	GET	-	O	O	-	-	-
/stats	GET	-	O	O	O	-	-
/{id}	GET	-	O	O	-	-	-
/byOrder/{id}	GET	-	O	O	O	O	O
/byUser/{id}	GET	-	O	O	O	O	O
/balance/{id}	GET	-	O	O	O	O	O
/myRecords	GET	-	O	O	O	O	O
/myBalance	GET	-	O	O	O	O	O
POST /calculate/{id}	POST	system:profit:calculate	O	-	-	-	-
POST /reverse/{id}	POST	system:profit:reverse	O	-	-	-	-

4.3 调度服务 /system/dispatch/**

端点	方法	权限	admin	ops	dispatcher
/pending	GET	system:dispatch:list	O	O	O
/caregivers	GET	system:dispatch:list	O	O	O
/caregivers/{hospitalId}	GET	system:dispatch:list	O	O	O
/history	GET	system:dispatch:list	O	O	O
/assign/{orderId}/{cgId}	POST	system:dispatch:assign	O	O	O

4.4 区域服务 /system/region/**

端点	方法	权限	admin	ops
/list	GET	-	O	O
/stats	GET	-	O	O
/{id}	GET	-	O	O
/children/{id}	GET	-	O	O
POST /	POST	system:region:add	O	-
PUT /	PUT	system:region:edit	O	-
DELETE /{ids}	DELETE	system:region:remove	O	-

4.5 退款流程

端点	方法	权限	admin	ops	service
/system/order/applyRefund/{id}	POST	-	O	O	O
/system/order/refundOrder/{id}	GET	-	O	O	O
/system/view/refundApprove/{id}	PUT	system:order:edit	O	O	O

---

五、数据权限隔离

角色	数据范围
超级管理员	全部数据
运营经理	本区域(region_id)及其下级区域数据
客服专员	全部退款工单(无区域限制)
调度员	本区域的待派单订单 + 自己的派单记录
推广员	自己的推广关系 + 团队数据 + 佣金记录
陪诊师	自己的订单 + 服务收入
患者	自己的订单 + 支付记录

---

六、小程序/App 角色功能权限

功能	患者	陪诊师	推广员	调度员	客服	运营
浏览服务/下单	O	-	-	-	-	-
查看我的订单	O	-	-	-	-	-
支付/退款申请	O	-	-	-	-	-
接单/拒单	-	O	-	-	-	-
开始/完成服务	-	O	-	-	-	-
查看收入/余额	-	O	O	-	-	-
提现	-	O	O	-	-	-
推广看板	-	-	O	-	-	-
我的团队	-	-	O	-	-	-
佣金明细	-	-	O	-	-	-
生成邀请码	-	-	O	-	-	-
调度面板	-	-	-	O	-	-
指派/改派	-	-	-	O	-	-
退款审核	-	-	-	-	O	-
运营看板	-	-	-	-	-	O
区域数据	-	-	-	-	-	O
角色切换	O	O	O	O	O	O

---

七、权限配置检查清单

部署后验证以下内容:

• 各角色能登录对应端(管理后台/小程序/App)
• 管理后台菜单根据角色正确显示/隐藏
• API @PreAuthorize 权限校验生效(无权限返回 403)
• 数据权限隔离: 运营经理只看本区域, 陪诊师只看自己订单
• 小程序 TabBar 根据 user_type 正确渲染
• 角色切换后功能权限同步更新