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-07-30-score-reference-...

1.5 KiB

成绩中心参考成绩与实训进度

目标

教师端“成绩中心”将原“实训成绩”展示名称调整为“参考成绩”,并在同一列表中新增“实训进度”。本次不改变既有成绩计算、排名、权限或学生数据。

数据口径

  • 参考成绩:继续使用当前排名记录中的 score,仅调整页面与导出表头的中文名称。
  • 实训进度:当前教学班中,该学生已有成绩记录的已完成实训任务数,除以该教学班已分配的实训任务总数,显示为百分比。
  • 已完成任务按当前教学班和学生筛选去重后的成绩记录计算,避免同一任务的重复保存导致进度超过 100%。

边界规则

  • 未选择教学班时,列表保留现有成绩查询行为;进度按每条记录所属教学班计算。
  • 教学班没有已分配任务时,进度显示 --,不将其解释为 0%。
  • 没有成绩记录的学生进度显示 0%
  • 进度只作为教师查看数据,不提供编辑入口,也不参与排名或参考成绩计算。

实现范围

  1. 后端成绩列表接口返回每个学生的进度百分比和已完成/总任务数。
  2. 成绩导出增加“实训进度”列,并将“总分数”表头改为“参考成绩”。
  3. 教师端成绩中心将“实训成绩”改为“参考成绩”,新增只读“实训进度”列。
  4. 增加后端单元测试和前端静态回归,覆盖正常计算、无任务以及页面字段展示。