119 lines
5.4 KiB
Markdown
119 lines
5.4 KiB
Markdown
# 路由设计
|
|
|
|
## 1. 管理端路由约定
|
|
|
|
| 类型 | 约定 |
|
|
| --- | --- |
|
|
| 登录页 | `/login` |
|
|
| 后台首页 | `/dashboard` |
|
|
| 业务页面 | 使用一级模块加二级路径 |
|
|
| 新建页 | `/new` |
|
|
| 编辑页 | `/:id/edit` |
|
|
| 详情页 | `/:id` |
|
|
| 评委端 | `/judge/*` |
|
|
|
|
## 2. 管理端菜单与路由
|
|
|
|
| 菜单 | 路由 | 页面 | 权限 |
|
|
| --- | --- | --- | --- |
|
|
| 登录 | `/login` | 登录页 | 无 |
|
|
| 控制台 | `/dashboard` | 数据概览 | `dashboard:read` |
|
|
| 官网内容/站点配置 | `/site/config` | 站点配置 | `site:read` |
|
|
| 官网内容/首页区块 | `/site/home` | 首页内容区块 | `site:read` |
|
|
| 官网内容/客户案例 | `/site/cases` | 案例管理 | `site:read` |
|
|
| 赛道内容/基础信息 | `/competition/basic` | 赛道基础信息 | `competition:read` |
|
|
| 赛道内容/页面区块 | `/competition/sections` | 大赛介绍、赛事说明等 | `competition:read` |
|
|
| 赛道内容/赛程安排 | `/competition/schedules` | 赛程管理 | `competition:read` |
|
|
| 赛道内容/参考资源 | `/competition/resources` | 资源包管理 | `competition:read` |
|
|
| 赛道内容/合作伙伴 | `/competition/partners` | 合作伙伴 | `competition:read` |
|
|
| 赛道内容/大赛动态 | `/competition/news` | 通知动态 | `competition:read` |
|
|
| 素材库 | `/media/files` | 文件列表 | `file:read` |
|
|
| 素材上传 | `/media/upload` | 上传中心 | `file:upload` |
|
|
| 视频/课程 | `/courses` | 课程列表 | `course:read` |
|
|
| 新建课程 | `/courses/new` | 新建课程 | `course:write` |
|
|
| 编辑课程 | `/courses/:id/edit` | 编辑课程 | `course:write` |
|
|
| 作品管理 | `/works` | 作品列表 | `work:read` |
|
|
| 新建作品 | `/works/new` | 新建作品 | `work:write` |
|
|
| 作品详情 | `/works/:id` | 作品详情 | `work:read` |
|
|
| 编辑作品 | `/works/:id/edit` | 编辑作品 | `work:write` |
|
|
| 作品素材 | `/works/:id/materials` | 图片、模型、附件 | `work:write` |
|
|
| 批量导入 | `/works/import` | 批量导入 | `work:write` |
|
|
| 评审轮次 | `/evaluation/rounds` | 轮次列表 | `evaluation:manage` |
|
|
| 新建轮次 | `/evaluation/rounds/new` | 创建轮次 | `evaluation:manage` |
|
|
| 轮次详情 | `/evaluation/rounds/:id` | 进度、指标、分配 | `evaluation:manage` |
|
|
| 评分结果 | `/evaluation/rounds/:id/results` | 汇总和发布 | `evaluation:manage` |
|
|
| 评委管理 | `/evaluation/judges` | 评委账号 | `evaluation:manage` |
|
|
| 我的评审 | `/judge/assignments` | 评委任务 | `evaluation:score` |
|
|
| 评委评分 | `/judge/assignments/:id` | 评分页 | `evaluation:score` |
|
|
| 咨询线索 | `/inquiries` | 线索列表 | `inquiry:read` |
|
|
| 线索详情 | `/inquiries/:id` | 线索详情 | `inquiry:read` |
|
|
| 系统/用户 | `/system/users` | 管理员账号 | `system:manage` |
|
|
| 系统/角色 | `/system/roles` | 角色权限 | `system:manage` |
|
|
| 系统/日志 | `/system/logs` | 操作日志 | `system:manage` |
|
|
|
|
## 3. 页面状态路由
|
|
|
|
| 场景 | 路由 |
|
|
| --- | --- |
|
|
| 无权限 | `/403` |
|
|
| 页面不存在 | `/404` |
|
|
| Token 过期 | 重定向 `/login?redirect=<current>` |
|
|
| 草稿预览 | `/preview/:pageKey?token=<previewToken>` |
|
|
|
|
## 4. 路由守卫
|
|
|
|
```mermaid
|
|
flowchart TD
|
|
A["进入路由"] --> B{"是否公开路由"}
|
|
B -- "是" --> C["渲染页面"]
|
|
B -- "否" --> D{"是否有 token"}
|
|
D -- "否" --> E["跳转 /login"]
|
|
D -- "是" --> F["请求 /api/admin/me"]
|
|
F --> G{"权限是否匹配"}
|
|
G -- "是" --> C
|
|
G -- "否" --> H["跳转 /403"]
|
|
```
|
|
|
|
## 5. 页面和 API 映射
|
|
|
|
| 页面 | 主要 API |
|
|
| --- | --- |
|
|
| `/dashboard` | `GET /api/admin/dashboard` |
|
|
| `/site/config` | `GET/PATCH /api/admin/site/config` |
|
|
| `/site/home` | `GET /api/admin/content/pages/home/sections`、`PATCH /api/admin/content/sections/:id` |
|
|
| `/competition/basic` | `GET/PATCH /api/admin/competitions/:id` |
|
|
| `/competition/sections` | `GET /api/admin/competitions/:id/sections`、`PATCH /api/admin/content/sections/:id` |
|
|
| `/competition/schedules` | `GET/POST /api/admin/competitions/:id/schedules` |
|
|
| `/competition/resources` | `GET/POST /api/admin/competitions/:id/resources` |
|
|
| `/media/files` | `GET /api/admin/files` |
|
|
| `/media/upload` | `POST /api/admin/uploads/policy`、`POST /api/admin/uploads/complete` |
|
|
| `/courses` | `GET /api/admin/courses` |
|
|
| `/courses/:id/edit` | `GET/PATCH /api/admin/courses/:id` |
|
|
| `/works` | `GET /api/admin/works` |
|
|
| `/works/:id/edit` | `GET/PATCH /api/admin/works/:id` |
|
|
| `/evaluation/rounds` | `GET /api/admin/evaluation/rounds` |
|
|
| `/evaluation/rounds/:id` | `GET/PATCH /api/admin/evaluation/rounds/:id` |
|
|
| `/evaluation/rounds/:id/results` | `GET /api/admin/evaluation/rounds/:id/results` |
|
|
| `/judge/assignments` | `GET /api/admin/evaluation/my-assignments` |
|
|
| `/judge/assignments/:id` | `POST /api/admin/evaluation/assignments/:id/scores` |
|
|
| `/inquiries` | `GET /api/admin/inquiries` |
|
|
|
|
## 6. 前台路由映射
|
|
|
|
当前前台仍保持静态路径:
|
|
|
|
| 页面 | 路径 | 数据来源 |
|
|
| --- | --- | --- |
|
|
| 官网首页 | `/`、`/index.html` | `/api/site/config`、`/api/site/home` |
|
|
| 赛道页 | `/competition.html` | `/api/competition` |
|
|
| 作品详情 | `/work-detail.html?id=SMT-2026-018` | `/api/works/:id` |
|
|
| 课程详情 | `/course-detail.html?type=roadshow&id=rs-01` | `/api/courses/:id` |
|
|
|
|
后续如改为 SPA 或 SSR,可映射为:
|
|
|
|
| 新路径 | 说明 |
|
|
| --- | --- |
|
|
| `/competition/smart-fashion` | 赛道页 |
|
|
| `/works/:workNo` | 作品详情 |
|
|
| `/courses/:courseNo` | 课程详情 |
|