成绩相关 API

成绩相关接口统一前缀为 /api/v1/score，用于根据原始成绩单与分数线生成成绩单或成绩分析报表。两个接口均需要 multipart/form-data 方式上传文件。

生成成绩单

POST /api/v1/score/transcript

上传原始成绩单与分数线，生成单/双上线统计成绩单 Excel。

请求参数（form-data）

参数	类型	必填	说明
title	string	✅	成绩单标题
scoreSheet	file	✅	原始成绩单文件
lineSheet	file	❌	分数线表格文件（与 lineJSON 二选一）
lineJSON	string	❌	分数线 JSON 文本（与 lineSheet 二选一）

校验规则

• 分数线必须且只能提供一种：lineSheet 与 lineJSON 同时提供，或都不提供，均会返回 400。
• lineJSON 大小不得超过 100 KB，否则返回 400。

请求示例

POST /api/v1/score/transcript
Content-Type: multipart/form-data

title=高三一模
scoreSheet=@原始成绩单.xlsx
lineSheet=@分数线.xlsx

响应示例

{
  "output_path": "D:\\EduAssist\\output\\成绩\\...\\成绩单.xlsx"
}

生成成绩分析

POST /api/v1/score/analysis

上传原始成绩单与分数线，生成成绩分析报表 Excel。

请求参数（form-data）

参数	类型	必填	说明
title	string	✅	分析报表标题
scoreSheet	file	✅	原始成绩单文件
lineSheet	file	❌	分数线表格文件（与 lineJSON 二选一）
lineJSON	string	❌	分数线 JSON 文本（与 lineSheet 二选一）

校验规则

• 分数线二选一的规则与成绩单接口一致。
• lineJSON 同样有 100 KB 上限。

响应示例

{
  "output_path": "D:\\EduAssist\\output\\成绩\\...\\成绩分析.xlsx"
}

提示：lineSheet（表格文件）与 lineJSON（文本）分别对应客户端「分数线输入方式」中的「表格文件」与「手动输入」两种方式。