You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
4 weeks ago
|
# 学生首页新版实训模块展示设计
|
||
|
|
|
||
|
|
## 目标
|
||
|
|
|
||
|
|
学生首页不再展示旧版五模块（市场需求挖掘、产品规划、产品投放测试、供应渠道管理、产品评估与考核）。成绩与学习概览统一使用当前实训体系的六模块：互联网产品开发基础认知、市场洞察与需求分析、产品规划与设计、产品开发与测试验证、产品上线与运营推广、综合实训。
|
||
|
|
|
||
|
|
## 数据来源
|
||
|
|
|
||
|
|
首页的模块成绩与实训进度使用 `GET /api/student/experiment-report/current` 作为唯一来源。接口返回每个模块的权重、得分、是否参与、完成任务数、任务总数，以及总成绩。现有学习时长接口仅用于展示总有效学习时长，不再向页面提供任何模块维度数据。
|
||
|
|
|
||
|
|
综合实训仅在教师已向学生所在教学班发布时，才作为参与模块显示。未发布时不展示，不参与成绩与进度计算。
|
||
|
|
|
||
|
|
## 页面改造
|
||
|
|
|
||
|
|
### 成绩概览
|
||
|
|
|
||
|
|
- 替换旧的五项成绩饼图和硬编码表格。
|
||
|
|
- 图表、表格、总成绩均由实训报告的参与模块实时生成。
|
||
|
|
- 表格显示模块名称、成绩占比、模块得分、完成进度。
|
||
|
|
- 旧接口的排名可保留为独立信息；若没有有效排名则显示“--”。
|
||
|
|
|
||
|
|
### 实训进度概览
|
||
|
|
|
||
|
|
- 删除旧五模块的时间占比环图和旧模块学习时长列表。
|
||
|
|
- 以六模块的完成任务数/任务总数展示进度，避免把旧模块时长错误映射到新模块。
|
||
|
|
- 有效学习时间仅保留总时长指标，不再按旧模块拆分。
|
||
|
|
|
||
|
|
## 错误与空数据
|
||
|
|
|
||
|
|
- 接口加载期间显示加载状态。
|
||
|
|
- 接口失败时显示明确的加载失败提示，不回退到旧模块或硬编码数据。
|
||
|
|
- 无任务或无得分时仍展示参与模块，得分与进度为 0。
|
||
|
|
|
||
|
|
## 验收标准
|
||
|
|
|
||
|
|
- 首页不再出现旧五模块名称。
|
||
|
|
- 已发布综合实训的学生看到六模块；未发布的学生看不到综合实训。
|
||
|
|
- 成绩图表、成绩表、进度概览来自同一份新版实训报告数据。
|
||
|
|
- 不再显示旧模块学习时长分布。
|