From 5755c43b87569153cb46df889ab163e22cdbfe5d Mon Sep 17 00:00:00 2001
From: chenyuan <chenyuan@example.com>
Date: Thu, 30 Jul 2026 12:37:22 +0800
Subject: [PATCH] docs: define score reference and progress

---
 ...6-07-30-score-reference-progress-design.md | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-07-30-score-reference-progress-design.md

diff --git a/docs/superpowers/specs/2026-07-30-score-reference-progress-design.md b/docs/superpowers/specs/2026-07-30-score-reference-progress-design.md
new file mode 100644
index 0000000..8eaac2b
--- /dev/null
+++ b/docs/superpowers/specs/2026-07-30-score-reference-progress-design.md
@@ -0,0 +1,25 @@
+# 成绩中心参考成绩与实训进度
+
+## 目标
+
+教师端“成绩中心”将原“实训成绩”展示名称调整为“参考成绩”，并在同一列表中新增“实训进度”。本次不改变既有成绩计算、排名、权限或学生数据。
+
+## 数据口径
+
+- **参考成绩**：继续使用当前排名记录中的 `score`，仅调整页面与导出表头的中文名称。
+- **实训进度**：当前教学班中，该学生已有成绩记录的已完成实训任务数，除以该教学班已分配的实训任务总数，显示为百分比。
+- 已完成任务按当前教学班和学生筛选去重后的成绩记录计算，避免同一任务的重复保存导致进度超过 100%。
+
+## 边界规则
+
+- 未选择教学班时，列表保留现有成绩查询行为；进度按每条记录所属教学班计算。
+- 教学班没有已分配任务时，进度显示 `--`，不将其解释为 0%。
+- 没有成绩记录的学生进度显示 `0%`。
+- 进度只作为教师查看数据，不提供编辑入口，也不参与排名或参考成绩计算。
+
+## 实现范围
+
+1. 后端成绩列表接口返回每个学生的进度百分比和已完成/总任务数。
+2. 成绩导出增加“实训进度”列，并将“总分数”表头改为“参考成绩”。
+3. 教师端成绩中心将“实训成绩”改为“参考成绩”，新增只读“实训进度”列。
+4. 增加后端单元测试和前端静态回归，覆盖正常计算、无任务以及页面字段展示。