========================================================
 会计经审考试系统 —— 已部署机房的升级说明
 （适用于已在机房装好旧版本的电脑，逐个机房操作）
========================================================

【升级包】桌面上的「会计经审考试系统-部署包.zip」（最新版）

--------------------------------------------------------
一、如果是用「启动服务器.bat」方式部署的（装了 Python）
--------------------------------------------------------
 1. 先在教师机双击关闭正在运行的服务器窗口（或按 Ctrl+C 停止）。
 2. 解压新版部署包，全选里面的所有文件和文件夹 → 复制。
 3. 打开机房里的原系统文件夹，粘贴 → 提示"是否替换"选「替换所有」。
    ★ 重要：不要删除、不要覆盖 data 文件夹（里面是题库、名单、成绩数据）。
 4. 重新双击「启动服务器.bat」→ 服务启动。
 5. 在教师机浏览器里按 Ctrl+F5 强制刷新一次（加载新版页面）。
 完成。4 个机房都照此操作。

--------------------------------------------------------
二、如果是用「打包exe.bat」生成 exe 部署的
--------------------------------------------------------
 1. 因为服务端代码有更新，需要用新版重新打一次 exe：
    在任意一台 Windows 电脑上解压新版部署包 → 双击「打包exe.bat」
    → 得到 dist\会计经审考试系统.exe
 2. 关闭旧 exe → 用新 exe 替换旧 exe（★ data 文件夹保持不动）
 3. 双击新 exe 启动 → 浏览器 Ctrl+F5 刷新。
 完成。

--------------------------------------------------------
三、升级后必做的检查（每机房 1 分钟）
--------------------------------------------------------
 1. 打开管理端 → 用口令 admin 直接登录（新版不强制改密；如需加固可在
    「系统设置 → 强制修改默认口令」开启，开启后必须先改密才能用管理功能）。
 2. 题库管理：确认题型统计只有 单选 / 多选 / 判断 三类（15/20/15 道，共 100 分）；
    如果统计里出现其它题型，说明是本机旧演示数据，请：
      题库管理 → 清空题库 → 重新导入正式试卷（试卷50题.xlsx）
      考试场次 → 删除旧场次 → 重新新建场次（否则旧场次仍引用旧题目）
 3. 考生管理：确认名单人数正确（各机房都导全名单也可以）。
 4. 考试场次：核对开考时间、时长、迟到禁入、考生须知是否与组委会一致。
 5. 压力自检（建议每机房跑一次）：命令行执行 python load_test.py --students 50
    → 看输出里"异常记录"是否为 0 条、"排名表行数"是否等于考生数。

--------------------------------------------------------
四、本次升级包含的新内容
--------------------------------------------------------
 · 容量已验证：200 人同时考试（同时登录→答题→同时交卷）35～45 秒全部完成、
   11,605 次请求 0 失败；到点 200 份答卷同时判分最慢 3.8 秒完成；内存峰值 83MB
 · 新增：管理端「系统设置 → 查看服务器日志 / 导出日志文件」
   （出现"服务器内部错误"时可直接查看原因与出错位置，日志文件 data/server.log）
 · 新增：考前压力自检脚本 load_test.py（独立端口+临时数据，不影响正式数据）
 · 稳定性：并发连接上限大幅提高；Linux/macOS 启动时自动提升文件句柄上限；
   未预期异常连同调用栈写入日志，便于定位偶发故障
 · 已有功能：成绩排名页「导出缺考名单」；多机房 CSV 逐个上传自动累计去重；
   断电/断网恢复、到期自动收卷、迟到禁入、提前交卷限制、答卷复核
 · 界面只保留 单选/多选/判断 三种题型：删掉了"主观题批改"入口与
   客观分/主观分/待批改等字样；考生成绩单只显示「成绩 / 答题用时 / 交卷时间」
 · 答案保密：考生交卷后只看到"你的答案 + 得分"，看不到参考答案
   （防止提前交卷的考生把答案传给同学；教师端"答卷复核"仍可看参考答案）
 · 多机房成绩合并的 CSV 列同步精简（旧版 10 列 CSV 仍可正常合并）
 · 安全与可靠性加固（本轮全面审查后修复）：
   ① 考生关掉浏览器/断电时，服务器到点会自动收卷归档（原先会一直卡在"答题中"、成绩丢失）；
   ② 开考后禁止再修改/删除该场次用到的题目（防止判分依据被改）；
   ③ 交卷/收卷后不能再写入答案（修掉并发竞态）；答案保存带版本号，迟到的旧请求不会覆盖新答案：
   ④ 判分改为"立即事务"，避免"读到旧答案、算出新分数"的不一致；
   ⑤ 管理端可"下载数据备份"（不停服务也能拿到一致的完整数据）；
   ⑥ 退出登录/修改口令会真正注销会话（改密后其它设备上的管理登录立即失效）；
   ⑦ 合并 CSV 改为按表头识别列：在 Excel 里调过列顺序也不会静默读错；
   ⑧ 题库导出防 Excel 公式注入；导入校验更严（分值必须有效、选项必须连续、
      超长/超行数/GBK 编码都有明确提示）；
   ⑨ 到点自动交卷若遇断网不再每秒弹窗，改为顶部提示并静默重试。
 · 缺考口径：排名表只列有成绩的人，缺考用"导出缺考名单"核对
 · 已修复：导出按钮报错、旧浏览器弹框跑到左上角、切屏提示遮挡交卷按钮、
   成绩单明细打印无表头、合并成绩被覆盖等问题

--------------------------------------------------------
五、合并总成绩（四个机房全部考完后）
--------------------------------------------------------
 1. 各机房管理端「成绩排名」→ 导出本机房 CSV（文件名如 成绩排名.csv）
    用 U 盘拷到汇总机房（4 个机房任选一台即可）。
 2. 汇总机「成绩排名」→ 选场次 → 点「合并其他机房成绩」
    → 逐个选择其他 3 个机房的 CSV（会自动累计，页面顶部显示累计人数）。
 3. 核对顶部提示："总排名共 X 人（名单 N 人，缺考 M 人）"
    → 点「导出缺考名单」核实缺考人员。
 4. 点「打印排名表」打印（勾选"页眉和页脚"显示页码），
    或点「下载打印版文件」存 U 盘留档。
 5. 主考官、监考人员在排名表落款处签字，主办单位盖章。

 提示：四个机房教师机务必对时（排名同分时按用时排序，需要时钟一致）。

 【合并成绩四条铁律（已用 4 机房 62 人实测通过）】
  1. 只上传系统导出的原始 CSV，不要用 Excel 打开后另存（会吃掉准考证号前导零，
     把一个人算成两个人；系统会弹 ⚠ 警告提示）；
  2. 合并后看提示"总排名共 X 人（名单 M 人，缺考 K 人）"：X 不能超过 M；
  3. 合并结果只在当前网页里，刷新或关闭页面就要重新上传，所以合并完立刻打印/导出留存；
  4. 同一个机房的文件重复上传、或把"合并结果 CSV"再传一次，都不会重复计人。
========================================================