feat(admin): 新增题库、排行榜、实时结果和模板管理功能

- 添加题库管理页面及相关组件
- 实现排行榜管理功能，包括列表和详情页
- 新增实时结果展示页面
- 添加模板制作和管理功能
- 完善路由配置和国际化支持
- 新增阿里云OSS文件上传服务
- 添加多种工具函数和类型定义
- 优化表格和表单组件
- 调整布局和样式细节

apps/admin/src/store/modules/route/shared.ts

@@ -4,28 +4,28 @@ import { useSvgIcon } from '@/hooks/common/icon'
 import { $t } from '@/locales'
 
 /**
- * Filter auth routes by roles
+ * 根据角色过滤权限路由
  *
- * @param routes Auth routes
- * @param roles Roles
+ * @param routes 权限路由
+ * @param roles 角色
  */
 export function filterAuthRoutesByRoles(routes: ElegantConstRoute[], roles: string[]) {
   return routes.flatMap(route => filterAuthRouteByRoles(route, roles))
 }
 
 /**
- * Filter auth route by roles
+ * 根据角色过滤权限路由
  *
- * @param route Auth route
- * @param roles Roles
+ * @param route 权限路由
+ * @param roles 角色
  */
 function filterAuthRouteByRoles(route: ElegantConstRoute, roles: string[]): ElegantConstRoute[] {
   const routeRoles = (route.meta && route.meta.roles) || []
 
-  // if the route's "roles" is empty, then it is allowed to access
+  // 如果路由的 "roles" 为空，则允许访问
   const isEmptyRoles = !routeRoles.length
 
-  // if the user's role is included in the route's "roles", then it is allowed to access
+  // 如果用户的角色包含在路由的 "roles" 中，则允许访问
   const hasPermission = routeRoles.some(role => roles.includes(role))
 
   const filterRoute = { ...route }
@@ -34,7 +34,7 @@ function filterAuthRouteByRoles(route: ElegantConstRoute, roles: string[]): Eleg
     filterRoute.children = filterRoute.children.flatMap(item => filterAuthRouteByRoles(item, roles))
   }
 
-  // Exclude the route if it has no children after filtering
+  // 如果过滤后没有子路由，则排除该路由
   if (filterRoute.children?.length === 0) {
     return []
   }
