Admin Access

写入权限生产环境写入需要先解锁。

试运行

试运行检查清单

课前确认

  • 确认老师权限卡可以解锁教师指挥台。
  • 确认课代表权限卡可以解锁课代表任务站。
  • 确认至少 5 张学生卡已绑定真实学生。
  • 确认至少 2 张小队卡已绑定有效小队。
  • 确认 USB HID 读卡器会输入完整卡号并自动回车,或手动读取按钮可作为备用。
  • 投屏打开班级任务大厅,确认角色卡、XP、小队能量和任务记录在白板远距离可读。
  • 试运行前备份 prisma/dev.db,真实数据录入后不要运行 /api/seed。

一节课流程

  • 先投屏班级任务大厅。
  • 老师刷老师卡解锁教师指挥台。
  • 课代表只在登记作业、背词、朗读等任务时解锁任务站。
  • 扫描一张学生卡,发放一次低风险 XP,并确认大屏几秒内更新。
  • 扫描一张小队卡,发放一次小队任务,并确认小队能量变化。
  • 提交一条课代表草稿,由老师审批通过。
  • 测试一次撤销:先看预览对象,确认无误后再撤销。

备用与回滚

  • 读卡失败时,改用手动输入卡号并点击读取。
  • 大屏不刷新时,刷新 /display。
  • 误发奖励时,在教师台点击撤销上一步,确认目标后执行。
  • 连续误操作时停止课堂使用,课后按数据库备份回滚。
  • 课后记录读卡器自动回车是否稳定、白板是否可读、哪些文案仍让老师困惑。