5.4 KiB
5.4 KiB
路由设计
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. 路由守卫
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 |
课程详情 |