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 班级),供界面演示
This commit is contained in:
2026-09-28 20:49:55 +08:00
parent 9d7a8ca845
commit 87ece5a971
237 changed files with 25215 additions and 26 deletions
+31
View File
@@ -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)
}
@@ -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')
})
}