外观
后端接入与 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 与类型。
应用接入
- 在 Vite 配置中使用
@uadmin/app/vite的uadmin()插件。 - 调用
createUAdmin,传入restBackend()、业务模块、布局及公开路由。 - 需要系统管理页面时注册
systemModules(),后端实现对应接口。 home指向实际存在的业务路由,登录与错误页使用明确的路由配置。
后端须对每次请求独立执行身份与权限校验。菜单过滤与按钮隐藏仅改善交互体验。
本地 uNode 联调
pnpm dev:unode 启动 demo 的本地后端模式,代理目标为 http://127.0.0.1:3000/api。先启动实现共享协议的本地服务,再验证登录回跳、导航加载、模块启停与权限变化。
没有本地服务时使用 pnpm dev 的开发 Mock,或使用 pnpm build:demo 的浏览器静态演示。