|
|
5392345078
|
feat(score): R173/R174 大题成绩 Excel 导入（三小问四列制）+ 三节点备份调度器与四项修复
成绩导入（R173 落地 → R174 改为三小问四列制）
- app/lib/bigScoreImport.js（新增 · 判据唯一真相源 · 零依赖：不 require Egg / 不连库 / 不读文件）
· R174 删除 splitScoreAcrossSubs（均分），改为 scoreSubs 逐项取值
· 留空 SUB_MISSING（整行拒绝，⛔ 不按 0 分）· 非数值 SUB_INVALID · 超单问上限 SUB_OUT_OF_RANGE
· 文件级 LEGACY_TEMPLATE（旧两列模板）与 SUB_COLUMNS_MISSING（缺一小问整列）⇒ 整份拒绝
· 定位键必须带 group：(group, team_uid)，因 team_uid 跨组重号
- app/service/bigQuestion.js
· buildScoreTemplate 改四列 + 说明书重写（删均分段，补"三列必须全填"与"旧模板不再支持"）
· previewScoreImport 回带 subRaws/subs/total；importScores 逐项写 setSubScores
· ⛔ 不新增第二条写成绩通路：仍只走 setSubScores → admin.updateScores
- app/lib/docx.js：run 支持 color（6 位 hex）；w:color 必须排在 w:sz 之前（CT_RPr sequence）
- app/controller/admin.js + app/router.js：import-template / import-preview（零写入）/ import-scores
· 上传内存解析不落盘（app/public 对静态服务开放 ⇒ 成绩表可被猜名下载）
节点备份调度器（R168/R170）
- app/lib/nodeBackupScheduler.js（新增）：考试开始前 30min / 结束后 10min / 成绩发布瞬间
· 幂等键 group:node:fireAtISO（时间点即身份）；overdue 判定用 clamp:false 的数学时刻
· 非生产 enabled 强制 false 且 fail-safe（与 DEPLOY_ENV_LOCAL_SKIP_PREFIXES 同源）
- config/config.default.js：config.nodeBackup 四项路径全走环境变量，默认值只覆盖本地
（生产目录布局与仓库不一致，⛔ 不许用 __dirname 推导）
- app.js：启动构造单例 + hydrate 未到期计划
缺陷修复
- app/controller/admin.js：R161 临时文件路径移到 try 外声明，否则导入抛错即跳过清理
- app/service/admin.js：R166「已答 N / N 题」恒真显示（原 totalQuestions = answeredCount）
- app/service/upload.js + app/controller/upload.js：R157/R162 删除结果计数 + @no-temp-cleanup 标注
测试
- .gitignore + test/lib.test.js：R134 候选 ㊴ —— test/* + !test/*.test.js，
使第 26 步裸 mocha 在干净检出上可复现（改前 rc=1 ↔ 改后 23 passing）
|
2026-10-19 13:03:48 +08:00 |
|
|
|
070195a22c
|
docs(backend): 同步 worker 数注释（生产 4 -> 2，与 2 核匹配）
仅注释变更，**无行为变更**。EGG_WORKERS 实际由 deploy/.env.production 注入 +
deploy/start-backend.sh 兜底决定，本次把注释里写死的旧口径同步为 2，避免
「注释与配置漂移」再次误导后人。
- app.js:
· 「生产显式设为 4」-> 2
· 「4×20=80（安全）」->「2×20=40（安全）」
· 「本地 dev 也会加载 .env.production，其中写着 4」-> 2
· 「dev 下真 worker=1 却报 4×20=80」-> 2×20=40
- config/config.default.js:
· 「生产值写在 deploy/.env.production（EGG_WORKERS=4）」-> 2（并注明 2026-09-29
R40 由 4 校正为 2）
· 「4 × 20 = 80」->「2 × 20 = 40」
· pool 段「worker 数由 EGG_WORKERS 显式控制（生产 = 4）」-> 2
· 「本机/多数服务器为 8 核 → 8 个 worker」->「核数越多起得越多（开发机 8 核 → 8 个）」
（原文把"8 核"当成多数服务器的事实，与实测的 2 核服务器不符）
背景（R40 · BACKLOG C2）：worker 数 ≈ CPU 核数。worker 数 > 核数对 CPU 型路径
（bcrypt 登录）**零收益** —— 加 worker 不加核（native bcrypt 走 libuv threadpool），
只增加 context switch 与内存（单 worker 空闲 RSS ≈108MB）。登录容量由物理核数
决定（实测 ≈12.6 次/核·秒）⇒ 2 与 4 的登录容量相同。连接池 2×20=40 ≤ 151-20 ✅
验证：node --check app.js / config/config.default.js 通过；
verify-c1c2.py 含「五处文档/代码注释已无旧口径「4」残留」断言（24/24 通过）。
|
2026-09-29 12:34:38 +08:00 |
|
|
|
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 |
|
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 |
|
