# 管理端设计文档 ## 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` 读取课程和视频。