XiaoDaiGua-Ray bca3f3ff24
feat(admin): add user management and HTTP mock APIs
Add user CRUD, account-scoped navigation history and favorites.

Unify HTTP mocks, backend contracts and route configuration.

Reuse existing scrolling components and add Harness reuse guidance.
2026-11-05 17:21:59 +08:00

4.2 KiB
Raw Blame History

路由、菜单与权限

正常启动从 GET /admin/route-config 读取版本化路由 JSON,按 meta.order 排序;路由树用于菜单与面包屑,页面记录展开后注册到 Vue Router。Mock 的初始路由表位于 apps/admin/src/mocks/data/routes.json,前端只保留组件 ID 注册表和外壳必需路由。默认使用 hash 路由,例如 /ray-template/#/orders。

路由配置交互校验

修改路径、名称或页面 ID,查看共享校验器的结果。示例注册了 overview 页面。

::: details 查看示例源码 <<< @/examples/RouteConfigDemo.vue :::

在线编辑与接口接入

路由管理的可视化和 JSON 页面从当前生效配置创建草稿。可视化保存及 JSON 的服务端模式通过 PUT /admin/route-config 提交,成功后重新加载并从接口读回;Mock 写入会在当前浏览器刷新后保留。JSON 页面仍可显式切换为本机配置或内置初始配置,用于离线恢复。

接口请求体为 { version: 1, routes: [...] },读取和写入响应都放在统一 { code, msg, data } 包络的 data 中。component 必须是 router/config/views.ts 的注册 ID;新增前端页面先注册 ID,再由接口返回其路由记录。详见服务端标准契约。

常用元数据

字段 作用
i18nKey / noLocalTitle 使用翻译键,或提供不经翻译的菜单标题
icon 使用完整分包图标名,也接受 VNode
role 同时影响菜单与守卫;角色值类型要和会话一致
hidden、env 控制菜单显隐;不充当接口或路由权限
sameLevel 详情页可保留当前菜单与标签,只在面包屑补充层级
keepAlive 允许页面加入内容区的缓存
windowOpen 菜单点击时打开指定地址。
ignoreAutoResetScroll 允许页面保留内容区滚动位置,详见滚动工具实现。
extra 菜单标记的文本、图标、类型和显隐,见 useBadge。

嵌套子路由使用相对路径时会继承父路径。内置示例按用途分组,并以绝对路径保留原有页面地址。查看 布局与路由示例 里的分组及多级菜单。

登录和角色

默认登录页为 /。守卫启用时,无会话会返回登录页;有会话时按白名单、角色和应用首页决定导航。菜单隐藏的页面仍可能允许直达。接入真实业务时,在后端校验会话、权限和资源归属。

KeepAlive 排查

  1. 路由设置 meta.keepAlive: true,并为它配置唯一 name。
  2. TSX 的 defineComponent({ name }) 或 SFC 的组件名应与路由名一致。检查懒加载模块是否导出了预期组件。
  3. 从菜单进入,改变页内状态,切到另一个标签再返回;随后检查关闭标签、直达和刷新是否符合预期。KeepAlive 不跨浏览器刷新保留组件实例。
  4. 替换布局的默认内容插槽后,应用接入方需要自行保留需要的路由渲染和缓存逻辑。

路由契约 · 守卫实现