# 学员端“我的成绩”接口 统一前缀:`/exam/student/scores`。旧 `/exam/student/page`、`/exam/student/summary/**`、 `/exam/grades/**` 和 `/score/detail` 已移除。 正式成绩必须同时满足:已经交卷、`exam.mark_flag=1`、`exam_student.mark_flag=1` 且分数非空。 班级均分、排名和个人统计均只使用这一口径,未发布数据不会出现在本模块。 ## 页面接口 - `GET /overview`:平均分、最高分、考试次数和当前/最近班级综合排名。 - `POST /page`:正式成绩分页;请求体支持 `pageNum/pageSize/keyword/type`,`type` 为 `ALL/THEORY/PRACTICE`。 - `GET /{examStudentId}`:单场聚合详情,一次返回公共摘要以及理论或实训分支。 - `GET /{examStudentId}/export`:导出当前学员单场正式成绩CSV。 ## 聚合详情口径 - 理论考试从 `theoretical_paper_student_detail` 返回题目、作答、正确答案、实际得分、判定结果, 并按题型计算个人得分率和班级平均得分率。 - 实训考试只读取 `fz_grades`,同一 `exam_id + user_id + code` 按最大雪花ID取最新记录。 - 实训现有协议没有步骤满分、扣分维度和教师评语,因此接口不会构造这些字段;仅根据 `result` 文本归一化 `PASS/PARTIAL/FAIL` 并计算步骤数量及加权通过率。 - 详情和导出均使用 `examStudentId + JWT学员ID` 查询,不能访问其他学员成绩。