/** 路由 meta 菜单 key 约定(任务 9):menuKey 对应后端菜单节点 key,仅作页面级鉴权。 */ export const ADMIN_MENU_KEY_PATTERN = /^[a-z][a-z0-9_]*$/ /** 从 route.meta 读取菜单 key;缺省/非法类型回退空串(无菜单约束)。 */ export function metaMenuKey(meta: { menuKey?: unknown } | undefined): string { const value = meta?.menuKey return typeof value === 'string' ? value : '' } /** 菜单 key 是否合规(小写下划线命名)。 */ export function isValidMenuKey(key: string): boolean { return ADMIN_MENU_KEY_PATTERN.test(key) } export interface MenuKeyCandidate { path?: string menuKey?: unknown } /** 校验一批页面注册的 menuKey:重复与命名格式问题返回可操作清单。 */ export function validateRouteMenuKeys(records: MenuKeyCandidate[]): string[] { const issues: string[] = [] const seen = new Set() for (const record of records) { const key = metaMenuKey(record) if (!key) continue if (seen.has(key)) issues.push(`菜单 key 重复: ${key}`) seen.add(key) if (!isValidMenuKey(key)) { issues.push(`菜单 key 命名非法(须小写下划线): ${record.path || '(无路径)'} -> ${key}`) } } return issues }