达成度分析

帮助中心

模块帮助百科 · 共 19 篇

教学工具教师学院管理员超级管理员

功能简介

「达成度分析」是一套课程目标达成情况评估报告生成教学工具：教师录入课程基本信息、课程目标与毕业要求、命题明细、试卷成绩与过程性成绩后，系统自动计算各课程目标达成值与班级总体达成情况，先预览、后下载三份成果文件——成绩登记表、课程考核分析表、课程目标达成度评价报告，并可一键将其作为 PDF 应用到对应课程归档的同名材料位。工具内置多种学科范式（archetype）模板、十余种统计图表、可选的 LLM 叙事增强，以及同课程多教学班的整门课程合并报告。

入口与权限

入口：顶部导航「教学工具 → 课程达成情况评估报告生成」；也可从课程考核材料归档课程归档某条记录的「成绩登记表 / 课程考核分析表 / 课程目标达成度评价报告」材料处点「生成材料」带 archive_id 进入（此时回填课程信息并绑定归档）。
可用角色（排除学生，模块对学生隐藏）：

超级管理员：不受学院开关限制，始终可用。
学院管理员：仅受本学院「达成度分析」模块开关限制。
任课教师 / 责任教授（teacher 角色）：须同时满足「学院已开通该模块」且账号具备 teacher 角色（或教务处类跨学院角色对本模块的授权）。

前提：进入前需在右上角切换到目标学院（无学院上下文会被拦回首页并提示切换）；当前学院须已开通「达成度分析」模块（学院与用户级默认均不开通，需显式分配，见课程考核材料归档同源的模块权限维护）。
权限分层：普通教师只能看到并管理本人创建的历史记录；管理员可见并可删除本学院全部记录。删除历史记录 / 清除共享课程配置、LLM 配置维护、应用到归档时的跨人访问等动作仅管理员（admin / super_admin）可操作。

操作步骤（分角色）

教师：生成一份课程达成度报告

页面工作区为「A 录入与生成」分步表单，建议自上而下完成：

基本信息：填写专业班级、学生数、开课单位、学年学期、课程名称与代码、学时学分、考核方式、考试形式、期末/平时成绩占比，以及过程性成绩各分项（平时、实验报告、团队协作等）的占比。从归档入口进入时，课程名称、代码、教师、班级、考核方式、学年学期等会自动回填。
课程目标与毕业要求：逐个维护课程目标、目标权重（各目标权重之和应接近 1）、对应毕业要求指标点与说明；可「增加课程目标」（最多 5 个）。
命题明细（关键）：维护各题号 / 题型对应的课程目标、满分值、学时与考分分布。命题明细是课程目标归属与满分的唯一权威来源——试卷成绩表只承载学生「得分」，目标与满分一律取自命题明细（旧 xlsm 在成绩表内放目标行/满分行的结构不再兼容）。可单独上传命题明细文件，或在「成绩输入」上传一簿多表文件，系统自动读取其中「1.命题明细」或「命题明细」sheet。
成绩输入：上传试卷成绩与各过程性成绩（平时/实验/团队协作）。试卷成绩来自学校阅卷系统导出；过程性成绩按「序号、学号、姓名、专业班级、成绩-目标N」标准列填写，列名「成绩-目标N」与课程目标数自动联动，缺失的目标列按 0 计。「专业班级」列填了将用于多教学班合并报告的班级分组。
图表与分析文本：每个图表页签对应报告中的一张图，切换图表类型后立即刷新预览；可逐图填写或采用系统自动生成的分析文字。
预览：点「成稿预览」分别核对报告（docx 版式）、课程分析表（xlsx 版式）、成绩登记表三类成稿；预览会同步给出录入校验提示。务必先预览核对再下载。
保存与生成：

「保存草稿」：分步填写过程中随时落盘，草稿不强校验、允许数据不完整。
「B 生成报告」：执行完整校验（课程名称、学生名单、试卷题目结构与成绩、课程目标权重等）后计算并生成三份文件，状态变为「已生成」。

下载：生成后在页首下载「成绩登记表（PDF）」「课程分析表（xlsx）」「达成度分析报告（docx）」。

教师：从归档入口生成并应用到归档

从课程归档材料处带 archive_id 进入时，底部出现「生成并应用归档PDF」：执行生成后，会把三份成果转成 PDF 覆盖写入该归档记录的对应材料位——score_register（成绩登记表）、analysis_sheet（课程考核分析表）、achievement_report（课程目标达成度评价报告）。仅在记录已绑定归档时可用；应用成功后记录登记「已应用到归档」的时间与操作人。

教师 / 管理员：整门课程合并报告（多教学班）

