Files
crawler-plugin/admin-frontend-vue/src/router/helpers.ts
T
huangzd1997 1f23369629 feat(前端): 公司管理加角色内在闸门(注册表+守卫+剪枝)
- 新建 src/config/company-scope.ts:SUPER_ADMIN_ONLY_MENU_KEYS=['admin_companies']
  与 COMPANY_SCOPED_PAGES(批次 1 的 8 页口径清单,后续任务的唯一分母)
- routes.ts:AdminPageDef 加 superAdminOnly/companyScoped;公司管理标 superAdminOnly: true,
  8 个 A 类页标 companyScoped: true,C 类两页显式写 false(声明而非留空)
- helpers.ts:pruneSuperAdminOnly 纯函数(超管原样返回,非超管递归剪掉专属节点)
- router/index.ts:菜单授权之外补一条与菜单树无关的角色判定
- admin-session.ts:菜单树唯一写点内接剪枝(顺序仍在 fetchCurrentUser 之后)
- 新增 tests/company-super-admin-only.test.ts 5 支护栏
- task-29 的主路径断言随唯一写点改写(原断言只认 canonicalize 裸赋值,
  剪枝并入同一写点后必然失配;改为同时要求 prune + canonicalize,意图不降反强)
2026-10-04 18:28:43 +08:00

45 lines
1.9 KiB
TypeScript

import type { AdminMenuNode } from '../types/admin'
import { SUPER_ADMIN_ONLY_MENU_KEYS } from '../config/company-scope.ts'
/**
* 取后端菜单树中第一个可路由页面路径(深度优先、保序)。
* 无任何可路由页面时返回空串,由调用方决定渲染空态或回根路由,不硬编码缺省页。
*/
export function firstVisiblePath(nodes: AdminMenuNode[] | null | undefined): string {
for (const node of nodes || []) {
if (node.route) return node.route
const nested = firstVisiblePath(node.children || [])
if (nested) return nested
}
return ''
}
/** 菜单树中是否含指定 key(深度优先递归;空 key/空树一律 false)。 */
export function hasMenuKey(nodes: AdminMenuNode[] | null | undefined, key: string): boolean {
if (!key) return false
return (nodes || []).some((node) => node.key === key || hasMenuKey(node.children || [], key))
}
/**
* 页面级路由准入:无 menuKey 的开放页放行;超级管理员可进全部;其余须在
* 本人菜单树中命中 key。后端已过滤菜单,此处只做前端路由级兜底。
*/
export function isRouteAllowed(
isSuperAdmin: boolean,
menuKey: string | undefined,
menuTree: AdminMenuNode[] | null | undefined,
): boolean {
if (!menuKey) return true
if (isSuperAdmin) return true
return hasMenuKey(menuTree, menuKey)
}
/** 从菜单树上摘掉超管专属节点。非超管必须剪(它的公司管理页永远不该出现),
* 超管原样返回——超管的准入由 router/index.ts 那条角色闸门管,这里剪了反而会让侧边栏少一项。 */
export function pruneSuperAdminOnly<T extends { key: string }>(nodes: T[], isSuperAdmin: boolean): T[] {
if (isSuperAdmin) return nodes
return nodes
.filter((node) => !SUPER_ADMIN_ONLY_MENU_KEYS.includes(node.key))
.map((node) => ({ ...node, children: pruneSuperAdminOnly((node as { children?: T[] }).children || [], isSuperAdmin) }))
}