QUIZ SYSTEM GUIDE
📝 课堂小测系统 · 使用说明
课后小测录入 → 学情诊断 → 一键导出 → 家长反馈
🏠 系统概述
课堂小测系统是贯通班教学平台的轻量化子系统，专门用于记录和分析每周课后小测（10-15题），与大考成绩系统数据完全隔离。
| 功能 | 说明 | 使用者 |
|---|---|---|
| 教师管理端 | 学生管理、小测创建、快速录入、发布导出、数据备份 云端 | 教师 |
| 家长反馈端 | 学生/家长查询小测成绩、知识点掌握情况、诊断建议 云端 | 学生/家长 |
教师端：
学生端：
注意：小测系统与大考系统（manage-supabase.html）的数据互不影响。两个系统各自独立存储。
📚 物理 / 化学 / 英语 / 语文的小测系统在多学科门户：
https://www.dingqianpeng.com/quiz-manage-supabase.html学生端：
https://www.dingqianpeng.com/quiz-feedback-supabase.html注意：小测系统与大考系统（manage-supabase.html）的数据互不影响。两个系统各自独立存储。
📚 物理 / 化学 / 英语 / 语文的小测系统在多学科门户：
https://www.dingqianpeng.com/duokeji/ → 选科目 →「小测管理 / 小测查询」。
🔐 一、登录
教师端打开 https://www.dingqianpeng.com/quiz-manage-supabase.html
1输入用户名和密码（与大考系统共用账号）
2登录后进入左侧导航栏的教师控制台
学生端登录：学生用姓名 + 学号登录
🆕 云端同步：数据自动保存到 Supabase，换电脑打开数据自动加载，无需手动导入导出。
quiz-feedback-supabase.html，可查看自己的小测记录和知识点诊断。🆕 云端同步：数据自动保存到 Supabase，换电脑打开数据自动加载，无需手动导入导出。
👥 二、学生管理 云端共享
小测系统与大考系统共用同一套学生数据（Supabase students 表）。在大考系统添加的学生会自动出现在小测系统中。
手动添加
1左侧导航 →「学生管理」
2点击「+ 添加学生」→ 填写姓名、班级、学号、年级
3默认密码 123456，建议设为学号，便于家长记忆
Excel 批量导入
1点击「📥 下载模板」→ 获得 Excel 模板文件
2在 Excel 中填写：姓名、班级、学号、年级
3点击「📤 Excel导入」→ 选择填好的文件 → 完成
班级填写完整名称：「七年级贯通班」「八年级贯通班」「九年级贯通班」。
同名学生会自动覆盖更新，不会重复添加。
同名学生会自动覆盖更新，不会重复添加。
📝 三、创建与录入小测
这是教师最常用的功能，每次课后30秒完成录入。
创建小测
1左侧导航 →「小测管理」→ 点击「+ 创建小测」
2选择年级（七年级/八年级/九年级）
3填写小测名称（如"第3讲 因式分解 课后测"）和日期
4设置题目数量（1-15题）和每题分值
5为每道题标注知识点（如"十字相乘法"），用于诊断报告
快速录入成绩
1创建后进入「快速录入」页面
2表格自动列出该班级所有学生 × 所有题目
3逐一点击：✅（对）/ ❌（错）/ ⊖（半对）
4点击「保存」
一节课通常10-15题，一个班15人左右，全程点选不超过30秒。
每题标注的知识点会自动汇总到家长诊断报告中。
每题标注的知识点会自动汇总到家长诊断报告中。
📊 四、诊断与分析
录入后自动生成学情诊断，帮助教师和家长了解掌握情况。
教师端查看
1左侧导航 →「诊断分析」→ 选择班级和小测
2查看：得分率分布、错误率最高的题目、薄弱知识点统计
3可选择「数据备份」导出纯数据文件
学生端查看 云端
- 小测概览：总次数、平均得分率、最近一次得分率
- 每次小测明细：日期、名称、对题数/总题数、得分率进度条
- 错题知识点汇总：自动列出答错题目所对应的知识点
- 诊断建议：基于得分率生成改进建议
🆕 云端实时查询：学生登录
quiz-feedback-supabase.html 即可实时查看，无需教师手动导出上传。
📤 五、导出与发布 可选
云端版已支持学生实时查询，导出功能为可选备用。
1左侧导航 →「发布导出」→ 选择班级
2点击「导出为本班反馈页面」
3系统自动生成加密的独立 HTML 文件并下载
4将该 HTML 文件上传到阿里云 OSS 即可分享给家长
导出的 HTML 文件是加密的，数据内嵌在文件中，家长无需网络即可离线查看。
云端版已不需要频繁导出：学生直接登录
云端版已不需要频繁导出：学生直接登录
quiz-feedback-supabase.html 即可实时查看。
🔄 六、与大考系统的区别
| 对比 | 大考系统 | 小测系统 |
|---|---|---|
| 使用场景 | 期中/期末/阶段大考 | 每周课后小测（10-15题） |
| 学生数据 | 共用 Supabase students 表 | |
| 录入方式 | 逐题输入分数 | 点选 ✅/❌/⊖ |
| 分析深度 | 雷达图、热力图、Z-Score、AI评价 | 得分率、知识点掌握条、诊断建议 |
| 云端同步 | Supabase（scores 表） | Supabase（quiz_tests + quiz_records 表） |
🚀 七、三分钟快速上手
1打开 quiz-manage-supabase.html，登录系统
2「学生管理」→ 添加学生（或在大考系统已添加则自动出现）
3「小测管理」→ 创建小测 → 设置题目数和知识点
4「快速录入」→ 逐一点 ✅/❌ → 保存
5学生打开 quiz-feedback-supabase.html 实时查看成绩
每次课后花 30秒 录入，学生就能实时看到自己的学习轨迹。
❓ 八、常见问题
| 问题 | 解答 |
|---|---|
| 学生查不到自己的小测成绩 | 检查是否选择了正确的年级（学生端页面上方有年级选择） |
| 小测数据会影响大考成绩吗？ | 不会。两个系统存储完全独立（scores vs quiz_records） |
| 怎么给不同年级创建小测？ | 创建小测时选择对应年级，录入时自动过滤该年级学生 |
| 换电脑后数据还在吗？ | 在。数据已同步到 Supabase 云端，新电脑登录后自动加载 |
| 删除小测失败怎么办？ | 系统会弹出错误提示。检查网络后重试，或使用"数据备份"手动导出 |
| 学生端微信打开正常吗？ | 可以。学生端是云端实时查询，不依赖浏览器本地存储 |