hyzl-agent-backEnd/competition-website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
30 Commits 1 Branch 0 Tags
cf91f6ba346686f3165fd00f9b824defd3817a54
Commit Graph

9 Commits

Author SHA1 Message Date
qubiaobiao
c101b15e2e feat(admin): 新增小组激活状态清单接口 /api/admin/teams 
- router：GET /api/admin/teams（adminAuth；固定路径段，与既有路由无通配冲突）

- controller：teams() 整体透传 group/activated/includeTest（防前端筛选静默失效）

- service：getTeams()，键 = 组别+队伍号；成员并集 aggregation.team_uid ∪ contestants.team_id；学校取 aggregation.organization_cn；激活 = 全组成员均已激活；附 summary 与 schoolConflict

- model/aggregation：补声明运行库既有列 organization_cn / group（此前模型漏声明 ⇒ 查询被当未知列）

线上验证：R86 已部署上线，公网 /api/admin/teams 返回 401（鉴权在位）
 2026-10-09 09:33:05 +08:00
qubiaobiao
154338e5dd feat(big-question): 综合大题 Excel 模板下载 + 批量导入（R73） 
新增 GET /api/admin/big-questions/:group/template —— 生成自解释模板：
数据 sheet 排第 1（导入侧按 SheetNames[0] 解析，是承重契约）+「填写说明」sheet，
含列名含义/状态建议/常见被拒原因，让测试人员下载即会用，不依赖外部文档。

新增 POST /api/admin/big-questions/:group/import-excel —— 逐行调用
service.bigQuestion.createQuestion，标题长度/三小问/分值/泄题检测(detectAnswerLeak)
全部自动继承，与手工录入同一入口同一校验；批量导入绝不成为绕过防呆的后门。
组别以 URL :group 为准，忽略表格里的组别列；同组内标题重复即跳过并报错；
状态缺省 0（停用），批量录入的题未经人工校对不直接进抽题池。

客观题模板 buildQuestionTemplate 同步加「填写说明」sheet：数据 sheet 仍排第 1、
原 8 列不变，故 importQuestionsFromExcel 的 SheetNames[0] 解析不受影响（已离线验证）。
路由顺序硬约束：含具体段的 template / import-excel 必须排在通配段 /:id 之前。
 2026-10-08 10:08:41 +08:00
qubiaobiao
e74778ee08 feat(admin): 成绩导出改为 Excel + 板块迁移配套接口（R29） 
- service/admin.js: 抽出 buildScoreExportTable(group) 作单一数据源（CSV/XLSX 共用，消除表头漂移）
  + 新增 exportToXlsx()（SheetJS aoa_to_sheet + write buffer + !cols 列宽）
- controller/admin.js: 新增 exportExcel()（xlsx MIME + ctx.attachment 中文文件名编码）
- router.js: 新增 GET /api/admin/export-excel/:group（adminAuth）
- export-csv 路由刻意保留：verify_full_e2e.py B10/D10、verify_upload_download.py B2 依赖其非空断言
 2026-09-28 16:42:36 +08:00
qubiaobiao
2ab0991310 fix(admin): 复核页选择题选项渲染修复 + 阅卷导出 Word + 评分两位小数（R28） 
针对测试人员反馈的四项：
1) 复核明细「选择题大量空白」：options 为 text 列存 JSON 字符串，原先被原样透传，
   前端 v-for 对字符串逐字符迭代（op.key/op.text 皆 undefined）⇒ 每字符渲染一行。
   新增 parseOptions()（仅 string 才 JSON.parse，失败降级 null）。
2) 选项与答案不随机：仅题目用 RAND() 抽题，normalizeQuestion 无 shuffle，字母无歧义。
3) 评分精度：DECIMAL(6,1) -> DECIMAL(6,2)，migration 026 覆盖 17 列（与 025 同范围），
   lib/decimal_score.js 与 11 个 model 注释同步；汇总收敛 round2（×100/100）。
