典型业务流程

教师：选择房间 → 抽题（或临时出题）→ 设置次序/公布方式/限时 → 点「开始」
   ↓
学生：浏览器登录 → 输入房间码进房 → 出现第 1 题 → 选答案 → 提交
   ↓
系统：判分（答对 +10）→ 写入 attempt_items → 更新排行榜与作答分布
   ↓
教师：查看分布/名单 → 「公布答案」→ 「下一题」→ …… → 「结束本场并结算」
   ↓
系统：归档为一场记录（session_users 汇总）→ 统计报告可查 → 学生「我的记录」可见解析

教师：题库组卷（设分值/限时）→ 房间&考试页「＋发起整卷考试」→ 生成考试码
   ↓
学生：/exam?code=XXXXXX → 进入考试 → 逐题作答（自动保存，断线续答）→ 「交卷」
   ↓
系统：即时判分 → 写 session_users/attempt_items → 场控「作答进度」实时刷新
   ↓
教师：倒计时结束或提前「结束考试（收卷）」（未交卷者自动交卷）→ 查看详细报告
   ↓
学生：我的记录 → 逐题解析（受 reveal_policy 控制）

管理员：下载 CSV 模板 → 填写名单（姓名/用户名/初始密码可留空）
   ↓
上传 → 预览（新增/冲突/错误）→ 确认导入 → 下载「初始密码清单」
   ↓
线下发号 → 学生首次登录 → 核对个人资料 → 进入答题
   ↓
（学生忘记密码 → 教师在账号管理「重置密码」→ 学生用新密码登录）

教师：本地判分工具打开标准答案 → 导出考点 JSON → 题库建题并上传三件套 → 组卷/出题
   ↓
学生：下载模板 → WPS/Excel 操作 → 点「提交」上传 → 浏览器内判分 → 显示得分与小题对错
   ↓
系统：保存作答文件（excelstore/）+ subs 计分结果 → 卷面折算计入总分
   ↓
教师：场控页看逐小题得分 → 下载单份作答或批量打包 zip

启动 → 6 秒后检查清单（MD5/版本比对）→ 有新版则提示
   ↓
管理员点「下载并升级」→ 分卷下载 → 逐卷 MD5 校验 → 合并整包校验
   ↓
备份数据库 → 原地替换 exe（旧文件 → .old）→ 校验失败自动回滚
   ↓
优雅关闭本进程 → 用户双击重启 → 新版本生效（版本号、页脚、/api/svc/ping 同步）
   ↓
（异常时可点「回退到上一版本」）