# 路由设计 ## 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=` | | 草稿预览 | `/preview/:pageKey?token=` | ## 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` | 课程详情 |