跳到主要内容

管理后台示例(apps/admin) ​

apps/admin 是一个用 ruanno-ui 搭建的桌面端完整业务模板:登录鉴权、RBAC 权限、多标签页、Mock API、国际化一应俱全,既是组件库在真实中后台场景的「样板间」,也可以直接复制进你的项目当起手模板。私有包,不发布到 npm。

bash
pnpm --filter @ruanno-ui/admin dev

演示账号:admin / ops / dev / pm / guest 等(密码均为 123456),不同角色看到的菜单与按钮权限不同,可用来体验 RBAC。

在线预览 ​

独立访问地址:/apps/admin/(新窗口打开体验更佳;演示账号 admin / 123456,其余角色密码相同)

/apps/admin/
ruanno Admin · 实时运行 新窗口打开

登录页

技术栈与工程要点 ​

维度选型
框架Vue 3 <script setup> + TypeScript 严格模式
路由vue-router 4,菜单树驱动动态路由(router/menus.ts 为唯一数据源)
状态Pinia(user / permission / tabs 三个 store)
请求axios + 内存 Mock 适配器(300ms 模拟延迟,无需后端)
按需引入@ruanno-ui/resolver + unplugin-vue-components / unplugin-auto-import
国际化内置 i18n(zh-CN / en),菜单与页面文案全量覆盖

几个值得抄作业的实践:

  • 菜单即路由:menuTree 同时驱动侧边菜单、动态路由与面包屑,meta.roles 控制菜单可见性,meta.permission 落到按钮级权限码;
  • 多标签页 + keepAlive:tabs store 管理已打开页签,列表页缓存、详情页不缓存;
  • 路由守卫三段式:未登录跳登录、已登录动态注册路由、注册后 replace 重进,避免 catch-all 误判 404;
  • 错误页全家桶:403 / 404 / 500 / 锁屏页齐备。

功能地图 ​

模块页面用到的代表组件
登录7 种风格登录页(aurora / blueprint / brutal / depth / editorial / ink / neon)+ 锁屏Form、Input、Button、主题系统
仪表盘统计卡片、趋势图、待办Statistic、Card、LineChart、BarChart、PieChart
用户管理列表 / 详情 / 新增编辑Table、Pagination、Drawer、Descriptions、Tag、Avatar
系统管理角色 / 菜单 / 部门 / 字典 / 日志Table、Tree、Popconfirm、Dialog、Form
内容管理文章列表与编辑Table、RichTextEditor、Upload
组件演示区基础 / 表单 / 数据 / 反馈 / 导航 / 图表 / H5 编辑器 / 日历待办 / 日期选择 / 表格 / 表单全库组件的业务化组合
个人个人中心、系统设置(含主题切换)Tabs、Form、Switch、ConfigProvider

仪表盘

用户管理

用户详情

系统设置

从它开始一个新项目 ​

  1. 复制 apps/admin 到你的仓库,删除 demo 目录下的演示视图与对应菜单节点;
  2. 把 src/mock 换成真实 API(utils/request.ts 的 axios 实例已处理好 token 与错误提示);
  3. 按业务重写 router/menus.ts,权限模型可直接沿用。

移动端业务模板见 移动商城示例。