feat(frontend): 管理端改用 Gi Admin Pro 框架 + 腾讯云主题

前端此前只有本地实现、从未入库，本次首次纳入版本管理。

框架切换
  · 以 Gi Admin Pro（Vue3 + Vite + TS + Arco Design Vue + Pinia）为底
  · 剥离 14 个演示页面目录 / 121 个文件（demo 28、file 20、form 19、system 18…）
  · 依赖 dependencies 35 → 19，devDependencies 31 → 27
  · 保留框架核心：layout、Gi* 组件库、hooks、权限指令、错误页、登录页

主题：腾讯云 / TDesign 官方色板
  · 主色 #0052D9（腾讯蓝）、成功 #00A870、警告 #ED7B2F、危险 #E34D59
  · 页面底色 #f3f3f3、文字 rgba(0,0,0,90/60/40/26%)
  · 覆盖 Arco 底层色板 + 显式语义别名（primary/success/warning/danger/link/neutral）
  · 三个改了不生效也不报错的坑已记入注释：
      1) Arco 色值是逗号分隔 RGB 三元组，不是 #RRGGBB
      2) Arco 把色板定义在 body 而非 :root，必须写 `:root, body`
      3) setting.json 的 themeColor 会以内联样式写进 body，优先级高于样式表

对接后端（三处契约差异在 @/utils/http 统一适配）
  · 响应信封 {code,msg,data} → {code,success,message,data}
  · Token 头 token → Authorization: Bearer
  · 分页 {list,total} → 补一份 records，list 原样保留
  · 40101 → 登录页；登录密码 RSA 加密（公钥走 /auth/public-key，轮换无需重建前端）
  · 路由：后端只下发菜单键，前端在本地路由表上过滤（有哪些页面归代码，谁能看归后端）

已实现页面（浏览器实测通过）
  · 登录：RSA 加密 + 自适应验证码/租户码 + 账号锁定提示
  · 工作台：真实数据（组织 6 个 / 角色 1 个 / 权限 25 项）
  · 组织架构：三级树 + CRUD + 占用校验
  · 租户管理：开通租户 + 初始密码只显示一次的强确认
  · 待建页：未实现菜单显示所属里程碑
  · 权限菜单：学校管理员看不到「租户管理」

视觉资产按腾讯云主题重做
  · logo.svg（渐变圆角方 + 填）、favicon.svg（小尺寸做减法）、login-hero.svg（材料归集）
  · 登录页点阵纹理走主题变量，换主色自动跟随
  · 文案改为产品实际能力：自动改名 / 强制压缩 / 隐私保护

清理模板遗留（约 17MB + 三处外部依赖）
  · 百度统计脚本（上报到 gi-demo 作者的统计账号）
  · 用户菜单「项目地址」（跳转模板作者的 Gitee 仓库）
  · 两份 8.8MB mp3、388KB favicon.ico、57KB 模板插画、未引用字体与 loading.gif
  · 「个人中心」指向已删除的 /system/account（点了 404）
  · 头部头像在无 avatarUrl 时渲染成裂图 → 改为姓名首字兜底

后端修复
  · 新增 GET /auth/public-key（前端加密登录密码用）
  · DataSeeder.ancestor_path 生成错误：子节点本该是 /16/17/ 却写成 /17/
    该字段是「按院系统计」的索引，错了会漏人/多人且不报错 —— 改为从库里读父节点路径
  · seedDemoOrgs 曾放在租户作用域外 + admin 早退分支之后，导致启动失败 / 永不执行
  · 示范租户补一套三级组织树（1 学校 / 2 院系 / 3 班级），供界面演示

frontend-pc/src/router/guard/index.ts

@@ -0,0 +1,31 @@
+/** @file 路由守卫配置模块 - 处理路由导航守卫和权限控制 */
+
+import type { Router } from 'vue-router'
+import { setRouteEmitter } from '@/hooks'
+import { setupPermissionGuard } from './setupPermissionGuard'
+
+/**
+ * 设置页面路由守卫
+ * @description 处理路由变化时的页面级操作，如路由变化事件通知
+ * @param router - Vue Router 实例
+ */
+export const setupPageGuard = (router: Router) => {
+  router.beforeEach((to, from) => {
+    // 触发路由变化事件，通知所有监听器
+    setRouteEmitter(to, from)
+  })
+}
+
+/**
+ * 创建路由守卫
+ * @description 统一配置所有路由守卫，包括：
+ * 1. 页面路由守卫 - 处理路由变化事件
+ * 2. 权限路由守卫 - 处理路由访问权限
+ * @param router - Vue Router 实例
+ */
+export default function createRouteGuard(router: Router) {
+  // 设置页面路由守卫
+  setupPageGuard(router)
+  // 设置权限路由守卫
+  setupPermissionGuard(router)
+}

frontend-pc/src/router/guard/setupPermissionGuard.ts

