9.0 KiB
9.0 KiB
管理端设计文档
1. 设计原则
- 以运营效率为主,不做通用建站器。
- 页面结构固定,后台只暴露需要运营维护的字段。
- 所有影响前台展示的内容都支持草稿、预览、发布。
- 上传、选择、绑定文件是高频操作,文件选择器应在所有内容表单中复用。
- 评委端保持简洁,只展示被分配作品和评分表单。
2. 信息架构
flowchart TD
A["管理端"] --> B["控制台"]
A --> C["官网内容"]
A --> D["赛道内容"]
A --> E["素材库"]
A --> F["视频/课程"]
A --> G["作品管理"]
A --> H["作品评选"]
A --> I["咨询线索"]
A --> J["系统设置"]
C --> C1["站点配置"]
C --> C2["首页区块"]
C --> C3["客户案例"]
D --> D1["赛道基础信息"]
D --> D2["大赛介绍"]
D --> D3["赛程安排"]
D --> D4["赛事说明"]
D --> D5["参考资源"]
D --> D6["合作伙伴"]
D --> D7["大赛动态"]
H --> H1["评审轮次"]
H --> H2["评分指标"]
H --> H3["评委管理"]
H --> H4["评分进度"]
H --> H5["结果发布"]
3. 全局布局
| 区域 | 说明 |
|---|---|
| 左侧导航 | 一级菜单固定展示,根据权限过滤 |
| 顶部栏 | 当前页面标题、搜索、预览入口、用户菜单 |
| 主内容区 | 列表、表单、详情、配置面板 |
| 右侧抽屉 | 文件选择器、预览、操作日志、快速编辑 |
| 底部固定栏 | 内容编辑页的保存草稿、预览、发布按钮 |
4. 页面设计
4.1 登录页
字段:
| 字段 | 说明 |
|---|---|
| 账号 | 管理员用户名 |
| 密码 | 管理员密码 |
| 记住登录 | 可选,默认不勾选 |
交互:
- 登录成功进入控制台。
- 登录失败显示错误,不透露账号是否存在。
- Token 过期后跳回登录页。
4.2 控制台
模块:
| 模块 | 内容 |
|---|---|
| 数据概览 | 作品数、已发布作品、课程视频、素材数、咨询线索、待评作品 |
| 待办事项 | 未发布草稿、待审核作品、未完成评分、待联系线索 |
| 快捷入口 | 新建作品、上传素材、新建课程、创建评审轮次 |
| 最近操作 | 最近 20 条操作日志 |
4.3 官网内容管理
页面分组:
| 页面 | 可编辑内容 |
|---|---|
| 站点配置 | 公司名称、英文名、产品名、SEO、导航、Logo、社媒链接、备案信息 |
| 首页 Hero | 标语、标题、副标题、按钮、背景图 |
| 提案定位 | 价值主张、交付节奏 |
| 业务版图 | 四个业务卡片、商业全景图 |
| 产品矩阵 | 产品卡片、链接 |
| 解决方案 | 行业方案列表 |
| 客户案例 | 案例标题、行业、描述、结果、封面 |
| 合作咨询 | 适用客户说明、表单提示、提交成功文案 |
编辑方式:
- 左侧区块列表,右侧表单。
- 每个区块有「保存草稿」「预览」「发布」「下架」。
- 富文本只用于长说明,短字段使用普通输入框,避免格式失控。
4.4 赛道内容管理
页面分组:
| 页面 | 可编辑内容 |
|---|---|
| 赛道基础 | 标题、副标题、主题、主办/承办、报名链接、创作入口、Hero 图 |
| 大赛介绍 | 大赛介绍、赛道介绍、赛道定位、支持单位 |
| 赛程安排 | 节点标题、时间文本、开始/结束时间、说明、排序 |
| 赛事说明 | 奖项设置、设计要求、参赛须知、提交材料 |
| 参考资源 | 资源名称、描述、附件、是否开放下载、排序 |
| 合作伙伴 | 名称、角色、Logo、链接、排序 |
| 大赛动态 | 通知标题、日期、正文、状态 |
| 在线学习 | 关联课程视频,按类型和排序展示 |
关键交互:
- 赛程、资源、合作伙伴支持拖拽排序。
- 资源下载可设置开放时间,未开放时前台展示「即将开放」。
- Hero 图、合作伙伴 Logo、奖项图标都从文件库选择。
4.5 素材库
列表字段:
| 字段 | 说明 |
|---|---|
| 缩略图/图标 | 图片展示缩略图,视频和文件展示类型图标 |
| 文件名 | 原文件名 |
| 场景 | 官网、赛道、作品、课程、资源包 |
| 类型 | 图片、视频、模型、文档、压缩包 |
| 大小 | 文件大小 |
| 尺寸/时长 | 图片宽高、视频时长 |
| 上传人 | 管理员 |
| 上传时间 | 创建时间 |
操作:
| 操作 | 说明 |
|---|---|
| 上传 | 支持拖拽上传和选择文件 |
| 复制 URL | 复制公开访问地址 |
| 选择 | 在业务表单中绑定文件 |
| 归档 | 不直接物理删除,先归档 |
4.6 视频/课程管理
列表筛选:
| 筛选 | 说明 |
|---|---|
| 类型 | 宣讲回放、赛道培训 |
| 状态 | 草稿、已发布、已下架、归档 |
| 关键词 | 标题、课程编号、合作方 |
编辑字段:
| 字段 | 说明 |
|---|---|
| 课程编号 | 如 rs-01、tr-01 |
| 类型 | 宣讲回放或培训课程 |
| 标题 | 前台展示标题 |
| 简介 | 列表摘要 |
| 详情 | 详情页介绍 |
| 封面图 | 文件库图片 |
| 视频 | OSS 视频或外部链接 |
| 合作方 | 如北京服装学院 / 模灵科技 |
| 时长 | 文本或自动识别 |
| 排序 | 前台排序 |
| 状态 | 发布状态 |
4.7 作品管理
列表字段:
| 字段 | 说明 |
|---|---|
| 作品编号 | SMT-2026-018 |
| 封面 | 作品封面 |
| 标题 | 作品名 |
| 作者/学校 | 作者和学校 |
| 分类/方向 | 前台筛选和评审分组 |
| 材料状态 | 待补充、已提交、合格 |
| 展示状态 | 草稿、已发布、下架 |
| 点赞/浏览 | 前台统计 |
| 评审状态 | 未入评、评审中、入围、获奖 |
详情页 Tab:
| Tab | 内容 |
|---|---|
| 基础信息 | 标题、编号、作者、学校、分类、方向、摘要 |
| 作品内容 | AIGC 流程、提示词、生成参数、设计亮点、工艺说明 |
| 图片与模型 | 封面、图集、GLB/STL/ZIP |
| 附件 | PDF、说明书、提交材料 |
| 数据 | 点赞、浏览、评分、操作日志 |
4.8 作品评选
评审管理员页面:
| 页面 | 功能 |
|---|---|
| 评审轮次 | 创建初评、复评、决赛,配置时间和状态 |
| 评分指标 | 指标名称、说明、分值、权重 |
| 评委管理 | 评委账号、所属单位、联系方式、状态 |
| 作品分配 | 按分类、学校、随机或手动分配 |
| 评分进度 | 查看每位评委完成情况 |
| 结果汇总 | 排名、平均分、专家分、公众分、最终结果 |
评委页面:
| 页面 | 功能 |
|---|---|
| 我的评审 | 列出被分配作品 |
| 作品评分 | 作品详情、附件预览、按指标打分、评语 |
| 已提交 | 查看已提交评分,锁定后不可修改 |
评分规则:
- 每个轮次可配置多个指标。
- 每个指标有最大分值和权重。
- 评委提交后可在轮次锁定前修改。
- 轮次锁定后评分不可修改,只能由超级管理员走异常更正流程。
- 公众投票折算分单独计算,不覆盖作品点赞数。
5. 权限设计
| 权限码 | 说明 |
|---|---|
site:read、site:write、site:publish |
官网内容查看、编辑、发布 |
competition:read、competition:write、competition:publish |
赛道内容查看、编辑、发布 |
file:read、file:upload、file:archive |
文件查看、上传、归档 |
course:read、course:write、course:publish |
课程查看、编辑、发布 |
work:read、work:write、work:publish |
作品查看、编辑、发布 |
evaluation:manage |
评审配置和结果管理 |
evaluation:score |
评委评分 |
inquiry:read、inquiry:write |
线索查看和状态更新 |
system:manage |
用户、角色、日志 |
6. 表单与校验
| 类型 | 校验 |
|---|---|
| 文本 | 必填、长度限制、去除首尾空格 |
| URL | 校验协议,允许 https://、http://localhost、相对路径 |
| 图片 | 限制 MIME、大小、建议尺寸 |
| 视频 | 限制 MIME、大小,记录时长 |
| 模型 | 允许 GLB、GLTF、STL、OBJ、ZIP |
| 评分 | 不可超过指标最大分,不可为空 |
7. 预览与发布
| 动作 | 说明 |
|---|---|
| 保存草稿 | 不影响前台 |
| 预览 | 生成带 token 的预览地址,读取草稿内容 |
| 发布 | 把草稿写入发布版本,前台 API 读取 |
| 下架 | 前台不再展示,但后台可恢复 |
| 归档 | 历史保留,默认不出现在列表 |
8. 空状态与异常
| 场景 | 展示 |
|---|---|
| 列表无数据 | 显示空状态和新建按钮 |
| 上传失败 | 显示失败原因和重试 |
| 发布失败 | 保留草稿,提示错误 |
| 权限不足 | 显示无权限页面 |
| 评分已锁定 | 表单只读,显示锁定时间 |
9. 前台适配说明
前台第一阶段不重做视觉,只逐步替换数据来源:
index.html从/api/site/config和/api/site/home读取官网内容。competition.html从/api/competition聚合读取赛道内容、赛程、资源、作品、课程。work-detail.html从/api/works/:id读取作品完整详情。course-detail.html从/api/courses/:id读取课程和视频。