4) 阅卷导出：GET /api/admin/big-answers/:group/export?ids=
   单选考生 -> 直接 .docx；多位/全部 -> 每位考生单独 .docx 打包 .zip。
   路由为 3 段，注册在 :group 通配段之前。

验证：verify_big_question 51 PASS/1 FAIL（唯一 FAIL=测试人员新数据，非本次改动）、
verify_score_leak_all_channels 24/24、verify_question_no_answer_leak 4/3/0/1。
 2026-09-28 15:50:46 +08:00
qubiaobiao
cbc05ed4e7 feat(admin): 成绩复核——按姓名/身份证/电话检索考生并查看全卷客观题逐题作答与正确答案（R26） 
- service.admin: 新增 reviewSearch / getContestantScore / _reviewWorks；移除同名的死代码旧实现
- 归集双键合并 [contestant.id] ∪ [真实 aggregation_uid]，与 getExamSubmissions 口径逐字一致
- 题序还原：优先 exam_submissions.question_order，缺失则回退「选择→判断 + 题号升序」并回传 questionOrderFixed=false
- 未作答行 answerMatches 返回 null（非 false），避免界面把「未答」读成「答错」
- 组别以库中考生 group 为准，路由 :group 不符返回 409，防前端传错组照错人
- 异常可区分：questionMissing（题被删/改组）、answerMatches≠isCorrect（判分矛盾）
- 因回传正确答案，两条路由均挂 adminAuth —— 选手端可达即成绩泄露（与 verify_score_leak_all_channels.py 三通道门禁一致）
- 不改动 schema、不改动既有接口行为

controller.admin: 新增 reviewSearch / contestantScore（NOT_FOUND→404 / GROUP_MISMATCH→409 / 其它→400）
router.js: 注册 GET /api/admin/review/search 与 /api/admin/review/score/:group/:id，均 adminAuth
 2026-09-28 10:15:42 +08:00
qubiaobiao
079c1b31c9 R20：客观题分值口径 + 大题一位小数评分 + 页面刷新修复 + 大题导出 Word 
A1/A2 客观题：
- 清理题库占位题（答案恒 A/true、分值恒 5），客观题分值硬约束为 1 分
- 新增 scripts/check_question_bank_health.py（带变异注入自检，已验证判别力）
- ci-gates.sh 由 9 步扩为 10 步，纳入题库健康门禁

B 大题评分一位小数：
- 新增 app/lib/decimal_score.js：DECIMAL(6,1) + getter 兜底，单点收口
  「DB 列 / model 声明 / dialectOptions.decimalNumbers」三处必须同时成立
- 10 个 model 的 score 字段改走该工厂
- database/migrations/025：17 列 INT → DECIMAL(6,1)（6 列题目分值保持 int）
- service/bigQuestion.js：setSubScores 用 Math.round(n*10)/10 收敛，不再抹成整数

C 页面状态刷新：
- 修复 onQuestionTypeChange 的 `bigQuestions.length === 0` 守卫（切组后旧数组仍非空
  ⇒ 永不重新拉取）
- 修复评分后只刷一半（saveBigScores / saveExamScore 各只刷一侧列表）
- 收敛为唯一刷新入口 refreshQuestionData()；ensureBigData 改按「数据属于哪个组」
  判定；fetchBigQuestions/fetchBigAnswers 增加组别竞态守卫

D 大题导出 Word（单题 / 批量 / 全部）：
- 新增 app/lib/docx.js：零新依赖手写 OOXML（复用已有 archiver@8），支持 p/strong/
  span/a/br/table/ul-ol 子集，具名捕获组词法解析，pPr 严格排在 runs 之前
- service.bigQuestion.exportQuestions + controller.exportBigQuestions +
  GET /api/admin/big-questions/:group/export
- 前端导出选中/全部两按钮 + 表格多选（reserve-selection）

