feat:系统框架
This commit is contained in:
commit
c1f1b39e81
25 files changed
+7515
No files matched your search
@@ -0,0 +1,282 @@
|
||||
# 管理端设计文档
|
||||
|
||||
## 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` 读取课程和视频。
|
||||
Reference in new issue
Block a user