ROLL CALL GUIDE
✅ 课堂签到点名 · 使用指南
登录 → 选班级 → 点气泡签到 → 汇总导出 Excel
🏠 系统概述
点名系统用于课堂签到与随机点名：老师用自己的账号登录后，学生名单自动从云端按班级加载，点一下学生名字 = 签到（自动记时间），再点一下 = 撤销。支持补登历史日期、按时间段汇总出勤、一键导出 Excel。三个系统功能完全一致，只是入口和账号各自独立。
| 系统 | 点名页入口 |
|---|---|
| 贯通班（主系统） | www.dingqianpeng.com/rollcall.html |
| 多学科云端 | /duokeji/rollcall-sx.html（sx=数学、wl=物理、hx=化学、yw=语文、yy=英语，换后缀即可） |
| 高中五科 | /gz/rollcall-sx.html（后缀规则同上） |
登录账号 = 各系统管理页的教师账号（同一套用户名密码，不用新注册）。
学生名单来自管理端已录入的学生，名单是空的就先去管理端录学生。
🔑 一、账号与权限
| 角色 | 能看到谁 | 能做什么 |
|---|---|---|
| 管理员 admin | 全部学生 | 签到/撤销、补登、跨班汇总、导出 Excel |
| 教师 editor | 自己名下的学生 + 公共学生（看不到其他老师私有的学生） | 给自己范围内的学生签到/撤销、补登、汇总导出（仅限自己范围） |
| 只读 viewer | 同上（只读） | 只能看名单和当天签到情况，不能签到、不能汇总导出 |
多学科 / 高中五科注意：每位老师只看得见"自己名下 + 公共"的学生。
如果你发现某个学生不在名单里但确实报了这个科目，多半是他在管理端被录到了别的老师名下——联系管理员改归属，或改为公共学生。
✅ 二、课堂签到（每课必用）
1打开点名页 → 输入账号密码登录（登录状态本页面记住，刷新不用重登）
2顶部班级气泡选择今天上课的班级（名单自动按班分组）
3学生到齐过程中，点一下名字 = 签到（气泡变绿并显示时间）；再点一下 = 撤销（会弹确认）
4底部实时显示「应到 / 已签 / 未签」和未签学生名单，全员到齐会显示 🎉
签到数据实时写入云端：点完刷新页面、换台设备登录，签到状态都在。
同一学生同一天重复签到不会记两次（系统底层有唯一约束兜底）。
🎲 三、随机点名（课堂提问神器）
1顶部切到「随机点名」标签（默认就在这个模式）
2点「开始点名」名字滚动，点「停！」定格抽中一人
3勾选「不重复」后，抽过的人本轮不再被抽到；本次抽中记录显示在下方
随机点名只抽当前选中班级的学生，与签到互不影响。
📅 四、补登历史日期
1签到模式下，把日期从"今天"改成要补登的那天
2页面出现琥珀色提醒「⚠️ 你在补登 X 月 X 日的签到（不是今天）」，确认无误后照常点名字签到/撤销
3补完把日期切回今天，两边数据互不干扰
补登会真实写入那一天的记录，汇总统计时按实际签到日期计算——别把补登当演示乱点。
📊 五、汇总查询与导出 Excel
1切到「汇总」标签 → 选班级（管理员可选"全部班级"）→ 选起止日期 → 「查询汇总」
2表格列出每个学生：已签次数、每次签到的日期+时间、未签日期（全勤标绿、从未签到标灰）
3点「导出Excel」下载 .xlsx 文件，文件名自动带班级和日期范围，打开即可打印/发群
4「复制结果」则是纯文本版，可直接粘贴到微信/Excel
未签日期的口径（重要，别误读数据）：未签 = 该生首次签到之后，本班有人签到而他没签的日子，最多列最近 10 个开课日；全班都没签的日子（调课/放假）不计入。本版不区分迟到，只要当天签了就算出勤。
❓ 六、常见问题
| 问题 | 解答 |
|---|---|
| 登录提示"教师账号或密码有误" | 确认用的是本系统管理页的账号；多学科/高中五科每个科目账号独立，别拿数学的账号登物理的点名页 |
| 登录后名单是空的 | 学生还没录入：去对应系统的管理端「学生管理」先录学生（姓名+班级必填），录完回来重新登录即可 |
| 点签到提示"该学生在其他老师名下" | 多学科/高中五科的归属保护：私有学生只能归属老师本人签。联系管理员在管理端把学生改为公共或改归属 |
| 点错了能撤销吗？ | 能，再点一次该学生气泡，确认后当天这条签到就撤掉 |
| 忘了点签到，下课了怎么办？ | 用「补登」：把日期切回上课那天再签，记录按那天算 |
| 导出按钮是灰的 | 先点「查询汇总」出结果后才能导出；viewer 只读账号不能汇总导出 |
| 导出的 Excel 打开是 CSV？ | 说明当时 Excel 组件没加载成功（网络问题），系统自动降级为 CSV，用 Excel 直接打开即可，内容一样 |
| 签到数据占数据库空间吗？ | 几乎不占。一条签到只有几个字段，一学期一个班也就几百条，可忽略 |
| 学生/家长能查签到吗？ | 本版未开放学生端查询，出勤情况由老师汇总导出后转发 |