计划外发现并修复（已在报告中披露）：
- 管理端跨组写分越权：setSubScores 定位作答行时缺 group 约束，可用任意组的路径
  改写他组考生成绩（读写不对称：读取侧有 where:{group}，写入侧没有）
  ⇒ 已补 group 约束，并区分「不属于本组」与「尚未抽题」两种文案
- 导出路由注册顺序：export 原注册在 :group/:id 之后（当时因后者仅 PUT/DELETE 而
  未暴露问题），已前移以消除「将来新增 GET /:group/:id 会吞掉 export」的隐患

验证（全部实测，非仅看退出码）：
- ci-gates.sh 10/10 全绿；四连门禁 52/0 · 22/0 · 20/0 · 46/0
- 端到端探针 probe_d_03（导出+小数）ALL PASS；probe_e_01（切组刷新）22/22 ALL PASS
- 前端构建 VITE_EXIT=0

未 push：须先上线验证通过再单独授权。
 2026-09-23 18:29:50 +08:00
qubiaobiao
23604f2718 feat(exam/auth): 登录闸门 + 交卷稳定性加固（R4-R8） 
R4 登录/交卷背压闸门
- app/middleware/concurrency_guard.js: 新增。超限即 429 + Retry-After（立即拒绝式，
  不排队；实测 429 P50=34ms）。RETRY_AFTER 收敛为单一有依据常量 = '2'
  （≈1.8 个满载窗口；实测 bcryptjs 1129ms / 原生 265ms 每窗口）。
  配额：LOGIN_MAX=16 / SUBMIT_MAX=24 / HEAVY_REQ_MAX=20，各 *REQ_MAX 覆盖。
- config/config.default.js: 闸门配额与连接池容量配置；DB dialect 锁 mysql。

R7 顺序红线 + R8 Retry-After 同源 + 原生 bcrypt
- 3 处硬编码 '2' 收敛为单一常量；补"勿因换实现而删闸门"红线注释。
- bcryptjs -> bcrypt@6（N-API，Windows/Linux 均免编译；drop-in，存量哈希 $2b$10$ 兼容）。
- app/model/account.js / app/service/auth.js: 同步哈希实现注释（D4 全族 5 处陈旧
  SHA256 注释修正）。

答题链路与综合大题
- app/controller/exam.js: 中职/高职综合大题接口（GET big-question / POST big-answer，
  逐问 2000 字上限校验）；uploadWord 对中职/高职封堵（400）。
- app/service/exam.js: 抽题快照 question_snapshot 落库、答案归集键修正。
- app/controller/auth.js / app/service/auth.js: toClientUser() 唯一出口，
  未发布态按组剔除 score，exam_score/word_score/ppt_score 任何情况下不下发。
- app/router.js: 新增大题与管理端路由。
- app/extend/helper.js: 下载文件名 RFC5987 编码（禁双重编码）。
- app.js: 池容量断言按 env 区分单/多 worker（防 dev 假日志）。

验证：ci-gates.sh 9/9 全绿；verify_login_guard.py 28/28（含 D 组变异 9/9）；
真实登录/抽题/交卷端到端 code=0；前端构建 BUILD_RC=0。
 2026-09-22 09:16:55 +08:00
qubiaobiao
8ef18da395 feat(big-question): 中职/高职组「综合大题」在线作答 + 封堵 auth 成绩泄露三通道 
## 一、需求变更：中职/高职组 Word 文件上传题 → 在线「综合大题」

按 2026-09-21 需求变更，中职组 / 高职组取消 Word 文件上传题，改为在线作答
综合大题（1 道大题 × 3 个小问 × 每小问 10 分 = 大题 30 分）。

- 新增表（迁移 023/024）
  · `big_questions`        —— 题库（题干富文本含表格 + 三小问提示语 + 评分口径）
  · `big_question_answers` —— 作答（抽题快照 + 三小问答案 + 按小问得分）
  两份迁移同时提供 `.sql`（生产直跑）与 `.js`（本地/CI 幂等执行）。
