第 1 章
账号与登录
功能说明：为教师与学生提供统一账号入口；账号由教师/管理员创建或批量导入，无自助注册、无账号认领；首次登录需核对个人资料；登录具备防爆破与多设备会话能力。
本页目录
本章逐模块描述软件功能，每节包含：功能说明、操作入口、操作步骤、业务规则、异常处理，并配有实际运行界面截图（演示数据环境）。
功能说明：为教师与学生提供统一账号入口；账号由教师/管理员创建或批量导入，无自助注册、无账号认领；首次登录需核对个人资料；登录具备防爆破与多设备会话能力。
操作入口：学生与教师共用登录页 /（学生现场）与 /login（后台登录页）。
操作步骤（学生/教师）
- 打开教师提供的地址，进入登录页；
- 选择"所在学校"（邮箱登录可不选学校）；
- 输入"用户名（学号）/ 邮箱 + 密码"，点击「登 录」；
- 首次登录跳转"核对个人信息"页，确认姓名（可更正）与邮箱后点击「确认无误，进入答题」；
- 教师登录后页面提示"进入管理后台"，点击即进入实时场控。
登录页
首次登录资料确认
业务规则
| 规则项 | 取值/说明 |
|---|---|
| 用户名唯一性 | 校内唯一：UNIQUE(school_id, username)；邮箱全局唯一 |
| 登录账号形式 | 学号/用户名（需选学校）或邮箱（可不选学校） |
| 会话 | HttpOnly Cookie qt，有效期 30 天；单账号允许同时在线设备数 10 |
| 防爆破（账号维度） | 连续失败 5 次 → 锁定 300 秒 |
| 防爆破（IP 维度） | 同一来源 IP 在 300 秒窗口内失败 20 次 → 返回 429 |
| 密码存储 | scrypt 哈希（含随机盐），不可逆 |
| 初始密码 | 批量导入时留空则系统随机生成，随"初始密码清单"下发 |
| 初始密码清单时效 | 30 天内可下载（超期需重新生成） |
| 失败文案 | 账号不存在/密码错误/账号锁定/账号停用统一同一条文案，防止账号枚举 |
异常处理
| 现象 | 处理 |
|---|---|
| 提示"登录失败，用户名/邮箱或密码错误，或账号不可用" | 核对学校选择是否正确（学号登录必须选对学校）；确认密码；连续失败会临时锁定，等待 5 分钟或由教师「解除锁定」 |
| 提示"该学校已停用" | 联系平台管理员启用学校 |
| 提示"账号已停用" | 由管理员在账号管理中重新启用 |
| 提示"尝试次数过多，请稍后再试" | 触发 IP 限流，稍后重试 |