同一门课程同一学期由不同教师 / 不同教学班各自上传记录后，可生成跨班合并的「整门课程报告」：

先「保存草稿」保留本人记录；当本学院该课程该学期存在 ≥2 份可合并记录时，「B+ 生成整门课程报告」按钮自动启用。
合并时按 college_id + 课程名称 + 学期（课程代码一致优先）匹配同伴记录，每个学号只保留首次出现的成绩去重，生成一份独立的合并报告记录。
合并报告附「各教学班对比」：按班级切片统计学生数、卷面均分、总评均分、通过率与各课程目标达成度，并渲染分组柱状图与「班级×课程目标」达成度热图。
从归档入口进入且记录已绑定归档时，可走「合并并应用归档」把合并报告 PDF 覆盖到归档材料位。

管理员：共享课程配置、历史记录与 LLM 配置

共享课程配置（preset）：保存/生成时按课程名称+代码+学年+学期自动 upsert 一份预设，含基本信息与报告文本；下次同课程录入或从归档进入时自动匹配回填。管理员可在历史区清除共享课程配置。
历史记录：管理员可删除本学院任意记录（同时清理已生成文件）。
LLM 叙事增强（可选，仅管理员可见）：勾选「启用 LLM 叙事增强」并选择 profile 后生成，会调用所选模型润色章节叙事；profile 为占位（base_url/model 含 CHANGE_ME）或调用失败时自动回退规则版叙事，不影响出报告。点旁边「管理」进入 /llm_settings 维护 profile（新增/编辑/删除、一键测连接），密钥加密存储、回显仅显示「已设置」。该开关与下拉对学生/普通教师/只读账号三层隐藏，伪造 POST 也不会落地 profile。

字段与状态口径

达成度计算口径

课程目标与各题满分只来自命题明细；试卷成绩 / 过程性成绩表只放学生得分。成绩表内不得再放目标行或满分行。
某目标达成值 = 该目标下各考核小项（期末按命题明细映射、过程性按「成绩-目标N」列）按占比加权得分 / 满分；班级目标达成值取学生均值。
达成阈值为 0.60：低于 0.60 的「目标-学生」记录计入低达成统计（low_count），并在分析文本中标注需重点改进的目标。
总评成绩按「期末占比 + 平时占比」合成，平时再按过程性各分项占比拆分；及格率（pass_rate）按总评 ≥60 统计。

学科范式（archetype） —— 决定章节图谱与默认图表组合，内置 8 种：工科理论（eng-theory，默认）、工科实验（eng-experiment）、理科基础（sci-foundation）、人文社科（humanities）、通识教育（general-ed）、艺术体育（arts-pe）、实践类（practical）、跨专业混合（mixed-major）。未指定时按工科理论处理，等价旧行为。学院级还可叠加学院术语包与配色（如 college_hh、college_tm）。

图表种类：总成绩分布（直方图 / KDE / 箱线 / 小提琴）、课程目标总体图与各目标达成图（柱状、雷达、散点、分组柱、热图、漏斗、桑基、山脊、区间柱）、正态性表/曲线、实验热图/堆叠柱、合并报告的班级对比分组柱与热图等。matplotlib 渲染失败时回退默认柱状图。

记录状态：draft（草稿，不强校验）、generated（已生成三份文件，可下载/应用归档）；应用到归档后另记 applied_to_archive_at / by。合并报告记录的 archive_context_json 含 aggregated_from（参与合并的记录 id）。

常见问题

生成报错「未识别到学生名单 / 试卷成绩未识别到题目结构」：检查试卷成绩或过程性成绩是否含学号、姓名列，命题明细是否填了题号与对应目标、满分。草稿可不完整，但「B 生成报告」会强校验。
课程目标权重报错：各目标权重之和需接近 1（误差 ±0.02 内）。
达成值算出来不对 / 满分对不上：确认满分与目标归属是在命题明细里维护，而不是放在成绩表内；成绩表只放得分。
「B+ 生成整门课程报告」按钮灰着：需先「保存草稿」保留记录，且本学院同课程同学期至少有 2 份不同班级/教师的记录；仅 1 份时按钮不启用。
应用到归档失败 / 按钮不出现：需从归档入口带 archive_id 进入并完成生成；记录未绑定归档时无法应用。班级级达成度报告不在课程间共享，仅课程级、专业级才同步到同课程的其他归档记录（见课程考核材料归档）。
勾了 LLM 增强但叙事还是规则版：所选 profile 为 CHANGE_ME 占位或调用超时/失败时会自动回退规则版，属预期保护；可在「管理 → 一键测连接」排查。
进不去 / 提示先切换学院：右上角切到目标学院，并确认该学院已开通「达成度分析」模块、账号具备 teacher 或管理员角色。