|
|
0a380371ec
|
feat(upload): 组内作品唯一 + 小组编号目录 + 按小组打包下载（R190）
需求（管理人员反馈）：
① 本科组/教师组同样遵循「小组内只要有一人上传作品，其他人就不能再上传」；
② 作品按「小组编号」建目录存放并保留原始文件名，管理端下载时按小组打包。
后端落地：
- 组锁：新增 getTeamUploadState/assertTeamUploadAllowed，按 (group, teamUid) 取全组
提交记录，**最早提交者为归属人**；其他人上传与分片合并两条路径都返 6006
（data 带 teamLocked/teamOwnerName/teamNumber/folderName）。删除本人作品后自动解锁。
⛔ 必须先按 group 过滤再认 teamUid（team_uid 仅组内唯一）。
- 落盘：works/<group>/<小组编号>/<原始文件名>。目录名走新增 lib/team_folder.js
（唯一 SoT：净化 Windows 非法字符/控制字符/首尾点/设备保留名，限长 60）。
撞名三态：不存在→原名；同一聚合+同一 file_type→原名原子覆盖；否则 (2)(3)。
DB file_path 仍为相对路径 ⇒ 存量平铺文件免迁移。
- 直传与分片合并收敛到同一套 prepareWorkTarget + commitWorkFile：先写同目录临时名
(.upload_*/.merge_*)，再 renameSync；失败一律 safeCleanup 后抛。
- status 接口新增 teamLocked/canUpload/teamOwnerName/isTeamOwner/teamFiles/memberCount。
- 管理端：works 列表返回 teamUid/teamNumber/teamFolder（走 resolveTeamLabels 既有口径）；
新增 GET /api/admin/team-zip/:group?teamUid= 单组打包（仅本科/教师，其余 400，包内平铺）；
batch-download 包内改为 <小组编号>/<原始文件名>。两者共用 _buildZip。
验证：真接口 45/45 + 变异 M1（locked=false ⇒ 15 条断言红，还原后复绿）；
已收编为门禁第 58 步。
|
2026-10-21 15:20:42 +08:00 |
|
|
|
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 |
|
|
|
31da9580e5
|
fix(backend): 治理孤儿文件三根因（覆盖前删旧件 / 入库失败回滚 / 清库同步删件）（BACKLOG C9）
R45：C8 只清了存量（1003 个 / 9.62 GB），「孤儿为何持续产生」的三条根因仍在，本次一并治理。
顺序铁律「先库后盘」：文件删除不可回滚，若先删盘而 DB 写/事务失败 ⇒ DB 指向已删文件
⇒ 下载 404 = 数据丢失（比留一个孤儿严重）。故全部删除点一律「DB 侧确定成功 → 才删物理文件」。
- app/service/upload.js
· saveSubmissionRecord：覆盖前记住旧物理文件路径，existing.update() 成功之后才删旧件
（原先 upsert 只改 DB 指向 ⇒ 重传 N 次 = 1 条 DB + N-1 个孤儿）
· deleteSubmission：裸 fs.unlinkSync → 复用统一入口
· 新增 removePublicFile(relativePath, label)：唯一删除入口。仅允许 works/ 或 tmp/ 前缀
（挡住脏 file_path 指向 templates/、carousel/ 等静态资源被连带删除）+ 拒含 `..`
+ best-effort 永不抛错，返回 removed|missing|skipped（复用 helper.safeCleanup）
- app/controller/upload.js
· upload() / mergeChunks()：新增 savedFileInfo|mergedRelPath + recordPersisted 两个标志，
catch 里仅当「已落盘 && 未入库」才回滚删除 ⇒ 已入库还删会删掉正被 DB 引用的文件
- app/controller/admin.js
· resetTestData：事务内先只读收集六列路径（exam/work/zhongzhi/gaozhi/benke/jiaoshi），
tx.commit() 之后才删物理文件 + 去重 + 上报 orphanFileCandidates/orphanFilesRemoved
验证：verify-c9.mjs 24/24 · verify-c9-reset.mjs 12/12 · verify-c9-rollback.mjs 13/13
check_upload_import_gate.py 14 PASS/0 FAIL · 后端重启（node dev.js）后真实接口联调通过
配套：scripts/scan_orphan_files.py（兜底双向扫描，仓库级工具）
|
2026-09-29 15:06:53 +08:00 |
|
|
|
e8a5b34d42
|
fix(backend): 补齐单次上传端点的并发护栏（BACKLOG C7）
- middleware/concurrency_guard.js: HEAVY_PATTERNS 增加单段上传正则
/^\/api\/upload\/[^/]+$/i —— 单段锚定（[^/]+$）保证不误伤"两段"的轻路由：
GET /status、GET /submissions、DELETE /:id（放宽成前缀匹配会让「查状态也 429」）
- controller/upload.js: upload() 补 await acquireFileIo() +
finally { if (ioAcquired) releaseFileIo(); }
⚠️ 不用 uploadChunk 的无条件 release：本方法 429 分支是 acquire 失败后 return，
无条件释放会把"别人的"配额放掉 => 计数下溢 => 护栏静默失效
背景：修复前该端点是**唯一在用**的作品上传路径（Competition.vue:477），却既不在
concurrencyGuard.HEAVY_PATTERNS（表内 chunk/merge 已成死路由）、也不调 file_io_guard
=> 零护栏。因服务器入带宽仅 ≈1.25MB/s 天然节流，当前风险有限，但按 C3 升入带宽
后即变实质风险 => 与 C3 绑定，先补护栏。
验证：
- verify-guard-r43.mjs 33/33（单元：路径判别力 + 满载 429 + 配额隔离 + 释放语义 + 变异自证）
- verify-guard-r43-live.mjs 8/9（真接口：30 路 5MB 并发上传 => 20 成功 / 10 个 429 +
Retry-After: 2；15 个轻路由探针在并发中全 200；唯一失败为清理步骤，根因是
saveSubmissionRecord 的 upsert 语义，非缺陷）
- 重启后 master PID 23684；[AppBoot][pool] 40 <= 151
|
2026-09-29 13:17:53 +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 |
|
