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.
dianshang-qianduan/docs/superpowers/specs/2026-08-03-student-home-new...

2.0 KiB

学生首页新版实训模块展示设计

目标

学生首页不再展示旧版五模块(市场需求挖掘、产品规划、产品投放测试、供应渠道管理、产品评估与考核)。成绩与学习概览统一使用当前实训体系的六模块:互联网产品开发基础认知、市场洞察与需求分析、产品规划与设计、产品开发与测试验证、产品上线与运营推广、综合实训。

数据来源

首页的模块成绩与实训进度使用 GET /api/student/experiment-report/current 作为唯一来源。接口返回每个模块的权重、得分、是否参与、完成任务数、任务总数,以及总成绩。现有学习时长接口仅用于展示总有效学习时长,不再向页面提供任何模块维度数据。

综合实训仅在教师已向学生所在教学班发布时,才作为参与模块显示。未发布时不展示,不参与成绩与进度计算。

页面改造

成绩概览

  • 替换旧的五项成绩饼图和硬编码表格。
  • 图表、表格、总成绩均由实训报告的参与模块实时生成。
  • 表格显示模块名称、成绩占比、模块得分、完成进度。
  • 旧接口的排名可保留为独立信息;若没有有效排名则显示“--”。

实训进度概览

  • 删除旧五模块的时间占比环图和旧模块学习时长列表。
  • 以六模块的完成任务数/任务总数展示进度,避免把旧模块时长错误映射到新模块。
  • 有效学习时间仅保留总时长指标,不再按旧模块拆分。

错误与空数据

  • 接口加载期间显示加载状态。
  • 接口失败时显示明确的加载失败提示,不回退到旧模块或硬编码数据。
  • 无任务或无得分时仍展示参与模块,得分与进度为 0。

验收标准

  • 首页不再出现旧五模块名称。
  • 已发布综合实训的学生看到六模块;未发布的学生看不到综合实训。
  • 成绩图表、成绩表、进度概览来自同一份新版实训报告数据。
  • 不再显示旧模块学习时长分布。