主 题
博客系统自文档 · 第 5/16 篇
目录 · 上一篇：作者工作流（C 端写文） · 下一篇：认证与登录
写在前面
C 端负责读和写，B 端 admin 负责运营整站：内容、用户、权限、RPG、运维工具。本篇是 admin 的「地图」，方便你或协作者快速找到页面。
入口：https://admin.jiang-xia.top（静态 SPA，API 走主域 /x-blog/api/v1）。
功能与体验：模块一览
| 路由模块 | 路径前缀 | 典型能力 |
|---|---|---|
| dashboard | /dashboard |
工作台、数据大屏 |
| content | /content |
文章、分类、标签、资源文件 |
| interaction | /interaction |
评论、留言板、友链 |
| system | /system |
用户、角色、权限、部门、菜单 |
| security | /security |
敏感词与审核队列 |
| ops-tools | /ops-tools |
操作日志、定时任务 |
| ext-apps | /ext-apps |
支付订单、RPG 运营（8 个子页） |
| user | /userset |
管理员个人设置 |
content 内容管理
- 文章：列表 +
md-editor-v3编辑（与 C 端同 API） - 分类 / 标签：UUID 主键，颜色随机或自定义
- 资源：上传文件库
admin 数据大屏（亮点）
| 入口 | /datascreen（admin 全屏） |
|---|---|
| 技术 | Vue3 + ECharts |
| 展示 | 访问/发文趋势、分类占比、标签词云、TOP 文章、最近动态 |
适合对外展示站点运营数据；详见附录 C 与 blog-admin/.../datascreen/README.md。
ext-apps · RPG 运营
成就、任务、抽奖池、用户 RPG 数据、物品配置、赛季活动、公会、社交日志等——对应 blog-admin/src/views/rpg/*。
角色与菜单
路由 meta.roles 示例：
'1'超级管理员'2'管理员'3'作者（部分列表页）
侧边栏菜单与后端 menu 表 + RBAC 同步（详见第 07 篇）。
设计与实现
flowchart LR
AdminSPA[blog-admin Vue3]
API["/x-blog/api/v1"]
Nest[blog-server]
AdminSPA --> API --> Nest
| 技术 | 说明 |
|---|---|
| Vue 3 + Vite | 构建为静态 dist |
| Arco Design | 表格、表单、布局 |
| Pinia | 用户 token、菜单状态 |
| axios | JWT；生产 VITE_NUXT_OPEN_ENCRYPT=true 时可加密 body |
路由定义在 blog-admin/src/router/routes/modules/*.ts，按业务拆文件，与 server 模块名尽量对齐（如 Content、System）。
踩坑与取舍
- admin 无 SSR：部署只需上传
dist，不用 PM2 跑 Node。 - 菜单与 privilege 两套：菜单管「看见什么」，API privilege 管「调什么接口」，增量改 RBAC 需同时 patch SQL（第 07、13 篇）。
- RPG 页仅 role 1/2：普通作者用 C 端写文，不进 RPG 后台。
系列导航
- 导读 · 第 0 篇
- 下一篇：06 认证与登录
延伸阅读
blog-admin/README.mdblog-admin/src/router/routes/modules/
全部评论(0)