Files
2026-06-29 19:27:33 +08:00

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 课程详情