区域学情看板

页面元信息

• 终端：教研端 Web
• Astro 路由：/research/report
• 原始 HTML：r_report.html
• 来源章节：4.1.4
• 维护规则：后续以本页面 PRD 为准；若改动影响通用规则，再同步总览 / 全局规则文档。

视觉描述

• 原型引用：产出文档/作业管理模块/原型图/r_report.html。
• 页面顶部为教研管理平台深色导航栏，右侧页标题为“区域学情看板”；标题下方为筛选区，筛选区包含区域级联选择器、学段下拉框、学科下拉框和统计时间范围选择。
• 区域筛选采用多级多选级联样式，已选范围以路径标签形式回显在输入框内；下拉面板按“省份-地级市-区-学校”四列展开，节点支持勾选、取消勾选和跨列联动查看。
• 统计时间采用起止日期方式展示，当前原型示例为2026-03-10至2026-04-08，用于表达“最近30天”的默认统计窗口。
• 内容区上半部分采用双栏布局：左侧为“区域总览”指标卡，右侧为“学校综合排名”卡片；区域总览当前展示参与学校、参与学生、学生使用人数、参与教师、教师使用人数、平均得分率6项指标。
• 学校排名区展示跨市、跨区混排的学校名称、排名序号、得分率；学校名称下方补充省、市、区信息，前3名使用高亮样式；超出卡片高度时在卡片内滚动查看，不额外跳转详情页。
• 页面下半部分为“知识点掌握程度分析”表格，表头包含省份、地级市、区、学校、知识点、上级知识点、得分率；同一地区和学校通过合并单元格聚合展示，得分率通过颜色区分高低掌握状态，并与当前时间筛选保持一致。

功能描述

• 页面入口：教研员从左侧导航“区域学情”直接进入；本页为教研端本期唯一正式页面，定位为区域全量汇总分析页，不承接学校明细编辑、派发任务管理或单学生下钻。
• 默认规则：首次进入页面默认展示教研员权限范围内的区域全量汇总，学段和学科沿用用户上一次成功筛选结果；若无历史记录，则以组织默认学段/学科为准。统计时间默认取最近30天滚动窗口，原型示例展示为2026-03-10至2026-04-08。
• 区域筛选：支持按“省份>地级市>区>学校”逐级展开并多选；已选路径以标签形式展示，可逐个移除；筛选项变更后联动刷新区域总览、学校综合排名和知识点分析3个区域。当前原型未体现“查询/重置”按钮，按即时刷新逻辑定义。
• 学段/学科筛选：学段为小学、初中、高中单选，学科为语文、数学、英语、科学单选；任一筛选项切换后刷新整页数据。若某区域在当前学段/学科下无数据，保留筛选条件并进入空状态，不自动跳转到其他学科。
• 时间段筛选：支持自定义起止日期；开始日期不得晚于结束日期。时间段变更后，区域总览、学校综合排名和知识点分析同步刷新；本期先提供自定义起止日期，不额外写入“近7天/本学期”等快捷筛选。
• 区域总览：6项指标均跟随当前筛选范围和时间段实时变化，用于快速判断该区域覆盖规模和使用深度。其中：
  • 参与学校：当前筛选范围和时间段内，至少产生一条纳入统计作业记录的去重学校数。
  • 参与学生：当前筛选范围和时间段内，被纳入统计作业范围的去重学生数。
  • 学生使用人数：当前筛选范围和时间段内，至少发生一次“提交作业、补拍提交、查看批改结果、查看作业分析”行为的去重学生数。
  • 参与教师：当前筛选范围和时间段内，承担相关作业布置或批改职责的去重教师数。
  • 教师使用人数：当前筛选范围和时间段内，至少发生一次“发布作业、批改作业、查看作业报告”行为的去重教师数。
  • 平均得分率：当前筛选范围内学生实得分总和÷应得总分总和。
