文档部署到 /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;
  看板顶栏窄屏下拉与按钮换行,消除横向滚动
This commit is contained in:
2026-09-11 16:23:08 +08:00
parent f271066266
commit 25a2e8a42c
30 changed files with 700 additions and 883 deletions
+49 -93
View File
@@ -70,39 +70,40 @@ $rosterCount = Roster::count();
</div>
<div class="field btns">
<button class="btn btn-primary" id="btnRefresh">立即刷新</button>
<button class="btn btn-primary" id="btnProjCfg" title="为当前选中的试卷单独设置满分 / 合格率 / 免考名单">试卷设置</button>
</div>
<div class="field grow-2">
<label>搜索</label>
<input type="text" id="kw" placeholder="输入学号或姓名筛选">
</div>
<div class="field btns" style="flex-wrap:wrap;gap:8px">
<label style="display:flex;align-items:center;gap:6px;font-size:12px;color:var(--text-2)">导出排序
<select id="exportSortSel" style="height:30px;border-radius:8px;border:1px solid var(--border);padding:0 6px;background:#fff">
<option value="time">按提交时间</option>
<option value="sid">按学号</option>
<option value="score_desc">按成绩降序</option>
<option value="score_asc">按成绩升序</option>
</select>
</label>
<label style="display:flex;align-items:center;gap:4px;font-size:12px;color:var(--text-2);cursor:pointer" title="每人只导一行:最近一次成绩 + 最高分 + 考试次数">
<input type="checkbox" id="exportLatest" style="width:auto;height:auto">按最新成绩
</label>
<label style="display:flex;align-items:center;gap:4px;font-size:12px;color:var(--text-2);cursor:pointer" title="按班级拆分多个工作表(xlsx 多表)">
<input type="checkbox" id="exportSplit" style="width:auto;height:auto">按班级分表
</label>
<button class="btn" id="btnExport">导出成绩</button>
<button class="btn" id="btnExportAbsent">导出缺考</button>
<button class="btn" id="btnSnapshot" title="保存当前成绩为一份带标签的时间点快照">存快照</button>
<button class="btn" id="btnTrend" title="查看本卷各快照间每名学生的成绩趋势">趋势</button>
<button class="btn" id="btnAnomaly" title="异常检测线索:短时长高分 / 高频重考 / 雷同成绩">异常</button>
<button class="btn btn-primary" id="btnProjCfg" title="为当前选中的试卷单独设置满分 / 合格率 / 免考名单">试卷设置</button>
</div>
</section>
<section class="subbar">
<span class="subbar-label">导出</span>
<label class="subbar-item">排序
<select id="exportSortSel">
<option value="time">按提交时间</option>
<option value="sid">按学号</option>
<option value="score_desc">按成绩降序</option>
<option value="score_asc">按成绩升序</option>
</select>
</label>
<label class="subbar-item" title="每人只导一行:最近一次成绩 + 最高分 + 考试次数">
<input type="checkbox" id="exportLatest">按最新成绩
</label>
<label class="subbar-item" title="按班级拆分多个工作表(xlsx 多表)">
<input type="checkbox" id="exportSplit">按班级分表
</label>
<span class="spacer"></span>
<button class="btn" id="btnExport">导出成绩</button>
<button class="btn" id="btnExportAbsent">导出缺考</button>
</section>
<section class="cards" id="statCards">
<div class="card accent-blue"><span>名单总人数</span><b id="sTotal">-</b></div>
<div class="card ok accent-green"><span>已提交</span><b id="sSubmit">-</b></div>
<div class="card warn accent-orange"><span>缺考</span><b id="sAbsent">-</b></div>
<div class="card accent-purple"><span>提交率</span><b id="sRate">-</b></div>
<div class="card accent-teal"><span>平均分</span><b id="sAvg">-</b></div>
<div class="card accent-green"><span>最高分</span><b id="sMax">-</b></div>
<div class="card accent-red"><span>最低分</span><b id="sMin">-</b></div>
@@ -156,7 +157,7 @@ $rosterCount = Roster::count();
</section>
<section class="panel" id="unmatchedPanel">
<div class="panel-head"><h2>未匹配答卷 <small>姓名不在名单中</small></h2></div>
<div class="panel-head"><h2>未匹配答卷 <small id="unmatchedHint">姓名不在名单中</small></h2></div>
<div class="table-scroll short">
<table class="grid compact">
<thead><tr><th>姓名</th><th>成绩</th><th>提交时间</th><th style="width:90px">操作</th></tr></thead>
@@ -244,9 +245,14 @@ $rosterCount = Roster::count();
</div>
</div>
<div class="fi full">
<label>系统地址(不可在此修改)</label>
<input type="text" id="cfgBase" readonly>
<p class="hint">如需修改请编辑 <code>data/config.json</code>(保存后清 token 自动重连)</p>
<label>系统地址</label>
<input type="text" id="cfgBase" placeholder="https://exam.nxxy335.top" spellcheck="false">
<p class="hint">卷王后台地址,结尾不要带 <code>/</code>;修改后保存会自动重连</p>
</div>
<div class="fi">
<label>接口前缀</label>
<input type="text" id="cfgPrefix" placeholder="/api" spellcheck="false">
<p class="hint">社区版 <code>/api</code>;企业版可能是 <code>/admin-api</code></p>
</div>
<div class="fi">
<label>登录账号</label>
@@ -261,7 +267,7 @@ $rosterCount = Roster::count();
<div id="pingResult" class="ping-result hidden"></div>
</div>
<div class="modal-foot">
<span class="hint" style="align-self:center">只有修改账号/密码才会触发重连与测连接</span>
<span class="hint" style="align-self:center">修改地址 / 前缀 / 账号 / 密码后保存会自动重新连接</span>
<span class="spacer"></span>
<button class="btn" id="btnTestConn">测试连接</button>
<button class="btn" data-close>取消</button>
@@ -380,60 +386,15 @@ $rosterCount = Roster::count();
</div>
</div>
<!-- 成绩快照 / 趋势 -->
<div class="modal" id="snapshotModal">
<div class="modal-box wide">
<div class="modal-head"><h3 id="snapTitle">成绩快照</h3><button class="x" data-close>&times;</button></div>
<div class="modal-body">
<div class="fi" style="margin-bottom:10px">
<label>快照标签(可选)</label>
<input type="text" id="snapLabel" placeholder="如:第一次考试、补考后…">
</div>
<div class="snap-toolbar" style="display:flex;gap:8px;margin-bottom:12px">
<button class="btn sm btn-primary" id="btnSnapSave">保存当前快照</button>
<span class="spacer"></span>
<button class="btn sm" id="btnSnapRefresh">刷新列表</button>
<button class="btn sm" id="btnSnapTrend">查看趋势</button>
</div>
<div class="table-scroll mid">
<table class="grid compact" id="snapTable">
<thead><tr><th>标签</th><th>保存时间</th><th>人数</th><th>项目</th><th style="width:70px">操作</th></tr></thead>
<tbody id="snapBody"><tr><td colspan="5" class="empty">暂无快照</td></tr></tbody>
</table>
</div>
</div>
<div class="modal-foot">
<span class="spacer"></span>
<button class="btn" data-close>关闭</button>
</div>
</div>
</div>
<!-- 跨快照趋势 -->
<div class="modal" id="trendModal">
<div class="modal-box wide">
<div class="modal-head"><h3>成绩趋势 <small id="trendSub"></small></h3><button class="x" data-close>&times;</button></div>
<div class="modal-body">
<div class="table-scroll" style="max-height:60vh">
<table class="grid compact" id="trendTable">
<thead id="trendHead"></thead>
<tbody id="trendBody"><tr><td colspan="10" class="empty">加载中…</td></tr></tbody>
</table>
</div>
<p class="hint" id="trendHint">趋势值为每名学生的「最高分」,未出现该快照的记「—」</p>
</div>
<div class="modal-foot">
<span class="spacer"></span>
<button class="btn" data-close>关闭</button>
</div>
</div>
</div>
<!-- 成绩明细打印设置 -->
<div class="modal" id="printTableModal">
<div class="modal-box">
<div class="modal-head"><h3>打印成绩明细</h3><button class="x" data-close>&times;</button></div>
<div class="modal-body">
<div class="fi">
<label>打印标题</label>
<input type="text" id="ptTitle" placeholder="默认:试卷名 + 成绩明细">
</div>
<div class="fi">
<label>排序方式</label>
<select id="ptSort">
@@ -450,12 +411,22 @@ $rosterCount = Roster::count();
<option value="cls">按班级分组</option>
<option value="grp">按组别分组</option>
</select>
<p class="hint">分组后每个班/组单独一段,段首显示小计(人数/平均分/合格率)</p>
<p class="hint">分组后每个班/组单独一段,段首显示小计(人数/平均/最高/最低/合格率)</p>
</div>
<div class="fi">
<label>纸张方向</label>
<select id="ptOrient">
<option value="portrait" selected>纵向(A4,列少时清晰)</option>
<option value="landscape">横向(A4,列多时不易折行)</option>
</select>
</div>
<div class="fi checks">
<label><input type="checkbox" id="ptRank" checked> 显示名次</label>
<label><input type="checkbox" id="ptRank" checked> 显示名次(全表连续编号)</label>
<label><input type="checkbox" id="ptPass" checked> 显示「是否合格」列</label>
<label><input type="checkbox" id="ptAttempts" checked> 显示考试次数</label>
<label><input type="checkbox" id="ptAbsent" title="成绩表后另起一页附缺考名单,含备注列供手写"> 附缺考名单(另起一页)</label>
</div>
<p class="hint">打印内容<b>不受页面当前筛选外的影响</b>,始终按当前班级/组别筛选结果输出;表头会在每页自动重复,末尾附签字栏。</p>
<p class="hint" id="ptHint"></p>
</div>
<div class="modal-foot">
@@ -497,21 +468,6 @@ $rosterCount = Roster::count();
</div>
</div>
<!-- 异常检测线索 -->
<div class="modal" id="anomalyModal">
<div class="modal-box wide">
<div class="modal-head"><h3>异常检测线索</h3><button class="x" data-close>&times;</button></div>
<div class="modal-body">
<p class="hint" style="margin:0 0 12px">以下为自动统计的「防作弊线索」,仅供人工复核判断,不代表结论。</p>
<div id="anomalyBody"></div>
</div>
<div class="modal-foot">
<span class="spacer"></span>
<button class="btn" data-close>关闭</button>
</div>
</div>
</div>
<script>
window.NY = {
appName: <?= json_encode(NY_APP_NAME, JSON_UNESCAPED_UNICODE) ?>,