Files
ny-exam-platform/docs/guide/draw.md
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

79 lines
2.9 KiB
Markdown

# 随机抽取
随机抽取(`draw.php`)用于从名单中抽人——抽查、抽考、抽签、抽取上台展示等。
从主页面顶部导航 **🎲 随机抽取** 打开(新标签页)。
## 抽取来源
| 来源 | 说明 |
| --- | --- |
| 学号名单(全部) | 从完整名单中抽 |
| 某试卷已提交人员 | 只从交过卷的人里抽(需要先选试卷) |
可再用 **班级 / 组别** 下拉缩小候选池。
## 抽取人数
输入框直接填,或用快捷按钮 `1` / `5` / `10` / `全部`。
## 分组比例
决定有分组时名额如何分配:
| 模式 | 说明 |
| --- | --- |
| 按人数加权(默认) | 人多的组分到更多名额,采用**最大余额法**,保证总数守恒 |
| 各组均分(5:5) | 名额均分到组(不是按人数加权),余数给排在前面的小组 |
| 自定义比例 | 为每个组手动指定比例 |
| 不分组 | 忽略组别,整池随机 |
::: tip 5:5 的含义
「各组均分」是**名额均分到组**,不等于每组抽到的人数与其人数成正比。
如果你想"人多的班多抽几个",请用默认的**按人数加权**。
:::
## 去重与排除
| 功能 | 说明 |
| --- | --- |
| 排除已抽中 | 本次会话内已抽中的人不再被抽到;**重置结果**后清零 |
| 排除管理 | 手动勾选不参与抽取的人(如请假、已抽过);支持清空排除 |
## 结果区
顶部卡片:`候选人数 / 本次抽取 / 累计已抽取 / 已排除 / 抽取来源`。
结果表格:`序号 / 学号 / 姓名 / 班级 / 组别 / 登陆账号 / 操作`。
「登陆账号」列让你在导出前就能核对:显示为 `学号 ⚠` 表示名单里没填这一列,
导出时会自动回退用学号——**这会导致学生登不进考试**,请先回主系统「名单管理」补全。
::: tip 「全部」按钮会跟随候选池
点 **全部** 后抽取人数进入跟随模式:切换班级 / 组别 / 来源时人数自动更新为当前
候选池大小。手工改动人数输入框即解除该模式。
:::
| 按钮 | 说明 |
| --- | --- |
| 📜 历史 | 查看历次抽取批次。**重置结果不会清空历史** |
| 📋 复制名单 | 复制姓名 / 登陆账号,可直接粘贴到微信或 Excel |
| ⬇ 白名单导入模板 | 导出为卷王白名单导入模板 `.xlsx` |
| ⬇ 白名单列表 | 导出为白名单列表 `.xlsx` |
| 重置结果 | 清空本次结果与累计已抽取(历史保留) |
| 清空历史 | 清空全部历史记录 |
## 登陆账号说明
名单中的**登陆账号**列在这里既用于导出白名单,也会直接显示在结果表格中(便于导出前核对)。
若名单里没有这一列,抽取结果里会用 `学号 ⚠` 标出,导出时回退用学号。
::: warning 模板文件名
卷王模板中该列表头为「登陆账号」(不是"登录账号"),导出时已按此命名。
:::
## 相关
- [名单管理](./roster.md)
- [系统设置](./settings.md)