permissions.js 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220
  1. /**
  2. * 角色→权限映射表(《角色权限与菜单归类整合方案》B-4)
  3. * 每个角色映射一组权限标识,支持通配符 '*' 和前缀通配 'prefix:*'
  4. *
  5. * 平台角色: admin / operator / finance
  6. * 入驻角色: butler / knowledge_admin / teacher / nutritionist / supplier / activity_manager
  7. * 遗留角色: article_manager / activity_admin / supplier_admin(历史数据兼容)
  8. */
  9. const ROLE_PERMISSIONS = {
  10. // 超管:全部权限
  11. admin: ['*'],
  12. // 运营:审核全量、活动全量、任务全量、家庭/商城/知识/测评只读、组织管理
  13. operator: ['dashboard', 'audit:*', 'activity:*', 'task:*', 'assessment:read', 'family:read', 'commerce:read', 'articles:read', 'knowledge:read', 'plan:*', 'org:*'],
  14. // 财务:财务/退款/提现、订单只读、CF值、商城营销、业务管理、组织管理
  15. finance: ['dashboard', 'finance:*', 'audit:withdraw', 'audit:refund', 'commerce:read', 'commerce:orders:read', 'biz:*', 'cf-value:*', 'org:*'],
  16. // 管家:家庭客服 + 规划师 + 营养师权限并集(getEffectivePermissions 中自动并入 teacher/nutritionist)
  17. butler: ['dashboard', 'family:*', 'task:*', 'reward:*', 'service:*', 'growth:*', 'biz:*',
  18. 'assessment:dan', 'health:*', 'diet:*', 'report:audit', 'plan:*'],
  19. // 知识管理员
  20. knowledge_admin: ['dashboard', 'articles:*', 'knowledge:*'],
  21. // 成长规划师
  22. teacher: ['dashboard', 'service:*', 'growth:*', 'biz:*', 'assessment:dan', 'family:bound', 'messages', 'plan:health'],
  23. // 营养师
  24. nutritionist: ['dashboard', 'health:*', 'diet:*', 'report:audit', 'service:family', 'biz:orders', 'messages', 'plan:*'],
  25. // 供应商(仅自己的商品/库存/订单/结算)+ 业务管理
  26. supplier: ['dashboard', 'commerce:self', 'inventory:self', 'order:self', 'settlement:self', 'supply:member', 'biz:*'],
  27. // 活动管理员(仅自己的活动)+ 业务管理
  28. activity_manager: ['dashboard', 'activity:self', 'activity:registration', 'biz:*'],
  29. // 组织管理员(仅自身组织数据)
  30. org_admin: ['dashboard', 'org:*'],
  31. // ---- 遗留角色兼容(与后端 AdminRoles.normalize 对应)----
  32. article_manager: ['dashboard', 'articles:*', 'knowledge:*'],
  33. activity_admin: ['dashboard', 'activity:self', 'activity:registration'],
  34. supplier_admin: ['dashboard', 'commerce:self', 'inventory:self', 'order:self', 'settlement:self', 'supply:member'],
  35. }
  36. /**
  37. * 遗留角色 → 新角色归一化(与后端 AdminRoles.normalize 保持一致)
  38. */
  39. function normalizeRole(role) {
  40. if (!role) return role
  41. if (role === 'activity_admin') return 'activity_manager'
  42. if (role === 'article_admin' || role === 'article_manager') return 'knowledge_admin'
  43. if (role === 'supplier_admin') return 'supplier'
  44. return role
  45. }
  46. /**
  47. * 获取用户有效权限列表
  48. * butler 单向兼容:分配 butler 时自动附带 teacher 与 nutritionist 的权限(权限求并集,角色记录仍为 butler)
  49. * @param {string[]} roles - 用户拥有的角色列表
  50. * @returns {string[]} - 去重后的权限标识列表
  51. */
  52. export function getEffectivePermissions(roles) {
  53. if (!roles || roles.length === 0) return []
  54. const permSet = new Set()
  55. const normalizedRoles = []
  56. for (let i = 0; i < roles.length; i++) {
  57. const normalized = normalizeRole(roles[i])
  58. normalizedRoles.push(normalized)
  59. }
  60. for (const role of normalizedRoles) {
  61. const perms = ROLE_PERMISSIONS[role]
  62. if (perms) {
  63. for (const p of perms) {
  64. permSet.add(p)
  65. }
  66. }
  67. }
  68. // B-2 单向兼容:butler 附带 teacher + nutritionist 权限并集
  69. if (normalizedRoles.indexOf('butler') >= 0) {
  70. const union = [].concat(ROLE_PERMISSIONS.teacher || [], ROLE_PERMISSIONS.nutritionist || [])
  71. for (const p of union) {
  72. permSet.add(p)
  73. }
  74. }
  75. return Array.from(permSet)
  76. }
  77. /**
  78. * 判断是否拥有指定权限
  79. * @param {string[]} userPerms - 用户的有效权限列表
  80. * @param {string} required - 需要的权限标识(支持 'prefix:*' 通配、逗号分隔多值任一匹配)
  81. * @returns {boolean}
  82. *
  83. * 匹配规则:
  84. * - '*' → 全部放行
  85. * - required 含逗号 → 任一命中即通过(如 'family:read,family:bound')
  86. * - 精确匹配
  87. * - required 为单段(组级权限如 'audit')→ 拥有 'audit:*' 或任何 'audit:xxx' 即通过
  88. * - required 为 'p:*'(模块通配)→ 拥有 'p:*' 或任何 'p:xxx' 即通过(模块只读/自管可见)
  89. * - required 为 'p:sub' → 拥有 'p:*'、'p:read'(模块只读)或任何以 'p:sub:' 开头的更具体权限即通过
  90. */
  91. export function hasPermission(userPerms, required) {
  92. if (!userPerms || !required) return false
  93. if (userPerms.indexOf('*') >= 0) return true
  94. // 逗号分隔多值:任一命中即通过
  95. if (required.indexOf(',') >= 0) {
  96. const parts = required.split(',')
  97. for (let i = 0; i < parts.length; i++) {
  98. if (matchSingle(userPerms, parts[i].trim())) return true
  99. }
  100. return false
  101. }
  102. return matchSingle(userPerms, required)
  103. }
  104. function matchSingle(userPerms, required) {
  105. if (!required) return false
  106. // 精确匹配
  107. if (userPerms.indexOf(required) >= 0) return true
  108. const colonIndex = required.indexOf(':')
  109. if (colonIndex < 0) {
  110. // 组级权限 'audit':拥有 'audit:*' 或任何 'audit:xxx'
  111. if (userPerms.indexOf(required + ':*') >= 0) return true
  112. for (let i = 0; i < userPerms.length; i++) {
  113. if (userPerms[i].indexOf(required + ':') === 0) return true
  114. }
  115. return false
  116. }
  117. const prefix = required.substring(0, colonIndex)
  118. if (colonIndex === required.length - 2 && required.charAt(required.length - 1) === '*') {
  119. // 模块通配 'p:*':拥有 'p:*' 或任何 'p:xxx'
  120. if (userPerms.indexOf(prefix + ':*') >= 0) return true
  121. for (let i = 0; i < userPerms.length; i++) {
  122. if (userPerms[i].indexOf(prefix + ':') === 0) return true
  123. }
  124. return false
  125. }
  126. // 具体权限 'p:sub'
  127. // 1) 拥有模块通配 'p:*'
  128. if (userPerms.indexOf(prefix + ':*') >= 0) return true
  129. for (let i = 0; i < userPerms.length; i++) {
  130. const perm = userPerms[i]
  131. // 2) 模块只读 'p:read' 可见模块内页面(数据安全由后端行级隔离保证)
  132. if (perm === prefix + ':read') return true
  133. // 3) 拥有更具体权限 'p:sub:xxx' 蕴含粗粒度 'p:sub'(如 finance:cf-value:read → cf-value:manage 场景由通配覆盖)
  134. if (perm.indexOf(required + ':') === 0) return true
  135. }
  136. return false
  137. }
  138. /**
  139. * 入驻角色(登录后默认首页为个人版看板)
  140. */
  141. export const RESIDENT_ROLES = ['butler', 'knowledge_admin', 'teacher', 'nutritionist', 'supplier', 'activity_manager', 'org_admin']
  142. /**
  143. * 入驻角色默认首页(登录后/访问 /dashboard 时跳转到个人工作台,B-6)
  144. * 平台角色(admin/operator/finance)返回 '/' 即平台首页
  145. */
  146. const ROLE_HOME_PAGES = {
  147. butler: '/my-families',
  148. teacher: '/teacher-dashboard',
  149. nutritionist: '/report-management',
  150. supplier: '/product-manage',
  151. activity_manager: '/activities',
  152. knowledge_admin: '/article-manage',
  153. org_admin: '/org',
  154. }
  155. export function getRoleHomePage(roles) {
  156. if (!roles || roles.length === 0) return '/'
  157. let home = null
  158. for (let i = 0; i < roles.length; i++) {
  159. const normalized = normalizeRole(roles[i])
  160. // 平台角色优先:拥有平台角色则进平台首页
  161. if (normalized === 'admin' || normalized === 'operator' || normalized === 'finance') {
  162. return '/'
  163. }
  164. if (!home && ROLE_HOME_PAGES[normalized]) {
  165. home = ROLE_HOME_PAGES[normalized]
  166. }
  167. }
  168. return home || '/'
  169. }
  170. /**
  171. * 判断角色列表是否为入驻角色(非平台角色 admin/operator/finance)
  172. */
  173. export function isResident(roles) {
  174. if (!roles || roles.length === 0) return false
  175. for (let i = 0; i < roles.length; i++) {
  176. const normalized = normalizeRole(roles[i])
  177. if (normalized === 'admin' || normalized === 'operator' || normalized === 'finance') {
  178. return false
  179. }
  180. if (RESIDENT_ROLES.indexOf(normalized) >= 0) {
  181. return true
  182. }
  183. }
  184. return false
  185. }
  186. /**
  187. * 获取角色中文名
  188. */
  189. export function getRoleLabel(role) {
  190. const labels = {
  191. admin: '超级管理员',
  192. operator: '运营',
  193. finance: '财务',
  194. butler: '管家',
  195. knowledge_admin: '知识管理员',
  196. teacher: '成长规划师',
  197. nutritionist: '营养师',
  198. supplier: '供应商',
  199. activity_manager: '活动管理员',
  200. org_admin: '组织管理员',
  201. // 遗留角色
  202. article_manager: '知识管理员',
  203. activity_admin: '活动管理员',
  204. supplier_admin: '供应商',
  205. }
  206. return labels[role] || role
  207. }