# 学员端“我的成绩”接口 统一前缀:`/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`。查询时兼容数据库中的历史短值 `理论/实训`、规范值 `理论考试/实训考试` 和英文值;响应中的 `type` 保留数据库原始值。 - `GET /{examStudentId}`:单场聚合详情,一次返回公共摘要以及理论或实训分支。 - `GET /{examStudentId}/export`:导出当前学员单场正式成绩CSV。 ## 聚合详情口径 - 理论考试从 `theoretical_paper_student_detail` 返回题目、作答、正确答案、实际得分、判定结果, 并按题型计算个人得分率和班级平均得分率。 - 实训考试只读取 `fz_grades`,同一 `exam_id + user_id + code` 按最大雪花ID取最新记录。 - 详情分支同时识别 `理论/理论考试/THEORY` 和 `实训/实训考试/PRACTICE`,用于兼容历史数据, 不对已有考试记录执行类型迁移。 - 实训现有协议没有步骤满分、扣分维度和教师评语,因此接口不会构造这些字段。步骤判定优先使用 `right_or_wrong`(`true` 为通过、`false` 为失败),历史空值才回退 `result` 文本归一化 `PASS/PARTIAL/FAIL`;`right_or_wrong` 仅用于服务端聚合,不出现在逐题JSON中。 - 实训详情顶部与 `practiceSummary` 共享同一组统计:部分通过按半题计算正确率,空明细的题数、 正确数、错误数、部分正确数和正确率均返回 `0`,正确率按两位小数四舍五入。 - 详情和导出均使用 `examStudentId + JWT学员ID` 查询,不能访问其他学员成绩。