@@ -43,9 +43,9 @@ function filterAuthRouteByRoles(route: ElegantConstRoute, roles: string[]): Eleg
 }
 
 /**
- * sort route by order
+ * 根据 order 对路由进行排序
  *
- * @param route route
+ * @param route 路由
  */
 function sortRouteByOrder(route: ElegantConstRoute) {
   if (route.children?.length) {
@@ -57,9 +57,9 @@ function sortRouteByOrder(route: ElegantConstRoute) {
 }
 
 /**
- * sort routes by order
+ * 根据 order 对路由进行排序
  *
- * @param routes routes
+ * @param routes 路由
  */
 export function sortRoutesByOrder(routes: ElegantConstRoute[]) {
   routes.sort((next, prev) => (Number(next.meta?.order) || 0) - (Number(prev.meta?.order) || 0))
@@ -69,19 +69,30 @@ export function sortRoutesByOrder(routes: ElegantConstRoute[]) {
 }
 
 /**
- * Get global menus by auth routes
- *
- * @param routes Auth routes
+ * 根据权限路由获取全局菜单
+ * 当嵌套路由里面，有且仅有一个子路由时，将其提升到一级菜单，点击一级菜单时，跳转到子路由
+ * @param routes 权限路由
+ * @param shouldHoist 是否提升
+ * @param includeHidden 是否包含隐藏路由
  */
-export function getGlobalMenusByAuthRoutes(routes: ElegantConstRoute[]) {
+export function getGlobalMenusByAuthRoutes(routes: ElegantConstRoute[], shouldHoist = false, includeHidden = false) {
   const menus: App.Global.Menu[] = []
 
   routes.forEach((route) => {
-    if (!route.meta?.hideInMenu) {
+    if (includeHidden || !route.meta?.hideInMenu) {
       const menu = getGlobalMenuByBaseRoute(route)
 
-      if (route.children?.some(child => !child.meta?.hideInMenu)) {
-        menu.children = getGlobalMenusByAuthRoutes(route.children)
+      if (route.children?.some(child => includeHidden || !child.meta?.hideInMenu)) {
+        menu.children = getGlobalMenusByAuthRoutes(route.children, shouldHoist, includeHidden)
+      }
+
+      // 如果只有一个子菜单，将其提升
+      if (shouldHoist && menu.children?.length === 1) {
+        const singleChild = menu.children[0]
+        menu.key = singleChild.key
+        menu.routeKey = singleChild.routeKey
+        menu.routePath = singleChild.routePath
+        menu.children = singleChild.children
       }
 
       menus.push(menu)
@@ -92,7 +103,7 @@ export function getGlobalMenusByAuthRoutes(routes: ElegantConstRoute[]) {
 }
 
 /**
- * Update locale of global menus
+ * 更新全局菜单的国际化
  *
  * @param menus
  */
@@ -120,7 +131,7 @@ export function updateLocaleOfGlobalMenus(menus: App.Global.Menu[]) {
 }
 
 /**
- * Get global menu by route
+ * 根据路由获取全局菜单
  *
  * @param route
  */
@@ -145,15 +156,15 @@ function getGlobalMenuByBaseRoute(route: RouteLocationNormalizedLoaded | Elegant
 }
 
 /**
- * Get cache route names
+ * 获取缓存路由名称
  *
- * @param routes Vue routes (two levels)
+ * @param routes Vue 路由 (两级)
  */
 export function getCacheRouteNames(routes: RouteRecordRaw[]) {
   const cacheNames: LastLevelRouteKey[] = []
 
   routes.forEach((route) => {
-    // only get last two level route, which has component
+    // 只获取最后两级有组件的路由
     route.children?.forEach((child) => {
       if (child.component && child.meta?.keepAlive) {
         cacheNames.push(child.name as LastLevelRouteKey)
@@ -165,7 +176,7 @@ export function getCacheRouteNames(routes: RouteRecordRaw[]) {
 }
 
 /**
- * Is route exist by route name
+ * 根据路由名称判断路由是否存在
  *
  * @param routeName
  * @param routes
@@ -175,7 +186,7 @@ export function isRouteExistByRouteName(routeName: RouteKey, routes: ElegantCons
 }
 
 /**
- * Recursive get is route exist by route name
+ * 递归判断路由名称是否存在
  *
  * @param route
  * @param routeName
@@ -195,7 +206,7 @@ function recursiveGetIsRouteExistByRouteName(route: ElegantConstRoute, routeName
 }
 
 /**
- * Get selected menu key path
+ * 获取选中的菜单 key 路径
  *
  * @param selectedKey
  * @param menus
@@ -219,10 +230,10 @@ export function getSelectedMenuKeyPathByKey(selectedKey: string, menus: App.Glob
 }
 
 /**
- * Find menu path
+ * 查找菜单路径
  *
- * @param targetKey Target menu key
- * @param menu Menu
+ * @param targetKey 目标菜单 key
+ * @param menu 菜单
  */
 function findMenuPath(targetKey: string, menu: App.Global.Menu): string[] | null {
   const path: string[] = []
@@ -255,7 +266,7 @@ function findMenuPath(targetKey: string, menu: App.Global.Menu): string[] | null
 }
 
 /**
- * Transform menu to breadcrumb
+ * 将菜单转换为面包屑
  *
  * @param menu
  */
@@ -274,7 +285,7 @@ function transformMenuToBreadcrumb(menu: App.Global.Menu) {
 }
 
 /**
- * Get breadcrumbs by route
+ * 根据路由获取面包屑
  *
  * @param route
  * @param menus
@@ -316,9 +327,9 @@ export function getBreadcrumbsByRoute(
 }
 
 /**
- * Transform menu to searchMenus
+ * 将菜单转换为搜索菜单
  *
- * @param menus - menus
+ * @param menus - 菜单
  * @param treeMap
  */
 export function transformMenuToSearchMenus(menus: App.Global.Menu[], treeMap: App.Global.Menu[] = []) {