From 214ea327376a3753fe0f86447d0ba2b3a8718ba2 Mon Sep 17 00:00:00 2001
From: chenyuan <chenyuan@example.com>
Date: Mon, 3 Aug 2026 14:05:17 +0800
Subject: [PATCH] docs: specify student home new module dashboard

---
 ...6-08-03-student-home-new-modules-design.md | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-08-03-student-home-new-modules-design.md

diff --git a/docs/superpowers/specs/2026-08-03-student-home-new-modules-design.md b/docs/superpowers/specs/2026-08-03-student-home-new-modules-design.md
new file mode 100644
index 0000000..8f8e133
--- /dev/null
+++ b/docs/superpowers/specs/2026-08-03-student-home-new-modules-design.md
@@ -0,0 +1,39 @@
+# 学生首页新版实训模块展示设计
+
+## 目标
+
+学生首页不再展示旧版五模块（市场需求挖掘、产品规划、产品投放测试、供应渠道管理、产品评估与考核）。成绩与学习概览统一使用当前实训体系的六模块：互联网产品开发基础认知、市场洞察与需求分析、产品规划与设计、产品开发与测试验证、产品上线与运营推广、综合实训。
+
+## 数据来源
+
+首页的模块成绩与实训进度使用 `GET /api/student/experiment-report/current` 作为唯一来源。接口返回每个模块的权重、得分、是否参与、完成任务数、任务总数，以及总成绩。现有学习时长接口仅用于展示总有效学习时长，不再向页面提供任何模块维度数据。
+
+综合实训仅在教师已向学生所在教学班发布时，才作为参与模块显示。未发布时不展示，不参与成绩与进度计算。
+
+## 页面改造
+
+### 成绩概览
+
+- 替换旧的五项成绩饼图和硬编码表格。
+- 图表、表格、总成绩均由实训报告的参与模块实时生成。
+- 表格显示模块名称、成绩占比、模块得分、完成进度。
+- 旧接口的排名可保留为独立信息；若没有有效排名则显示“--”。
+
+### 实训进度概览
+
+- 删除旧五模块的时间占比环图和旧模块学习时长列表。
+- 以六模块的完成任务数/任务总数展示进度，避免把旧模块时长错误映射到新模块。
+- 有效学习时间仅保留总时长指标，不再按旧模块拆分。
+
+## 错误与空数据
+
+- 接口加载期间显示加载状态。
+- 接口失败时显示明确的加载失败提示，不回退到旧模块或硬编码数据。
+- 无任务或无得分时仍展示参与模块，得分与进度为 0。
+
+## 验收标准
+
+- 首页不再出现旧五模块名称。
+- 已发布综合实训的学生看到六模块；未发布的学生看不到综合实训。
+- 成绩图表、成绩表、进度概览来自同一份新版实训报告数据。
+- 不再显示旧模块学习时长分布。