@@ -0,0 +1,89 @@
+/** @file 路由权限守卫模块 - 处理路由访问权限和动态路由加载 */
+
+import type { RouteLocationNormalized, Router } from 'vue-router'
+import { Message } from '@arco-design/web-vue'
+import { useUserStore } from '@/stores'
+import { getToken } from '@/utils/auth'
+
+/** 免登录白名单路径 */
+const WHITE_LIST = ['/login', '/404']
+
+/** 是否已生成动态路由 */
+let isDynamicRoutesGenerated = false
+
+/**
+ * 处理动态路由加载
+ * @param router - 路由实例
+ * @param to - 目标路由
+ */
+async function handleDynamicRoutes(
+  router: Router,
+  to: RouteLocationNormalized
+): Promise<{ path: string, query?: any, replace: boolean }> {
+  const userStore = useUserStore()
+
+  try {
+    await userStore.generateRoutes()
+    // 标记动态路由已生成
+    isDynamicRoutesGenerated = true
+    // 确保路由添加完成后返回目标路由
+    return { ...to, replace: true }
+  } catch (error) {
+    // 发生错误时重置用户状态并跳转登录页
+    userStore.resetToken()
+    const errorMessage = error instanceof Error ? error.message : '路由守卫过程发生错误'
+    Message.error(errorMessage)
+    return { path: `/login`, query: { redirect: to.path }, replace: true }
+  }
+}
+
+/**
+ * 初始化路由守卫
+ * @param router - 路由实例
+ */
+export const setupPermissionGuard = (router: Router): void => {
+  router.beforeEach(async (to, _from, next) => {
+    const token = getToken()
+    const userStore = useUserStore()
+
+    // 已登录状态
+    if (token) {
+      if (to.path === '/login') {
+        // 已登录时访问登录页，直接放行（通常会被重定向到首页）
+        next()
+        return
+      }
+
+      // 只在首次访问或路由未生成时处理动态路由
+      if (!isDynamicRoutesGenerated) {
+        try {
+          const redirectRoute = await handleDynamicRoutes(router, to)
+          next(redirectRoute)
+        } catch {
+          // 如果出错，清空角色信息并重定向到登录页
+          userStore.resetToken()
+          // 重置路由生成标志
+          isDynamicRoutesGenerated = false
+          next(`/login?redirect=${to.path}`)
+        }
+        return
+      }
+
+      // 正常访问
+      next()
+      return
+    }
+
+    // 未登录状态时重置路由生成标志
+    isDynamicRoutesGenerated = false
+
+    if (WHITE_LIST.includes(to.path)) {
+      // 白名单路径直接访问
+      next()
+      return
+    }
+
+    // 其他路径重定向到登录页
+    next('/login')
+  })
+}

frontend-pc/src/router/index.ts

@@ -0,0 +1,99 @@
+/** @file 路由配置模块 - 处理路由的创建、守卫和重置 */
+
+import type { RouteRecordRaw } from 'vue-router'
+import { createRouter, createWebHashHistory } from 'vue-router'
+import createRouteGuard from '@/router/guard'
+import { useRouteStore } from '@/stores'
+
+/** 默认布局组件 */
+const Layout = () => import('@/layout/index.vue')
+
+/** 基础路由配置 */
+const baseRoutes: RouteRecordRaw[] = [
+  {
+    path: '/redirect',
+    component: Layout,
+    meta: { hidden: true },
+    children: [
+      {
+        path: '/redirect/:path(.*)',
+        component: () => import('@/views/redirect/index.vue')
+      }
+    ]
+  },
+  {
+    path: '/login',
+    component: () => import('@/views/login/index.vue'),
+    meta: { hidden: true }
+  }
+]
+
+/** 错误页面路由配置 */
+const errorRoutes: RouteRecordRaw[] = [
+  {
+    path: '/:pathMatch(.*)*',
+    component: () => import('@/views/error/404.vue'),
+    meta: { hidden: true }
+  },
+  {
+    path: '/403',
+    component: () => import('@/views/error/403.vue'),
+    meta: { hidden: true }
+  }
+]
+
+/** 主页路由配置 */
+const homeRoute: RouteRecordRaw = {
+  path: '/',
+  name: 'Home',
+  component: Layout,
+  redirect: '/dashboard',
+  meta: { hidden: false },
+  children: [
+    {
+      path: '/dashboard',
+      component: () => import('@/views/dashboard/index.vue'),
+      name: 'Dashboard',
+      meta: {
+        title: '工作台',
+        icon: 'icon-park-outline:workbench',
+        affix: true,
+        hidden: false,
+        breadcrumb: false
+      }
+    }
+  ]
+}
+
+/** 静态路由配置 */
+export const constantRoutes: RouteRecordRaw[] = [...baseRoutes, ...errorRoutes, homeRoute]
+
+/** 创建路由实例 */
+const router = createRouter({
+  history: createWebHashHistory(import.meta.env.BASE_URL),
+  routes: constantRoutes,
+  scrollBehavior: () => ({ left: 0, top: 0 })
+})
+
+// 创建路由守卫
+createRouteGuard(router)
+
+/** 重置路由配置 - 清除所有动态添加的路由 */
+export function resetRouter(): void {
+  try {
+    const routeStore = useRouteStore()
+    // 移除所有动态路由
+    routeStore.asyncRoutes.forEach((route) => {
+      const { name } = route
+      if (name && router.hasRoute(name)) {
+        router.removeRoute(name)
+      }
+    })
+  } catch (error) {
+    console.error('重置路由失败:', error)
+    // 降级处理：刷新页面以重置路由状态
+    window.location.reload()
+  }
+}
+
+export default router