Files

T

nxxy335 25a2e8a42c 文档部署到 /ny-exam-platform 子路径 + 移除快照/趋势/异常 + 打印与 UI 全面完善

文档站（#88）
- base 默认改为 /ny-exam-platform/，可用 DOCS_BASE=/ 覆盖本地预览
- 新增 DOCS_OUT 环境变量，避免构建时清空输出目录失败导致产物半截
- 新增 tools/docs-preview.js：按子路径重写路由的本地预览服务
- 删除 docs/guide/snapshot.md，同步清理全部相关文档

移除存快照 / 趋势 / 异常（#89）
- 后端：删除 api.php 的 snapshot_save/list/delete/trend 四个 action 与
  $WRITE_ACTIONS 中的同名条目；删除 lib/Snapshot.php 与自动加载注册；
  DataService 移除 detectAnomalies() 及其调用
- 前端：移除三个按钮与三个弹窗、相关 JS 处理与 state 字段
- 测试：移除对应用例，补充 5 条名单导入列识别断言（17+9+18+32+29+11 全过）

打印完善（#90）
- 改用隐藏 iframe 输出，规避弹窗拦截；@page A4 支持纵向/横向
- 表头每页重复、行内不跨页断开、全表连续名次、可选「是否合格」列
- 分组小计（人数/平均/最高/最低/合格人数与合格率）、可附缺考名单另起一页
- 末尾签字栏；缺考名单打印改为同一套输出

UI / 交互 / Bug 修复（#91）
- dashboard.php：补「← 主系统 / 退出」入口（此前全屏后无法离开）；
  修复成员下钻 onclick 里 JSON.stringify 双引号提前闭合属性导致点击报错，
  改为 data-sid 事件委托；补 Esc 关弹窗；后台标签页暂停轮询、切回自动补拉；
  刷新中断原因写入 title；数值字段统一兜底，避免 NaN / undefined%
- draw.php / draw.js：结果表新增「登陆账号」列（导出前可核对，缺失显示 学号 ⚠）；
  弹窗只关最上层且支持 Esc；「全部」改为跟随候选池，手工改人数即解除；
  候选池不足时给出明确提示；自定义比例框隐藏时清空，避免旧权重被误读
- app.js / dashboard.php：成绩着色改为按「占本卷满分的百分比」判断，
  修复满分不是 100 时整列误标红
- style.css：数值列右对齐；新增 subbar、draw-stage-sub；
  看板顶栏窄屏下拉与按钮换行，消除横向滚动

2026-09-11 16:23:08 +08:00

3.0 KiB

Raw Blame History

测试

回归测试分两类：PHP 自测（纯逻辑断言）与 Node e2e（起 mock 服务 + PHP 内置服务器，走真实 HTTP）。

一键运行

bash tests/run-all.sh

脚本会依次执行：

文件	类型	覆盖
`tests/test-aggregate.php`	PHP	聚合、去重、考试次数、排序
`tests/test-new-features.php`	PHP	再次提交置顶排序、XLSX 多表、名单导入列识别
`tools/test-xlsxwriter.php`	PHP	XLSX 写入与 ZIP 打包
`tools/test-config-save.js`	Node e2e	配置保存、连接变化检测、每卷配置隔离、CSRF
`tools/test-draw-alloc.js`	Node e2e	随机抽取名额分配（加权 / 自定义 / 守恒 fuzz）

可通过环境变量覆盖运行时路径：

PHP_BIN=/usr/bin/php NODE_BIN=$(which node) bash tests/run-all.sh

单独运行 PHP 自测

php -d extension_dir="C:/php/ext" -d extension=pdo_sqlite tests/test-aggregate.php
php tests/test-new-features.php

输出为逐条 ✓ / ✗ 断言，结尾给出通过数 / 总数，失败时非零退出。

单独运行 Node e2e

e2e 需要两个进程：

mock 卷王服务（必须在 tools/ 目录下启动，内部用 __dirname 解析相对路径）：

cd tools
node mock-server.js        # 默认监听 19911

PHP 内置服务器（端口 18081）：

php -S 127.0.0.1:18081

然后：

node tools/test-config-save.js
node tools/test-draw-alloc.js

::: warning 测试会污染 data/ e2e 会备份并修改 data/ny.db、data/config.json、data/roster.json，并在结束后恢复。若中途异常中断，请手动检查并还原：

git status data/          # data/ 已被 gitignore，需手工核对

另外测试前请删除 data/login_fail.json，否则可能触发登录限流。 :::

写新测试时注意

陷阱	说明
CSRF	写接口必须带 `_csrf`，e2e 里先从 `config_get` 取全局 token
DB 优先	配置读的是 DB 优先，只备份 `config.json` 不够，必须一起备份 `data/ny.db`
`/tmp` 路径	Node 在 Windows 下会把 `/tmp/x.js` 解析成 `C:\tmp\x.js`，脚本请写在项目目录内
`json_decode`	必须传 `true` 得到关联数组，否则 `is_array(stdClass)` 为 `false` 会静默跳过
mock 账号	mock-server 接受账号 `mock`

手工冒烟清单

改完代码建议至少过一遍：

登录 → 主页面三张卡片有数字
切换班级 → 卡片与表格联动
点某一行 → 能看到该学生的每次提交
导入含 .php 后缀的文件 → 被拒绝
导入正常 .xlsx → 成功，且 data/uploads/ 为空
导出成绩 / 导出缺考 → 能打开，学号不是科学计数法
打印预览 → 默认成绩降序
数据看板全屏进入 / 退出都正常
随机抽取 → 名额守恒

3.0 KiB Raw Blame History Unescape Escape

测试