管理后台示例(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/

技术栈与工程要点
| 维度 | 选型 |
|---|---|
| 框架 | 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:
tabsstore 管理已打开页签,列表页缓存、详情页不缓存; - 路由守卫三段式:未登录跳登录、已登录动态注册路由、注册后
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 |




从它开始一个新项目
- 复制
apps/admin到你的仓库,删除demo目录下的演示视图与对应菜单节点; - 把
src/mock换成真实 API(utils/request.ts的 axios 实例已处理好 token 与错误提示); - 按业务重写
router/menus.ts,权限模型可直接沿用。
移动端业务模板见 移动商城示例。