• 学校综合排名：学校排名允许跨市、跨区混排，按当前筛选范围内学校得分率降序展示；若得分率相同，按参与学生数降序、学校名称升序排序。每条记录需展示学校名称及其所属省、市、区信息，便于教研员在跨区域比较时快速识别学校归属。本版不写入“按提交率/活跃度切换排名”等扩展能力。
• 知识点分析：表格按“区域-学校-知识点”展示知识点得分率，并通过“上级知识点”字段承接一级/二级知识结构，便于教研员识别薄弱知识点；当前页面仅支持浏览，不写入点击下钻、导出Excel、在线排序等未在原型中体现的能力。
• 加载策略：学校综合排名采用卡片内滚动承载长列表；知识点分析表随页面纵向滚动浏览。当前原型未体现分页控件，本版按单次查询返回当前结果集定义；若后续真实数据量超过性能阈值，需补充分页或虚拟滚动方案。

异常描述

• 无权限访问：当教研员选择超出本人权限范围的地区或学校时，前端应阻止提交该筛选或在接口返回后提示“暂无权限查看该区域数据”，并保留上一次有效查询结果。
• 无参与数据：当当前筛选范围内暂无学校参与、暂无有效提交或暂无批改结果时，区域总览展示0或--，学校排名和知识点分析展示明确空态文案“暂无数据，等待学校执行或统计完成”。
• 时间筛选非法：当开始日期晚于结束日期时，前端需即时阻止查询并提示“开始时间不能晚于结束时间”，保持当前有效结果不被清空。
• 数据统计延迟：当区域汇总任务尚未完成最新一轮聚合时，页面允许展示最近一次已生成的汇总结果，同时提示“数据统计中，请稍后刷新”；知识点表格若尚未生成完成，应单独展示占位或加载态，而不是整页空白。
• 维度缺失：若部分题目尚未绑定知识点或知识点层级不完整，知识点分析表允许显示“未配置知识点”或“上级知识点待补充”，但不影响区域总览和学校排名继续展示。
• 筛选结果为空：当区域、学段、学科组合后无命中数据时，保留当前筛选条件并提供清空筛选或切换条件的操作引导，不自动回退到默认范围。
• 接口失败或超时：区域总览、学校排名、知识点分析需支持分别报错和重试，避免单一区块加载失败导致整页不可用。

数据需求

• 接口：区域权限树接口，返回节点id、节点名称、层级、父节点、是否可选、是否默认选中，用于渲染多级级联筛选。
• 接口：筛选字典接口，返回学段、学科枚举及默认值配置；若默认值由组织配置下发，需同时返回组织级默认学段和默认学科。
• 接口：区域总览接口，入参包含区域节点集合、学段、学科、开始日期、结束日期；出参至少包含参与学校数、参与学生数、学生使用人数、参与教师数、教师使用人数、平均得分率、数据更新时间。
• 接口：学校排名接口，入参包含当前筛选条件、开始日期、结束日期；出参包含学校ID、学校名称、省份名称、地级市名称、区名称、参与学生数、得分率、排名序号。当前默认排序规则固定为得分率降序。
• 接口：知识点掌握明细接口，返回省份、地级市、区、学校、知识点名称、上级知识点路径、得分率、样本数、知识点配置状态；需支持按当前筛选条件和时间段查询。
• 统计口径：教研端看板与教师端作业报告共用同一套统计口径定义，尤其需统一“参与学校”“参与学生”“参与教师”“学生使用人数”“教师使用人数”“平均得分率”的去重和时间窗口规则。
• 缓存策略：需支持记忆上一次成功筛选的区域、学段、学科和起止日期，用于下次进入页面时恢复查询上下文。
• 埋点：页面浏览埋点需记录入口来源、默认筛选条件、最终命中区域数量、开始日期和结束日期。
• 埋点：筛选行为埋点需覆盖区域勾选、区域标签移除、学段切换、学科切换、时间段修改、空态曝光、无权限提示曝光。
• 埋点：内容浏览埋点需覆盖学校综合排名曝光、排名滚动深度、知识点表格滚动深度、低得分率知识点曝光，为后续优化区域运营看板提供依据。