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

283 lines
9.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 管理端设计文档
## 1. 设计原则
1. 以运营效率为主,不做通用建站器。
2. 页面结构固定,后台只暴露需要运营维护的字段。
3. 所有影响前台展示的内容都支持草稿、预览、发布。
4. 上传、选择、绑定文件是高频操作,文件选择器应在所有内容表单中复用。
5. 评委端保持简洁,只展示被分配作品和评分表单。
## 2. 信息架构
```mermaid
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 登录页
字段:
| 字段 | 说明 |
| --- | --- |
| 账号 | 管理员用户名 |
| 密码 | 管理员密码 |
| 记住登录 | 可选,默认不勾选 |
交互:
1. 登录成功进入控制台。
2. 登录失败显示错误,不透露账号是否存在。
3. Token 过期后跳回登录页。
### 4.2 控制台
模块:
| 模块 | 内容 |
| --- | --- |
| 数据概览 | 作品数、已发布作品、课程视频、素材数、咨询线索、待评作品 |
| 待办事项 | 未发布草稿、待审核作品、未完成评分、待联系线索 |
| 快捷入口 | 新建作品、上传素材、新建课程、创建评审轮次 |
| 最近操作 | 最近 20 条操作日志 |
### 4.3 官网内容管理
页面分组:
| 页面 | 可编辑内容 |
| --- | --- |
| 站点配置 | 公司名称、英文名、产品名、SEO、导航、Logo、社媒链接、备案信息 |
| 首页 Hero | 标语、标题、副标题、按钮、背景图 |
| 提案定位 | 价值主张、交付节奏 |
| 业务版图 | 四个业务卡片、商业全景图 |
| 产品矩阵 | 产品卡片、链接 |
| 解决方案 | 行业方案列表 |
| 客户案例 | 案例标题、行业、描述、结果、封面 |
| 合作咨询 | 适用客户说明、表单提示、提交成功文案 |
编辑方式:
1. 左侧区块列表,右侧表单。
2. 每个区块有「保存草稿」「预览」「发布」「下架」。
3. 富文本只用于长说明,短字段使用普通输入框,避免格式失控。
### 4.4 赛道内容管理
页面分组:
| 页面 | 可编辑内容 |
| --- | --- |
| 赛道基础 | 标题、副标题、主题、主办/承办、报名链接、创作入口、Hero 图 |
| 大赛介绍 | 大赛介绍、赛道介绍、赛道定位、支持单位 |
| 赛程安排 | 节点标题、时间文本、开始/结束时间、说明、排序 |
| 赛事说明 | 奖项设置、设计要求、参赛须知、提交材料 |
| 参考资源 | 资源名称、描述、附件、是否开放下载、排序 |
| 合作伙伴 | 名称、角色、Logo、链接、排序 |
| 大赛动态 | 通知标题、日期、正文、状态 |
| 在线学习 | 关联课程视频,按类型和排序展示 |
关键交互:
1. 赛程、资源、合作伙伴支持拖拽排序。
2. 资源下载可设置开放时间,未开放时前台展示「即将开放」。
3. 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 作品评选
评审管理员页面:
| 页面 | 功能 |
| --- | --- |
| 评审轮次 | 创建初评、复评、决赛,配置时间和状态 |
| 评分指标 | 指标名称、说明、分值、权重 |
| 评委管理 | 评委账号、所属单位、联系方式、状态 |
| 作品分配 | 按分类、学校、随机或手动分配 |
| 评分进度 | 查看每位评委完成情况 |
| 结果汇总 | 排名、平均分、专家分、公众分、最终结果 |
评委页面:
| 页面 | 功能 |
| --- | --- |
| 我的评审 | 列出被分配作品 |
| 作品评分 | 作品详情、附件预览、按指标打分、评语 |
| 已提交 | 查看已提交评分,锁定后不可修改 |
评分规则:
1. 每个轮次可配置多个指标。
2. 每个指标有最大分值和权重。
3. 评委提交后可在轮次锁定前修改。
4. 轮次锁定后评分不可修改,只能由超级管理员走异常更正流程。
5. 公众投票折算分单独计算,不覆盖作品点赞数。
## 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. 前台适配说明
前台第一阶段不重做视觉,只逐步替换数据来源:
1. `index.html` 从 `/api/site/config` 和 `/api/site/home` 读取官网内容。
2. `competition.html` 从 `/api/competition` 聚合读取赛道内容、赛程、资源、作品、课程。
3. `work-detail.html` 从 `/api/works/:id` 读取作品完整详情。
4. `course-detail.html` 从 `/api/courses/:id` 读取课程和视频。