PROJECT / SCORE INSIGHT
成绩分析系统
从成绩导入到考试分析与学生追踪。
面向教务人员和教师，将成绩整理、分析与学情记录放在一处。
本页目录
01 / OVERVIEW
项目概览
学校的成绩处理既包括完整考试，也包括周测、单科测验和后续补录。同一批成绩需要按年级、班级和学生分别查看，还要处理缺考、历史记录与不同的统计口径。
从成绩表开始
导入已有表格，先确认数据和学生对应关系，再查看考试结果。学生资料、教师权限、成绩归档和备份用于日常维护。
逐步看到学生个人
从班级与学科表现，到多次考试变化，再进入具体学生的历史记录。分析结果可以导出，便于后续整理和交流。
本页功能依据 9 月重构后的本地版本整理。重构实现已完成，整体验证仍在收尾，新版上线状态尚待确认。
这个项目的开发过程另有 9 篇 记录，分 4 个阶段。先看过程文档
02 / FEATURES
功能与业务细节
导入并核对成绩，查看单次考试，再对照多次考试的变化。从追踪名单进入个人画像时，还可以回到具体考试数据核对判断依据。
成绩导入与核验
将已有成绩表导入系统，通过上传参数、预览与匹配、确认提交三步完成导入。提交前先核对数据与学生对应关系，下面展开其中四个关键环节。
DETAIL / 01
选择文件与考试信息
支持 CSV、XLS、XLSX。多工作表文件可以选择需要导入的部分，并确认本次考试的名称、日期等信息。
成绩信息与学生基础资料分别维护。DETAIL / 02
先检查表格内容
核对表头、成绩预览和校验摘要，按提示处理不符合导入要求的内容。多工作表文件也可以只保留通过校验的部分。
发现问题时保留原因和定位线索。DETAIL / 03
确认学生对应关系
结合学号、姓名和班级核对学生。无法直接确定的记录会列出候选，由人工确认，并检查是否重复选择了同一学生。
预检和人工确认都在写入成绩之前完成。图示为隔离复现的人工匹配示例。DETAIL / 04
确认后写入记录
提交完成后显示成功提示，预览随之重置。导入的成绩可以在成绩记录中查看，再进入该次考试的分析页面。
补录与更正可在完成提示中显示相应处理数量。单次考试分析
在成绩记录左栏选定考试，右侧先查看考试摘要，再进入详情。详情中按年级、班级和学科查看成绩表、分布图和分数线配置。
VIEW / 01
选定考试后进入详情
成绩记录可按名称、年级和考试类型筛选。选中一条记录后，右侧显示考试时间、成绩条数、缺考数和分布概况，点击查看考试详情继续分析。
图示与成绩总览为同一次八年级期末考试：2026 年 6 月 29 日，157 名学生。成绩记录列表先筛选，再选择考试
先筛选八年级的成绩记录；选择前，右侧工作区提示选取一条记录。
VIEW / 02
查看成绩分布
散点图展示学生分数的分布，班级条形图展示各分段人数及均分。成绩表可以按需展开校内排名、联盟排名和 Z 分数。
表格为跨页选段，共展示 35 行；保留原序号、成绩、排名和分页文字。图表交互细节学生点与班级分段
悬停后查看学生信息与定位线，或核对某个班级的分段人数。
成绩表显示切换首屏、校排、联盟排名与 Z 分数
同一场考试可以按需切换成绩表的指标列，结合上方筛选与统计查看。
VIEW / 03
确认分析口径
可以配置各学科的满分和分数线。已有的分线比例支持复制，并按同名学科匹配复用，便于核对不同科目的设置。
查看结果前，可以先回看当前使用的线值。VIEW / 04
从分数线看到学生
围绕选定的分数线设置上、下浮动范围，列出落入区间的学生，同时保留对应线值和判断条件。
名单反映当前规则下的筛查结果。专项统计
围绕具体问题比较班级：例如各班均分、指定前 N 名的均分、高分或不及格人数，以及中位数、四分位距和班级平均 Z 分数。
VIEW / 01
先确定比较范围
选定年级后，选择要统计的学科与指标，填写人数、分数线等参数。配置支持草稿恢复，便于继续调整同一组分析。
统计范围与判断口径明确可查。VIEW / 02
按规则查看结果
结果以表格分别呈现均分、人数和班级层分析，也可以全屏查看。相同规则下的结果可以导出为专项统计 Excel。
页面与导出保留相应的分析口径。统计页签切换人数统计与班级层分析
沿用相同的生效班级和规则，分别查看人数统计与班级分布指标。
多次考试趋势与对比
选择一组考试、年级或班级范围和学科，查看均分等指标随时间的变化，再进入横向对比表逐场核对。
VIEW / 01
看变化与参与范围
趋势页保留考试日期、学科和满分等信息，并提示跳过的记录。达段人数采用累计口径：达到较高分数线，也会计入较低分数线人数。
结合具体考试和参与范围理解变化。趋势图交互数据点悬停与班级开关
移入数据点查看各班得分率，也可以通过班级开关调整图中显示的曲线。
VIEW / 02
把多场结果放在一起
从分析中心沿用当前选择进入对比表，把多场考试的指标放在一起查看，核对纳入与跳过的情况，并可导出对比结果。
趋势和明细对照使用同一组选择。横向对比右侧同一批学生的末场考试
横向滚动后保留冻结的学生列，便于与左侧逐行对应。
批量学情追踪
将多场考试的学生记录汇成追踪名单，按规则显示高位稳定、表现起伏、稳步进阶、位次后移等标签，再逐个查看需要关注的学生。
VIEW / 01
先找到关注对象
名单展示规则标签、参与场次和简短趋势。所选考试中没有成绩记录的学生可以单独查看；数据不足或未触发规则时保留待观察状态。
筛选后的追踪名单可以导出为 CSV。规则筛选效果位次后移名单
从 167 人的追踪名单切换到位次后移页签，集中查看符合该规则的学生。
VIEW / 02
回到数据核对原因
点击学生后，查看涉及的考试、得分、排名百分位、Z 分数及判断条件。临界区间作为额外提示，与主要追踪状态一起展示。
从依据弹窗可继续进入该学生的个人画像。完整考试明细四场数据与规则依据
展开弹窗内的完整明细，核对四场考试的得分与排名。
个人学情画像
把一名学生的各科表现和历史成绩集中查看。同名学生可以通过班级、学号等候选信息确认，再查看个人记录。
VIEW / 01
对照各科得分率
雷达图按得分率绘制，科目数量随有效记录变化。可以选择单场考试，也可以汇集各科最近一次有效成绩；不同科目可能来自不同考试。
汇总模式会提示较早的记录。画像入口与交互学生行下钻与雷达悬停
从成绩表中的学生链接进入个人画像，再通过雷达图查看各科得分、满分、得分率和记录时效。
VIEW / 02
回看历次考试
选择学科后查看历次得分曲线。明细同时列出日期、满分、得分率、班级排名、年级排名和 Z 分数，便于理解变化。
个人 Excel 包含追踪摘要和历史成绩两个工作表；雷达与趋势在页面中查看。日常管理与补充功能
成绩分析之外，还需要维护学生、教师和历史记录。相关操作保留权限范围、变更提示与维护记录。
01身份总览与账号
按使用身份和授权范围查看总览与数据，支持显示名、密码和主题设置。
同场成绩分别展示管理员全年级、班主任本班全科和数学教师授课班数学。账号兼任其他角色时，可见范围按实际授权叠加。
02成绩补录与更正
处理已导入考试中的新增或变化数据，提交前查看新增、变更、跳过和阻断项。
补录用于补充已有记录，更正用于修改已有成绩；先查看变动，再确认提交。
03成绩记录与归档
查找考试、维护名称和日期，归档或恢复记录。
通过操作日志回查成绩变更、导出及状态变化。归档后的历史记录与日常成绩分开管理。
04历史参照对比
将当前考试与归档历史考试作同期或同级参照，查看摘要及结构差异。
历史参照用于对照考试结果，比较时仍需结合年级、学科和考试口径。
05学生资料维护
维护名册、导入并处理冲突，支持升年级、重组分班及最近相关操作的撤销。
班级沿袭信息用于衔接学年变化与历史记录。
06教师账号与教学范围
管理教师账号，以及年级、班级和学科权限。
新学年的教学范围支持续转与撤回，便于按实际安排维护数据权限。
07备份与维护
创建、下载或恢复备份，配置自动备份并查看维护记录。
自动清理保留最新的自动副本，手动副本不参与这一清理。
分析结果的导出
标准成绩单保留学生、学号、班级、各科成绩和总分等信息；专项统计表包含均分对比、人数统计、班级层分析三个工作表，与页面采用的规则对应。
导出菜单工作簿与当前筛选图片
展开成绩表的导出菜单，选择标准 Excel、含分析数据的工作簿或当前筛选结果图片。
还可导出含分析成绩表、班级分布、单次分析报告、多考横向对比、达段人数和个人追踪数据。当前筛选的成绩表可保存为 PNG，批量追踪名单可导出为 CSV。
03 / DELIVERY
使用与本人工作
实习期间承接的项目，开发、部署和维护由本人完成。系统已投入实际业务使用：3 月集中开发并形成单机交付版本，4 月至 6 月继续增补功能、同步服务器并准备交接。7 月离开实习后，系统的继续使用与维护由接手方负责；本机没有后续使用量、频率或导入量记录。7 月 2 日仍保留一次分数线和均分统计口径修订。
功能开发与迭代
完成成绩导入、考试分析和学情追踪等主体流程，后续补充归档、专项统计、成绩更正与导出能力。
业务口径落实
区分普通上传、补录和更正的用途，细化教师的数据范围，并持续调整分数线、均分统计与追踪判断规则。
部署与维护
准备交付包和部署说明，在本人负责期间执行服务器部署、应用更新同步、运行检查和交接准备，处理部署环境与本地版本之间的差异。
重构与核对
整理前端结构、后端模块和错误处理，围绕已有功能、异常行为及导出兼容性开展回归核对。
运行记录更新同步与交接检查
2026 年 6 月 1 日，完成应用更新的全量同步、文件一致性核查与服务健康检查；6 月 4 日，交接说明保存了当日服务检查结果。它们用于说明相应时点的部署、维护和交接准备，不代表之后持续可用或使用规模。交接后的继续使用与维护由接手方负责。
04 / TECHNOLOGY
技术概览
当前版本以 React 和 TypeScript 组织页面，用 ECharts 展示图表。Node.js 后端负责接口和业务处理，MySQL 保存成绩及相关记录。
- 01
页面与图表
React · TypeScript · ECharts
组织导入、分析与追踪页面，展示表格、趋势和个人画像。
- 02
接口与业务处理
Node.js
处理会话与权限、导入校验、统计分析和结果导出。
- 03
成绩与历史记录
MySQL
持久化学生、考试和成绩等业务数据，支撑查询与历史追踪。
技术记录重构中的职责与错误处理
9 月的整理重点是前端页面结构、后端模块职责与错误处理。导出代码按数据、布局与序列化等职责拆分，并对照已有工作簿检查兼容性；阶段检查与整体验证分别记录。
05 / EVOLUTION
项目演进与记录
这是实习期间承接的项目：2026 年 3 月集中完成主体开发，4 月至 6 月持续增补并准备交接；7 月离开实习后由接手方继续使用和维护，9 月初另行完成前后端重构实现。
完成主体开发
阶段记录
主体开发集中在 3 月，约一个月内完成成绩导入、管理、分析、追踪与导出的主要流程。
变化与结果
导入模型结合周测、单科上传和补录场景进行了调整；3 月末形成单机交付版本。
学校部署与增补
阶段记录
项目进入学校环境部署，部署方案由应用与数据库分开运行调整为同机部署。
变化与结果
功能侧继续完善归档、专项统计和成绩更正，逐步细化成绩记录、分析与导出的使用方式。
追踪、统计与交接
阶段记录
补充批量学情追踪，让临界生筛查复用考试详情中的分线配置。
变化与结果
导出、权限和对比展示继续修正；6 月 1 日完成应用更新同步，6 月 4 日完成交接检查。
关联记录更新同步与交接
6 月 1 日的同步记录保存了应用更新后的文件一致性核查与健康检查结果。6 月 4 日的交接说明也保留了当日运行检查；这些记录反映本人负责期间相应时点的维护与交接准备。
阅读这一阶段的过程记录交接后的维护边界
阶段记录
因不在当地，6 月底至 8 月暂停常规维护。
变化与结果
7 月离开实习后，继续使用与维护由接手方负责；7 月 2 日仍保留一次分数线和均分统计口径修订。
关联记录维护期间的补充记录
维护暂停的时间与原因依据本人回顾。交接后的使用和维护记录不在本机；7 月 2 日保留一条业务修订，7 月 9 日还有工具链更新。
前后端重构
阶段记录
9 月初完成前后端重构实现。前端迁移到 React 与 TypeScript，后端整理模块职责、错误处理和导出代码。
变化与结果
相关功能与导出兼容检查已有阶段记录，整体验证仍在收尾，新版上线状态尚待确认。
成绩分析系统 / 过程记录
过程文档
回看需求的变化、方案的调整和阶段里的复盘。