Skip to content
uAdmin

后端接入与 uNode 联调 ​

uAdmin 不绑定特定后端。默认 REST 接入使用 @uadmin/protocol 的会话与导航协议;uNode 是一种消费方式。

协议端点 ​

端点用途
POST /auth/login登录并返回会话令牌
POST /auth/refresh刷新令牌
POST /auth/logout结束会话
GET /auth/me当前用户与权限
GET /admin/nav已启用模块及权限裁剪后的菜单
/admin/modules*可选系统模块的管理接口
/admin-menu*可选菜单管理接口

成功响应使用 { success: true, data }。具体字段、端点常量及权限语义以 @uadmin/protocol 为准;系统页面接口见 @uadmin/modules 的 README 与类型。

应用接入 ​

  1. 在 Vite 配置中使用 @uadmin/app/vite 的 uadmin() 插件。
  2. 调用 createUAdmin,传入 restBackend()、业务模块、布局及公开路由。
  3. 需要系统管理页面时注册 systemModules(),后端实现对应接口。
  4. home 指向实际存在的业务路由,登录与错误页使用明确的路由配置。

后端须对每次请求独立执行身份与权限校验。菜单过滤与按钮隐藏仅改善交互体验。

完整入口示例见模块指南,所需依赖见独立接入。

本地 uNode 联调 ​

pnpm dev:unode 启动 demo 的本地后端模式,代理目标为 http://127.0.0.1:3000/api。先启动实现共享协议的本地服务,再验证登录回跳、导航加载、模块启停与权限变化。

没有本地服务时使用 pnpm dev 的开发 Mock,或使用 pnpm build:demo 的浏览器静态演示。

Vue 3 · TypeScript · Element Plus