import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router' import { ElMessage } from 'element-plus' import { useUserStore } from '@/store/user' import { ROLE_ADMIN } from '@/utils/constants' declare module 'vue-router' { interface RouteMeta { /** 免登录页面(登录页) */ public?: boolean /** 页面标题:浏览器标题 / 面包屑 / 菜单共用,新页面必须写 */ title?: string /** 仅管理员可访问 —— 菜单隐藏 + 守卫兜底(直接输 URL 会被弹回首页) */ requiresAdmin?: boolean /** 是否出现在侧边菜单(默认 true);false 用于排除登录页等 */ menu?: boolean /** 菜单分组名(同名聚合为一个子菜单);不设则为顶层菜单项 */ group?: string /** 菜单排序,越小越靠前 */ order?: number } } const routes: RouteRecordRaw[] = [ { path: '/login', name: 'login', component: () => import('@/views/login/index.vue'), meta: { public: true, title: '登录', menu: false }, }, { // 应用主框架:菜单、顶栏、面包屑由布局提供,业务页面作为子路由渲染 path: '/', component: () => import('@/components/layout/BasicLayout.vue'), redirect: '/dashboard', children: [ { path: '/dashboard', name: 'dashboard', component: () => import('@/views/dashboard/index.vue'), meta: { title: '首页', order: 1 }, }, { path: '/system/users', name: 'system-users', component: () => import('@/views/system/users/index.vue'), meta: { title: '用户管理', group: '系统管理', requiresAdmin: true, order: 2 }, }, { path: '/system/roles', name: 'system-roles', component: () => import('@/views/system/roles/index.vue'), meta: { title: '角色管理', group: '系统管理', requiresAdmin: true, order: 3 }, }, { path: '/system/logs', name: 'system-logs', component: () => import('@/views/system/logs/index.vue'), meta: { title: '日志查询', group: '系统管理', requiresAdmin: true, order: 4 }, }, ], }, // 未匹配路由回首页;若未登录会被守卫拦到登录页 { path: '/:pathMatch(.*)*', redirect: '/dashboard' }, ] const router = createRouter({ history: createWebHistory(), routes, }) /** * 全局前置守卫。 * * 四层判断: * 1. `meta.public` 标记的页面(登录页)直接放行 * 2. 无令牌 → 跳登录页,并把原目标记在 query 里供登录后回跳 * 3. 有令牌但内存中无用户信息(说明是刷新页面)→ 调 /me 恢复会话; * 失败则视为令牌已失效,清状态并跳登录页 * 4. `meta.requiresAdmin` 的页面要求管理员角色 —— 此时用户信息已就绪, * 这是"隐藏菜单"之外的第二道防线(防手输 URL) */ router.beforeEach(async (to) => { const userStore = useUserStore() if (to.meta.public) { return true } if (!userStore.token) { return { path: '/login', query: { redirect: to.fullPath } } } if (!userStore.userInfo) { try { await userStore.fetchUserInfo() } catch { userStore.resetAuth() return { path: '/login', query: { redirect: to.fullPath } } } } if (to.meta.requiresAdmin && !userStore.roles.includes(ROLE_ADMIN)) { ElMessage.error('需要管理员权限') return { path: '/dashboard' } } return true }) router.afterEach((to) => { const title = to.meta.title as string | undefined document.title = title ? `${title} - ${import.meta.env.VITE_APP_TITLE}` : import.meta.env.VITE_APP_TITLE }) export default router