- 新增 model：`app/model/bigQuestion.js`、`app/model/bigQuestionAnswer.js`
- 新增 service：`app/service/bigQuestion.js`（抽题 / 保存答案 / 评分核心逻辑）
- 考生端接口（`app/controller/exam.js`）
  · `GET  /api/exam/:group/big-question` —— 首次抽题并落库题干快照，
    后续一律返回同一道题（**幂等**，防止同一考生拿到不同题干引发纠纷）
  · `POST /api/exam/:group/big-answer`   —— 保存三小问答案，带考试窗口门控
- 管理端接口（`app/controller/admin.js`）
  · 题库 CRUD：`/api/admin/big-questions/:group[/:id]`
  · 作答查证：`GET /api/admin/big-answers/:group`（考生 → 抽到的题 → 三小问 → 提交时间）
  · 按小问评分：`PUT /api/admin/big-answers/:group/:uid/scores`
- 服务端封堵越界数据：`app/controller/exam.js` 对中职/高职组的 Word 上传接口
  一并拒绝（前端入口已移除，但直调 API 仍可绕过）。

**所有新增读写仅落在新增的两张表，不触碰任何既有表结构。**

## 二、安全修复（铁律 15 成绩泄露 —— auth 通道缺口）

原有成绩发布门控只覆盖 4 条通道，遗漏了 auth 的**三条同源通道**：三处都直接
回传 `toJSON()`，在 `score_published_<group> = false`（未发布）时照样下发成绩，
而同期 `GET /api/score` 正确返回 `null`。

- `POST /api/auth/login`         —— 实测未发布态回传 `score`
- `GET  /api/auth/current-user`  —— 全字段 `toJSON`，连带下发分项
- `POST /api/auth/refresh`       —— 全字段 `toJSON`，且前端 `doSilentRefresh()`
  会把响应 `user` 写入 `localStorage` 与 Pinia，等效于登录通道；
  实测泄漏 `score` + `exam_score` + `word_score` + `ppt_score` 共 4 个字段

修复方式：新增 `AuthService.toClientUser()` 作为**唯一出口**，三处全部收敛，
禁止各自直接 `toJSON`。口径：
- 该组已发布 → 保留 `score`；未发布 / 查询异常 → 剔除 `score`（异常按未发布，安全默认）
- `exam_score` / `word_score` / `ppt_score` **任何情况下都不下发**
  （前端不使用；保留会形成"总分虽隐藏、分项可加总"的旁路）

门禁 `scripts/verify_score_leak_all_channels.py` 相应从 14 项扩到 20 项，
新增通道⑤/⑥/⑦断言（含"发布后 score 必须恢复"的**正向对照**，防止
"永不回传"式过度封堵造成假绿），并经变异注入自检证明断言可证伪。

## 三、移除已弃用的 Word 模板

中职 / 高职各 3 个历史 Word 模板（`app/public/templates/{zhongzhi,gaozhi}/*.docx`）
随需求一并移除；目录保留 `.gitkeep` 以维持路径存在。

---
验证：G10 铁律15 门禁 20/20 PASS（含变异自检，EXIT=0）、G9 铁律14 门禁 22/22 PASS、
窗口哨兵残留自检 6/6 PASS。前端配套改动见前端仓库提交 1bfe007。
 2026-09-21 11:57:58 +08:00
WorkBuddy
a303cf2d53 chore: 后端首次基线提交 
运行必须源码：app/(controller/model/service/middleware/lib/utils/validate/router)、config/、database/(migrations/seeders/sql)、启动脚本、app/public/templates 模板。
已忽略运行非必须：node_modules/、logs/、run/、app/public 运行时上传数据、.env*、构建/缓存产物。
 2026-08-17 12:25:42 +08:00