feat: art-design-pro 脚手架落地与品牌化（八页骨架/代理配置/权限菜单）

- 模板 art-design-pro（MIT）GitHub 直连克隆后裁剪落地 admin/：删除演示页面/示例数据/mock/未用组件，保留构建与依赖清单 - 品牌化：应用名/标题/侧栏与登录页 logo/浏览器 favicon 全部替换为 all-kefu 自有资源（static/kefu-small.png），中文界面 - 八页骨架：login / force-change-password / dashboard / tenants / conversations / config / stats / settings 占位页 + 6 组路由模块 - 权限菜单：meta.roles 前端过滤，super 全量，tenant 隐藏租户管理/平台设置（角色值与后端一致） - 开发代理：/api 直转 + /api/public 与 /static 携带租户 Host 改写（VITE_TENANT_PREVIEW_HOST），适配后端 TenantHostMiddleware - 认证 API 为开发桩（角色调试开关），Task 3 对接真实登录 Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-13 14:51:24 +08:00
parent 0c25287c19
commit 78ff060420
290 changed files with 38981 additions and 0 deletions
@@ -0,0 +1,109 @@
+/**
+ * 菜单状态管理模块
+ *
+ * 提供菜单数据和动态路由的状态管理
+ *
+ * ## 主要功能
+ *
+ * - 菜单列表存储和管理
+ * - 首页路径配置
+ * - 动态路由注册和移除
+ * - 路由移除函数管理
+ * - 菜单宽度配置
+ *
+ * ## 使用场景
+ *
+ * - 动态菜单加载和渲染
+ * - 路由权限控制
+ * - 首页路径动态设置
+ * - 登出时清理动态路由
+ *
+ * ## 工作流程
+ *
+ * 1. 获取菜单数据（前端/后端模式）
+ * 2. 设置菜单列表和首页路径
+ * 3. 注册动态路由并保存移除函数
+ * 4. 登出时调用移除函数清理路由
+ *
+ * @module store/modules/menu
+ * @author Art Design Pro Team
+ */
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import { AppRouteRecord } from '@/types/router'
+import { getFirstMenuPath } from '@/utils'
+import { HOME_PAGE_PATH } from '@/router'
+
+/**
+ * 菜单状态管理
+ * 管理应用的菜单列表、首页路径、菜单宽度和动态路由移除函数
+ */
+export const useMenuStore = defineStore('menuStore', () => {
+  /** 首页路径 */
+  const homePath = ref(HOME_PAGE_PATH)
+  /** 菜单列表 */
+  const menuList = ref<AppRouteRecord[]>([])
+  /** 菜单宽度 */
+  const menuWidth = ref('')
+  /** 存储路由移除函数的数组 */
+  const removeRouteFns = ref<(() => void)[]>([])
+
+  /**
+   * 设置菜单列表
+   * @param list 菜单路由记录数组
+   */
+  const setMenuList = (list: AppRouteRecord[]) => {
+    menuList.value = list
+    setHomePath(HOME_PAGE_PATH || getFirstMenuPath(list))
+  }
+
+  /**
+   * 获取首页路径
+   * @returns 首页路径字符串
+   */
+  const getHomePath = () => homePath.value
+
+  /**
+   * 设置主页路径
+   * @param path 主页路径
+   */
+  const setHomePath = (path: string) => {
+    homePath.value = path
+  }
+
+  /**
+   * 添加路由移除函数
+   * @param fns 要添加的路由移除函数数组
+   */
+  const addRemoveRouteFns = (fns: (() => void)[]) => {
+    removeRouteFns.value.push(...fns)
+  }
+
+  /**
+   * 移除所有动态路由
+   * 执行所有存储的路由移除函数并清空数组
+   */
+  const removeAllDynamicRoutes = () => {
+    removeRouteFns.value.forEach((fn) => fn())
+    removeRouteFns.value = []
+  }
+
+  /**
+   * 清空路由移除函数数组
+   */
+  const clearRemoveRouteFns = () => {
+    removeRouteFns.value = []
+  }
+
+  return {
+    menuList,
+    menuWidth,
+    removeRouteFns,
+    setMenuList,
+    getHomePath,
+    setHomePath,
+    addRemoveRouteFns,
+    removeAllDynamicRoutes,
+    clearRemoveRouteFns
+  }
+})