feat(admin): R176-R180 公示表与新闻撤回 + 管理端多管理员权限（C 层）+ 交卷冻结
- R176 成绩公示表引擎（lib/publicitySheet.js + lib/assets/publicity-template.xlsx 官方模板基底） 与指导教师回填（lib/teacherBackfill.js）；赛项名称/编号改为配置项 - R177 新闻「发布 ↔ 撤回」互斥：撤回只置 is_draft=1，不删除数据 - R178 C 层 RBAC：lib/adminPermissions.js（13 权限点 / 70 条路由规则，唯一 SoT） + middleware/auth.js 三段判定（默认拒绝 · is_super 单点 · token_version） + controller/service/adminUser.js + lib/auditLog.js + model/adminAuditLog.js - R178 B1 交卷冻结：service.exam.assertNotSubmitted（bizCode 4006 单一判据源） - R178 B④ 提交口径拆分：formalSubmitted / submitted / answeredCount 三字段 - R178 成绩总览补小组编号：resolveTeamLabels（与选手管理同源，含兜底与三态） - R181 生产迁移配套：admins +7 列、admin_audit_logs（scripts/migrate_r178_admin_rbac.py）
This commit is contained in:
284
app/lib/adminPermissions.js
Normal file
284
app/lib/adminPermissions.js
Normal file
@@ -0,0 +1,284 @@
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* 管理端权限点与「路由 → 权限」映射（R178·C 层唯一真相源）
|
||||
* ============================================================================
|
||||
*
|
||||
* 为什么需要这层：后端有 63 条 /api/admin/* 路由，原本全部只挂 adminAuth（role='admin'）。
|
||||
* 在本模块之前，「是管理员」等于「有全部权限」—— 无法做到「只给阅卷、不给发布」。
|
||||
*
|
||||
* 三条设计纪律（改动前必读）：
|
||||
*
|
||||
* 1. **默认拒绝**：`resolvePermission()` 匹配不到任何规则时返回 null，
|
||||
* 中间件对 null **直接 403**，而不是放行。
|
||||
* ⇒ 新增路由若忘了登记规则，表现是「功能不可用」而非「静默成为人人可用的后门」。
|
||||
*
|
||||
* 2. **单一真相源**：路由的权限归属只在本文件声明，⛔ 不得在 router.js 逐条写权限参数
|
||||
* （那会让 63 条路由各带一份权限字符串，与本表必然漂移，且无人能核对全集）。
|
||||
* 全集对齐由门禁 `scripts/verify_admin_rbac.py` 双向断言：
|
||||
* 「router.js 的 /api/admin 路由全集」== 「ROUTE_RULES 覆盖集」，两个方向差集都必须为空。
|
||||
*
|
||||
* 3. **多权限其一（anyOf）**：部分接口被两个菜单共用（如成绩复核页复用成绩列表），
|
||||
* 用 `perms: ['scores','review']` 表达「具备任一即可」。这不会降低安全性 ——
|
||||
* 任何一条都需被显式授予，只是避免「勾了复核却被 403」的误伤。
|
||||
*
|
||||
* 高危权限点单独成项（score.publish / data.reset / admins.manage），
|
||||
* 目的是把「能看成绩」与「能发布成绩」分开 —— 这两件事的责任人通常不同。
|
||||
*/
|
||||
|
||||
const MODULE = 'module';
|
||||
const HIGH_RISK = 'highRisk';
|
||||
|
||||
/**
|
||||
* 全部权限点。顺序即前端展示顺序。
|
||||
* ⚠️ 新增权限点必须同步：① 本数组；② ROUTE_RULES 至少一条规则；③ 前端 `can()` 使用处。
|
||||
*/
|
||||
const PERMISSIONS = [
|
||||
{ key: 'dashboard', label: '数据总览', group: MODULE, desc: '查看各组账号数 / 提交数 / 激活率' },
|
||||
{ key: 'accounts', label: '选手管理', group: MODULE, desc: '查看选手、导入报名表、编辑选手信息、标记测试数据' },
|
||||
{ key: 'questions', label: '试卷管理', group: MODULE, desc: '客观题与综合大题题库维护、Word 模板' },
|
||||
{ key: 'materials', label: '备赛资料', group: MODULE, desc: '上传 / 删除备赛资料' },
|
||||
{ key: 'submissions', label: '作品管理', group: MODULE, desc: '查看作品与答题记录、下载作品文件' },
|
||||
{ key: 'times', label: '时间设置', group: MODULE, desc: '考试起止时间、抽题数量、节点备份状态' },
|
||||
{ key: 'scores', label: '成绩管理', group: MODULE, desc: '阅卷打分、导出成绩、生成公示表（不含发布）' },
|
||||
{ key: 'review', label: '成绩复核', group: MODULE, desc: '按选手查验分项得分' },
|
||||
{ key: 'news', label: '新闻管理', group: MODULE, desc: '新闻增删改、置顶、附件上传、发布 / 撤回' },
|
||||
{ key: 'carousel', label: '轮播管理', group: MODULE, desc: '首页轮播图增删改与排序' },
|
||||
{ key: 'score.publish', label: '发布 / 撤回成绩', group: HIGH_RISK, desc: '控制考生端能否看到成绩，并自动生成公示草稿' },
|
||||
{ key: 'data.reset', label: '重置测试数据 / 删除选手', group: HIGH_RISK, desc: '会真实删除数据的操作，仅授予负责人' },
|
||||
{ key: 'admins.manage', label: '管理员账号管理', group: HIGH_RISK, desc: '新增 / 删除管理员、分配权限、重置口令、禁用' },
|
||||
];
|
||||
|
||||
const PERMISSION_KEYS = PERMISSIONS.map(p => p.key);
|
||||
const PERMISSION_KEY_SET = new Set(PERMISSION_KEYS);
|
||||
|
||||
/**
|
||||
* 路径模式 → 正则。`:xxx` 段匹配任意单段（不含 `/`）。
|
||||
* 其余字符按字面转义，避免 `/api/admin/big-questions/:group/:id` 里的 `-` `.` 被当元字符。
|
||||
*/
|
||||
function toRegExp(pattern) {
|
||||
const src = pattern
|
||||
.split('/')
|
||||
.map((seg) => {
|
||||
if (seg.startsWith(':')) return '[^/]+';
|
||||
return seg.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
||||
})
|
||||
.join('/');
|
||||
return new RegExp('^' + src + '$');
|
||||
}
|
||||
|
||||
/**
|
||||
* 路由规则表。**顺序敏感**：更具体的路径必须排在带 `:id` 的通配路径之前
|
||||
* （如 `/news/order` 必须在 `/news/:id` 之前），否则会被后者抢先匹配。
|
||||
*
|
||||
* ⚠️ 每条规则的 perms 至少一个；`perms` 语义 = 「具备其中之一即可」。
|
||||
*/
|
||||
const ROUTE_TABLE = [
|
||||
// ---------- 自助信息（登录即可，无需业务权限） ----------
|
||||
// 前端用它得知「我有哪些权限」以渲染菜单，并感知权限是否被他人改动。
|
||||
// ⚠️ perms 为空数组是本表唯一允许的「显式放行」写法，门禁会断言只有本行如此。
|
||||
['GET', '/api/admin/me', []],
|
||||
|
||||
// ---------- 管理员账号管理（高危） ----------
|
||||
['GET', '/api/admin/admin-users', ['admins.manage']],
|
||||
['POST', '/api/admin/admin-users', ['admins.manage']],
|
||||
['PUT', '/api/admin/admin-users/:id/permissions', ['admins.manage']],
|
||||
['PUT', '/api/admin/admin-users/:id/password', ['admins.manage']],
|
||||
['PUT', '/api/admin/admin-users/:id/status', ['admins.manage']],
|
||||
['DELETE', '/api/admin/admin-users/:id', ['admins.manage']],
|
||||
|
||||
// ---------- 数据总览 ----------
|
||||
['GET', '/api/admin/stats', ['dashboard']],
|
||||
|
||||
// ---------- 选手管理 ----------
|
||||
['GET', '/api/admin/accounts', ['accounts']],
|
||||
['GET', '/api/admin/teams', ['accounts']],
|
||||
['POST', '/api/admin/import-excel', ['accounts']],
|
||||
['POST', '/api/admin/contestants/backfill-teacher', ['accounts']],
|
||||
['PUT', '/api/admin/contestants/:id', ['accounts']],
|
||||
['POST', '/api/admin/toggle-test-flag', ['accounts']],
|
||||
// 重置测试数据是真实删除，单列高危（不给「只做选手维护」的人）
|
||||
['POST', '/api/admin/reset-test-data', ['data.reset']],
|
||||
|
||||
// ---------- 作品管理 ----------
|
||||
// 成绩管理页的「考生答题记录」也读 submissions 接口 ⇒ 允许 scores 其一
|
||||
['GET', '/api/admin/submissions/:group', ['submissions', 'scores']],
|
||||
['GET', '/api/admin/submission-file/:group/:id', ['submissions']],
|
||||
['GET', '/api/admin/submissions/:group/:id/word', ['submissions']],
|
||||
['GET', '/api/admin/works/:group', ['submissions']],
|
||||
['GET', '/api/admin/batch-download/:group', ['submissions']],
|
||||
|
||||
// ---------- 成绩管理（阅卷/导出/公示表） ----------
|
||||
['GET', '/api/admin/scores/:group', ['scores', 'review']],
|
||||
['PUT', '/api/admin/scores/:group', ['scores']],
|
||||
['GET', '/api/admin/export-csv/:group', ['scores']],
|
||||
['GET', '/api/admin/export-excel/:group', ['scores']],
|
||||
['GET', '/api/admin/export-publicity/:group', ['scores']],
|
||||
['GET', '/api/admin/competition-item', ['scores']],
|
||||
['PUT', '/api/admin/competition-item', ['scores']],
|
||||
['GET', '/api/admin/big-answers/:group', ['scores', 'review']],
|
||||
['GET', '/api/admin/big-answers/:group/export', ['scores']],
|
||||
['GET', '/api/admin/big-answers/:group/import-template', ['scores']],
|
||||
['POST', '/api/admin/big-answers/:group/import-preview', ['scores']],
|
||||
['POST', '/api/admin/big-answers/:group/import-scores', ['scores']],
|
||||
['PUT', '/api/admin/big-answers/:group/:uid/scores', ['scores']],
|
||||
['GET', '/api/admin/publish-scores', ['scores', 'review']],
|
||||
// 发布 / 撤回 = 高危：能看成绩 ≠ 能公布成绩
|
||||
['PUT', '/api/admin/publish-scores', ['score.publish']],
|
||||
|
||||
// ---------- 时间设置 ----------
|
||||
['GET', '/api/admin/times', ['times']],
|
||||
['PUT', '/api/admin/times', ['times']],
|
||||
['GET', '/api/admin/node-backup/status', ['times']],
|
||||
|
||||
// ---------- 试卷管理 ----------
|
||||
['GET', '/api/admin/exam/:group/questions', ['questions']],
|
||||
['PUT', '/api/admin/exam/:group/questions', ['questions']],
|
||||
['POST', '/api/admin/exam/:group/questions/import-excel', ['questions']],
|
||||
['GET', '/api/admin/exam/:group/questions/template', ['questions']],
|
||||
['PUT', '/api/admin/exam/:group/word-template', ['questions']],
|
||||
['GET', '/api/admin/exam/:group/word-template', ['questions']],
|
||||
['DELETE', '/api/admin/exam/:group/word-template', ['questions']],
|
||||
['GET', '/api/admin/big-questions/:group', ['questions']],
|
||||
['POST', '/api/admin/big-questions/:group', ['questions']],
|
||||
['GET', '/api/admin/big-questions/:group/export', ['questions']],
|
||||
['GET', '/api/admin/big-questions/:group/template', ['questions']],
|
||||
['POST', '/api/admin/big-questions/:group/import-excel', ['questions']],
|
||||
['PUT', '/api/admin/big-questions/:group/:id', ['questions']],
|
||||
['DELETE', '/api/admin/big-questions/:group/:id', ['questions']],
|
||||
|
||||
// ---------- 备赛资料 ----------
|
||||
['GET', '/api/admin/materials/:group', ['materials']],
|
||||
['POST', '/api/admin/materials/:group', ['materials']],
|
||||
['DELETE', '/api/admin/materials/:group/:fileName', ['materials']],
|
||||
|
||||
// ---------- 新闻管理 ----------
|
||||
// ⚠️ /news/order 必须排在 /news/:id 之前
|
||||
['PUT', '/api/admin/news/order', ['news']],
|
||||
['GET', '/api/admin/news', ['news']],
|
||||
['POST', '/api/admin/news', ['news']],
|
||||
['PUT', '/api/admin/news/:id', ['news']],
|
||||
['DELETE', '/api/admin/news/:id', ['news']],
|
||||
['POST', '/api/admin/upload/news-image', ['news']],
|
||||
['POST', '/api/admin/upload/news-file', ['news']],
|
||||
|
||||
// ---------- 轮播管理 ----------
|
||||
// ⚠️ /carousel/order 必须排在 /carousel/:id 之前
|
||||
['PUT', '/api/admin/carousel/order', ['carousel']],
|
||||
['GET', '/api/admin/carousel', ['carousel']],
|
||||
['POST', '/api/admin/carousel', ['carousel']],
|
||||
['PUT', '/api/admin/carousel/:id', ['carousel']],
|
||||
['DELETE', '/api/admin/carousel/:id', ['carousel']],
|
||||
['POST', '/api/admin/upload/image', ['carousel']],
|
||||
|
||||
// ---------- 成绩复核 ----------
|
||||
['GET', '/api/admin/review/search', ['review']],
|
||||
['GET', '/api/admin/review/score/:group/:id', ['review']],
|
||||
].map(([method, pattern, perms]) => ({ method, pattern, perms, re: toRegExp(pattern) }));
|
||||
|
||||
/**
|
||||
* 解析请求需要哪些权限（任一即可）。
|
||||
*
|
||||
* @param {string} method - HTTP 方法（大小写不敏感）
|
||||
* @param {string} path - 请求路径（不含 query）
|
||||
* @returns {string[]|null} 权限点数组；null = 未登记（调用方必须拒绝）
|
||||
*/
|
||||
function resolvePermission(method, path) {
|
||||
const m = String(method || '').toUpperCase();
|
||||
const p = String(path || '').split('?')[0];
|
||||
for (const rule of ROUTE_TABLE) {
|
||||
if (rule.method !== m) continue;
|
||||
if (rule.re.test(p)) return rule.perms;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析数据库里的 permissions 列（JSON 数组文本）。
|
||||
* 容错策略：解析失败 / 非数组 ⇒ 返回空数组（= 无权限），⛔ 绝不回落到「全权」。
|
||||
*
|
||||
* @param {string|null|undefined} raw
|
||||
* @returns {string[]}
|
||||
*/
|
||||
function parsePermissions(raw) {
|
||||
if (raw === null || raw === undefined || raw === '') return [];
|
||||
let arr = raw;
|
||||
if (typeof raw === 'string') {
|
||||
try {
|
||||
arr = JSON.parse(raw);
|
||||
} catch (e) {
|
||||
return [];
|
||||
}
|
||||
}
|
||||
if (!Array.isArray(arr)) return [];
|
||||
return arr.filter(k => typeof k === 'string' && PERMISSION_KEY_SET.has(k));
|
||||
}
|
||||
|
||||
/**
|
||||
* 规整待写入的权限点：只保留已登记的 key，去重，按 PERMISSIONS 顺序排列。
|
||||
* ⛔ 必须过滤未知值 —— 否则前端传错一个字符串就会被存进库，
|
||||
* 将来某个新权限点恰好同名时会「凭空获得权限」。
|
||||
*
|
||||
* @param {string[]} list
|
||||
* @returns {string[]}
|
||||
*/
|
||||
function sanitizePermissions(list) {
|
||||
if (!Array.isArray(list)) return [];
|
||||
const set = new Set(list.filter(k => PERMISSION_KEY_SET.has(k)));
|
||||
return PERMISSION_KEYS.filter(k => set.has(k));
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断某管理员是否满足给定权限（任一命中即可）。
|
||||
*
|
||||
* ⚠️ 三种返回语义必须严格区分：
|
||||
* required === null ⇒ 未登记路由（由 resolvePermission 返回，调用方必须拒绝）
|
||||
* required === [] ⇒ **显式声明**「登录即可，无需业务权限」（如 /api/admin/me）
|
||||
* required === ['a','b'] ⇒ 具备任一即可
|
||||
*
|
||||
* @param {{is_super?:number|boolean, permissions?:string[]|string}} admin
|
||||
* @param {string[]|null} required
|
||||
* @returns {boolean}
|
||||
*/
|
||||
function canAccess(admin, required) {
|
||||
if (!admin) return false;
|
||||
// 🔴 顺序不可换（R178 运行期判据 P3-2 抓到）：**未登记路由对任何人都是拒绝**，
|
||||
// 包括最高管理员。若把 is_super 判在前面，`canAccess(super, null)` 会返回 true ——
|
||||
// 中间件虽然另有 `required === null ⇒ 403` 的前置分支，但那样「默认拒绝」就只活在
|
||||
// 一处调用约定里：任何新调用方（例如前端按钮显隐的服务端预判）漏判即成后门。
|
||||
// 此处作为第二道兜底，保证 null 永远不构成授权。
|
||||
if (!Array.isArray(required)) return false;
|
||||
if (Number(admin.is_super) === 1) return true;
|
||||
// 空数组 = 显式放行（仅限登记为「登录即可」的接口）
|
||||
if (required.length === 0) return true;
|
||||
const owned = Array.isArray(admin.permissions)
|
||||
? admin.permissions
|
||||
: parsePermissions(admin.permissions);
|
||||
return required.some(k => owned.includes(k));
|
||||
}
|
||||
|
||||
/**
|
||||
* 账号是否可被管理（改权限 / 重置口令 / 禁用 / 删除）。
|
||||
* 最高管理员一律不可变动 —— 这是用户明确裁定的硬约束，集中在单点判断，
|
||||
* ⛔ 不得在各接口里各写一遍 `id === 1`。
|
||||
*
|
||||
* @param {{is_super?:number|boolean}} admin
|
||||
* @returns {boolean}
|
||||
*/
|
||||
function isManageable(admin) {
|
||||
return !!admin && Number(admin.is_super) !== 1;
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
PERMISSIONS,
|
||||
PERMISSION_KEYS,
|
||||
PERMISSION_KEY_SET,
|
||||
ROUTE_TABLE,
|
||||
resolvePermission,
|
||||
parsePermissions,
|
||||
sanitizePermissions,
|
||||
canAccess,
|
||||
isManageable,
|
||||
MODULE,
|
||||
HIGH_RISK,
|
||||
};
|
||||
BIN
app/lib/assets/publicity-template.xlsx
Normal file
BIN
app/lib/assets/publicity-template.xlsx
Normal file
Binary file not shown.
78
app/lib/auditLog.js
Normal file
78
app/lib/auditLog.js
Normal file
@@ -0,0 +1,78 @@
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* 管理员高危操作审计（R178）
|
||||
* ============================================================================
|
||||
*
|
||||
* 三种写法被刻意排除：
|
||||
* 1. **不在控制器里直接 create** —— 控制器有 60+ 个方法，散落写入必然漏；
|
||||
* 统一走本函数，写入范围只由「谁调用它」决定，容易被审阅。
|
||||
* 2. **不做全量写操作审计** —— 见 model/adminAuditLog.js 头注：约 30 个写接口，
|
||||
* 日志量增长快且无清理策略；真正要回答的是「谁改了成绩 / 谁动了账号」。
|
||||
* 3. **不阻断业务** —— 审计失败只 warn。日志表故障不该让「发布成绩」失败，
|
||||
* 否则为可观测性牺牲了主流程可用性。
|
||||
*
|
||||
* ⚠️ detail 只放「变更前后的非敏感差异」。⛔ 绝不传口令、令牌、身份证号明文。
|
||||
*/
|
||||
|
||||
/**
|
||||
* 写入一条审计记录（best-effort，永不抛出）
|
||||
*
|
||||
* @param {Object} ctx - Egg 上下文（需 ctx.state.currentAdmin 已由 adminAuth 写入）
|
||||
* @param {string} action - 动作标识，点号分层，如 'score.publish' / 'admin.create'
|
||||
* @param {string} [target] - 操作对象，如组别、用户名、选手 ID
|
||||
* @param {Object|string} [detail] - 补充信息（对象会被 JSON 序列化）
|
||||
* @returns {Promise<void>}
|
||||
*/
|
||||
async function recordAudit(ctx, action, target, detail) {
|
||||
try {
|
||||
const admin = (ctx && ctx.state && ctx.state.currentAdmin) || null;
|
||||
// 没有操作人就不写：宁可缺一条，也不要写出一条「admin_id=0」的假归属，
|
||||
// 那会让人误以为系统账号做过操作。
|
||||
if (!admin || !admin.id) {
|
||||
ctx && ctx.logger && ctx.logger.warn(`[audit] 缺少 currentAdmin，跳过记录 action=${action}`);
|
||||
return;
|
||||
}
|
||||
|
||||
let detailText = null;
|
||||
if (detail !== undefined && detail !== null) {
|
||||
try {
|
||||
detailText = typeof detail === 'string' ? detail : JSON.stringify(detail);
|
||||
} catch (e) {
|
||||
detailText = '[unserializable]';
|
||||
}
|
||||
if (detailText && detailText.length > 4000) detailText = detailText.slice(0, 4000) + '…';
|
||||
}
|
||||
|
||||
await ctx.model.AdminAuditLog.create({
|
||||
admin_id: admin.id,
|
||||
admin_username: admin.username,
|
||||
action: String(action || 'unknown').slice(0, 64),
|
||||
target: target === undefined || target === null ? null : String(target).slice(0, 200),
|
||||
detail: detailText,
|
||||
ip: String(ctx.ip || '').slice(0, 64) || null,
|
||||
created_at: new Date(),
|
||||
});
|
||||
} catch (err) {
|
||||
// 审计失败不得影响业务：只记日志
|
||||
if (ctx && ctx.logger) {
|
||||
ctx.logger.warn(`[audit] 写入失败 action=${action}:`, err && err.message);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** 审计动作常量（避免各处手写字符串导致同一动作被记成两个名字） */
|
||||
const ACTIONS = {
|
||||
SCORE_PUBLISH: 'score.publish',
|
||||
SCORE_UNPUBLISH: 'score.unpublish',
|
||||
DATA_RESET_TEST: 'data.resetTest',
|
||||
CONTESTANT_DELETE: 'contestant.delete',
|
||||
EXAM_UNSUBMIT: 'exam.unsubmit',
|
||||
ADMIN_CREATE: 'admin.create',
|
||||
ADMIN_PERMISSIONS: 'admin.permissions',
|
||||
ADMIN_PASSWORD: 'admin.password',
|
||||
ADMIN_STATUS: 'admin.status',
|
||||
ADMIN_DELETE: 'admin.delete',
|
||||
};
|
||||
|
||||
module.exports = { recordAudit, ACTIONS };
|
||||
559
app/lib/publicitySheet.js
Normal file
559
app/lib/publicitySheet.js
Normal file
@@ -0,0 +1,559 @@
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* 成绩公示表导出引擎 —— 纯函数层（R176）
|
||||
*
|
||||
* 目标：以赛事官方参考模板（`lib/assets/publicity-template.xlsx`）为**基底**生成
|
||||
* xlsx，只填数据、不改版式，人工后续补「获奖等级」即可直接用。
|
||||
*
|
||||
* 🔴 为什么不用 `@e965/xlsx` 直接改模板再写回（实测结论，2026-10-19）：
|
||||
* 读入模板 → 写一个单元格 → 写回，`sheet1.xml` 里的 `s=` 样式引用数
|
||||
* 从 **214 → 0**、`styles.xml` 从 22773 → 1546 字节，合并单元格还在但
|
||||
* 边框/字号/列宽全部丢失。该库 CE 版**不写出样式**，`cellStyles: true`
|
||||
* 只影响读、不影响写。
|
||||
* ⇒ 唯一能保住版式的做法 = 只替换 `xl/worksheets/sheet1.xml` 这一个 zip 条目，
|
||||
* 其余条目**原始压缩字节照抄**（不解压不重压 ⇒ 连 CRC 都不用重算）。
|
||||
*
|
||||
* 🔴 零依赖约束：只用 Node 内置 `zlib`，CRC32 自己实现。这样 `--self-test`
|
||||
* 可以在零 DB / 零后端 / 零网络的条件下直接 require 本文件跑矩阵。
|
||||
*
|
||||
* 🔴 数据行数可以超过模板预留的 27 行：模板数据区是 row 3..29，两条签字行在 row 30
|
||||
* （裁判长）与 row 33（仲裁长）。新表按「新数据末行 + 1」与「新数据末行 + 4」
|
||||
* 的相对偏移重排两条签字行（N=27 时正好复现 row 30 / row 33）。
|
||||
* ⚠️ 备注块合并区 `H3:J8` 固定不动（H:J 列，与 A:G 的数据列不冲突），
|
||||
* 但必须保证至少生成 6 个数据行，否则备注框的下边框会落空。
|
||||
*/
|
||||
|
||||
const zlib = require('zlib');
|
||||
|
||||
// ==================== 常量（模板结构的单一描述源） ====================
|
||||
|
||||
/** 模板第 2 行的 7 个表头，仅用于自证断言与文档；实际写值不依赖它 */
|
||||
const TEMPLATE_HEADERS = ['序号', '参赛单位名称', '参赛选手', '指导教师', '成绩排名', '总分数', '获奖等级'];
|
||||
|
||||
/** 数据区起止行（1 基，含端点）。row 2 = 表头，row 3 起才是数据 */
|
||||
const DATA_FIRST_ROW = 3;
|
||||
/**
|
||||
* 🔴 数据区实际末行是 29，**不是 30**。
|
||||
* 模板的 row 30 是「裁判长签字：」行（A30 / E30 各一个），row 33 是「仲裁长签字：」行。
|
||||
* 把 30 当数据行会直接抹掉裁判长签字 —— 2026-10-19 实测踩过这个坑。
|
||||
*/
|
||||
const DATA_LAST_ROW = 29;
|
||||
/** 签字行原始行号（模板里两条：裁判长在 30，仲裁长在 33） */
|
||||
const SIGN_ROWS = [30, 33];
|
||||
/** 模板预留的数据行数（row 3..29 = 27 行；模板里 row 29 没有 row 元素，不影响计数口径） */
|
||||
const RESERVED_DATA_ROWS = DATA_LAST_ROW - DATA_FIRST_ROW + 1;
|
||||
/** 末条签字行行号 */
|
||||
const TEMPLATE_TAIL_ROW = SIGN_ROWS[SIGN_ROWS.length - 1];
|
||||
/** 签字行相对「数据区末行」的偏移（33 - 29 = 4） */
|
||||
const TAIL_OFFSET = TEMPLATE_TAIL_ROW - DATA_LAST_ROW;
|
||||
/** 备注块 H3:J8 要求的最小数据行数（8 - 3 + 1 = 6） */
|
||||
const MIN_DATA_ROWS_FOR_NOTE = 6;
|
||||
/** 数据列 A..G */
|
||||
const DATA_COLS = ['A', 'B', 'C', 'D', 'E', 'F', 'G'];
|
||||
/** 备注块所在列（只补空样式单元格，撑住合并区边框） */
|
||||
const NOTE_COLS = ['H', 'I', 'J'];
|
||||
|
||||
/** 模板标题里等待替换的两段占位文本 */
|
||||
const TITLE_PLACEHOLDER_ITEM = '***赛项（选拔赛/国内决赛）比赛结果公示表';
|
||||
const TITLE_PLACEHOLDER_CODE = '赛项编号：';
|
||||
|
||||
// ==================== CRC32 / zip 读写 ====================
|
||||
|
||||
let CRC_TABLE = null;
|
||||
function crcTable() {
|
||||
if (CRC_TABLE) return CRC_TABLE;
|
||||
const t = new Int32Array(256);
|
||||
for (let n = 0; n < 256; n++) {
|
||||
let c = n;
|
||||
for (let k = 0; k < 8; k++) {
|
||||
c = (c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1);
|
||||
}
|
||||
t[n] = c;
|
||||
}
|
||||
CRC_TABLE = t;
|
||||
return t;
|
||||
}
|
||||
|
||||
/** 标准 CRC-32（IEEE 802.3），返回无符号 32 位 */
|
||||
function crc32(buf) {
|
||||
const t = crcTable();
|
||||
let c = -1;
|
||||
for (let i = 0; i < buf.length; i++) {
|
||||
c = t[(c ^ buf[i]) & 0xFF] ^ (c >>> 8);
|
||||
}
|
||||
return (c ^ -1) >>> 0;
|
||||
}
|
||||
|
||||
/** 从尾部找 End Of Central Directory。找不到返回 -1 */
|
||||
function findEOCD(buf) {
|
||||
const min = Math.max(0, buf.length - 65557);
|
||||
for (let i = buf.length - 22; i >= min; i--) {
|
||||
if (buf[i] === 0x50 && buf[i + 1] === 0x4b && buf[i + 2] === 0x05 && buf[i + 3] === 0x06) return i;
|
||||
}
|
||||
return -1;
|
||||
}
|
||||
|
||||
/**
|
||||
* 读 zip，返回每个条目的**原始压缩字节**（不解压）。
|
||||
* 中央目录里的 compSize / crc 总是准确的（即使 local header 用了 data descriptor），
|
||||
* 所以定位数据区一律以中央目录为准。
|
||||
*/
|
||||
function readZip(buf) {
|
||||
if (!Buffer.isBuffer(buf) || buf.length < 22) throw new Error('不是有效的 zip/xlsx（内容过短）');
|
||||
const eocd = findEOCD(buf);
|
||||
if (eocd < 0) throw new Error('不是有效的 zip/xlsx（找不到 EOCD）');
|
||||
|
||||
const count = buf.readUInt16LE(eocd + 10);
|
||||
let off = buf.readUInt32LE(eocd + 16);
|
||||
if (off >= buf.length) throw new Error('中央目录偏移越界');
|
||||
|
||||
const entries = [];
|
||||
for (let i = 0; i < count; i++) {
|
||||
if (off + 46 > buf.length || buf.readUInt32LE(off) !== 0x02014b50) {
|
||||
throw new Error(`中央目录第 ${i} 项签名不符 @${off}`);
|
||||
}
|
||||
const method = buf.readUInt16LE(off + 10);
|
||||
const crc = buf.readUInt32LE(off + 16);
|
||||
const compSize = buf.readUInt32LE(off + 20);
|
||||
const uncompSize = buf.readUInt32LE(off + 24);
|
||||
const nameLen = buf.readUInt16LE(off + 28);
|
||||
const extraLen = buf.readUInt16LE(off + 30);
|
||||
const commentLen = buf.readUInt16LE(off + 32);
|
||||
const localOff = buf.readUInt32LE(off + 42);
|
||||
const name = buf.slice(off + 46, off + 46 + nameLen).toString('utf8');
|
||||
|
||||
if (localOff + 30 > buf.length || buf.readUInt32LE(localOff) !== 0x04034b50) {
|
||||
throw new Error(`条目 ${name} 的本地头损坏`);
|
||||
}
|
||||
const lnLen = buf.readUInt16LE(localOff + 26);
|
||||
const leLen = buf.readUInt16LE(localOff + 28);
|
||||
const dataStart = localOff + 30 + lnLen + leLen;
|
||||
if (dataStart + compSize > buf.length) throw new Error(`条目 ${name} 的数据区越界`);
|
||||
|
||||
entries.push({
|
||||
name,
|
||||
method,
|
||||
crc,
|
||||
compSize,
|
||||
uncompSize,
|
||||
data: buf.slice(dataStart, dataStart + compSize),
|
||||
});
|
||||
|
||||
off += 46 + nameLen + extraLen + commentLen;
|
||||
}
|
||||
return entries;
|
||||
}
|
||||
|
||||
/** 把条目按原压缩字节重新打包成 zip（不重压缩 ⇒ CRC 无需重算） */
|
||||
function writeZip(entries) {
|
||||
const locals = [];
|
||||
const centrals = [];
|
||||
let offset = 0;
|
||||
|
||||
for (const e of entries) {
|
||||
const nameBuf = Buffer.from(e.name, 'utf8');
|
||||
const crc = e.crc >>> 0;
|
||||
const compSize = e.data.length;
|
||||
const uncompSize = e.uncompSize;
|
||||
|
||||
const lh = Buffer.alloc(30);
|
||||
lh.writeUInt32LE(0x04034b50, 0);
|
||||
lh.writeUInt16LE(20, 4); // version needed to extract
|
||||
lh.writeUInt16LE(0x0800, 6); // general purpose flag: UTF-8 名称
|
||||
lh.writeUInt16LE(e.method, 8);
|
||||
lh.writeUInt16LE(0, 10); // last mod time（不关心，固定 0）
|
||||
lh.writeUInt16LE(0, 12); // last mod date
|
||||
lh.writeUInt32LE(crc, 14);
|
||||
lh.writeUInt32LE(compSize, 18);
|
||||
lh.writeUInt32LE(uncompSize, 22);
|
||||
lh.writeUInt16LE(nameBuf.length, 26);
|
||||
lh.writeUInt16LE(0, 28); // extra len
|
||||
locals.push(lh, nameBuf, e.data);
|
||||
|
||||
const ch = Buffer.alloc(46);
|
||||
ch.writeUInt32LE(0x02014b50, 0);
|
||||
ch.writeUInt16LE(20, 4); // version made by
|
||||
ch.writeUInt16LE(20, 6); // version needed
|
||||
ch.writeUInt16LE(0x0800, 8);
|
||||
ch.writeUInt16LE(e.method, 10);
|
||||
ch.writeUInt16LE(0, 12);
|
||||
ch.writeUInt16LE(0, 14);
|
||||
ch.writeUInt32LE(crc, 16);
|
||||
ch.writeUInt32LE(compSize, 20);
|
||||
ch.writeUInt32LE(uncompSize, 24);
|
||||
ch.writeUInt16LE(nameBuf.length, 28);
|
||||
ch.writeUInt16LE(0, 30); // extra
|
||||
ch.writeUInt16LE(0, 32); // comment
|
||||
ch.writeUInt16LE(0, 34); // disk number
|
||||
ch.writeUInt16LE(0, 36); // internal attrs
|
||||
ch.writeUInt32LE(0, 38); // external attrs
|
||||
ch.writeUInt32LE(offset, 42);
|
||||
centrals.push(ch, nameBuf);
|
||||
|
||||
offset += lh.length + nameBuf.length + e.data.length;
|
||||
}
|
||||
|
||||
const centralStart = offset;
|
||||
const centralBuf = Buffer.concat(centrals);
|
||||
const eocd = Buffer.alloc(22);
|
||||
eocd.writeUInt32LE(0x06054b50, 0);
|
||||
eocd.writeUInt16LE(0, 4);
|
||||
eocd.writeUInt16LE(0, 6);
|
||||
eocd.writeUInt16LE(entries.length, 8);
|
||||
eocd.writeUInt16LE(entries.length, 10);
|
||||
eocd.writeUInt32LE(centralBuf.length, 12);
|
||||
eocd.writeUInt32LE(centralStart, 16);
|
||||
eocd.writeUInt16LE(0, 20);
|
||||
return Buffer.concat([Buffer.concat(locals), centralBuf, eocd]);
|
||||
}
|
||||
|
||||
/** 解压单个条目为 utf8 文本（method 0=store / 8=deflate） */
|
||||
function entryText(entry) {
|
||||
if (!entry) throw new Error('条目不存在');
|
||||
const raw = entry.method === 0 ? entry.data : zlib.inflateRawSync(entry.data);
|
||||
return raw.toString('utf8');
|
||||
}
|
||||
|
||||
/** 用 utf8 文本替换某条目（重新 deflate + 重算 CRC） */
|
||||
function replaceEntryText(entries, name, text) {
|
||||
const raw = Buffer.from(text, 'utf8');
|
||||
const deflated = zlib.deflateRawSync(raw);
|
||||
let hit = 0;
|
||||
const out = entries.map(e => {
|
||||
if (e.name !== name) return e;
|
||||
hit++;
|
||||
return {
|
||||
name: e.name,
|
||||
method: 8,
|
||||
crc: crc32(raw),
|
||||
compSize: deflated.length,
|
||||
uncompSize: raw.length,
|
||||
data: deflated,
|
||||
};
|
||||
});
|
||||
if (hit !== 1) throw new Error(`条目 ${name} 命中 ${hit} 次（应恰好 1 次）`);
|
||||
return out;
|
||||
}
|
||||
|
||||
// ==================== XML 片段工具 ====================
|
||||
|
||||
const XML_ESCAPE = { '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' };
|
||||
function esc(s) {
|
||||
return String(s === null || s === undefined ? '' : s).replace(/[&<>"']/g, c => XML_ESCAPE[c]);
|
||||
}
|
||||
|
||||
const ROW_RE = /<row\b[^>]*\/>|<row\b[^>]*>[\s\S]*?<\/row>/g;
|
||||
const CELL_RE = /<c\b[^>]*\/>|<c\b[^>]*>[\s\S]*?<\/c>/g;
|
||||
|
||||
function rowNumber(rowXml) {
|
||||
const m = /<row\b[^>]*\br="(\d+)"/.exec(rowXml);
|
||||
return m ? parseInt(m[1], 10) : -1;
|
||||
}
|
||||
|
||||
/** 从一行 XML 里取 { 列字母: s 值 } */
|
||||
function rowStyles(rowXml) {
|
||||
const out = {};
|
||||
const cells = rowXml.match(CELL_RE) || [];
|
||||
for (const c of cells) {
|
||||
const rm = /\br="([A-Z]+)\d+"/.exec(c);
|
||||
if (!rm) continue;
|
||||
const sm = /\bs="(\d+)"/.exec(c);
|
||||
if (sm) out[rm[1]] = sm[1];
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
/** 生成一个数据单元格（数值 / 文本 / 空） */
|
||||
function cellXml(col, row, style, value) {
|
||||
const ref = col + row;
|
||||
const sAttr = style === undefined ? '' : ` s="${style}"`;
|
||||
if (value === null || value === undefined || value === '') {
|
||||
return `<c r="${ref}"${sAttr}/>`;
|
||||
}
|
||||
if (typeof value === 'number' && isFinite(value)) {
|
||||
return `<c r="${ref}"${sAttr}><v>${value}</v></c>`;
|
||||
}
|
||||
// 用 inlineStr 而不是 sharedStrings：新引入的字符串不用再去维护共享表下标
|
||||
return `<c r="${ref}"${sAttr} t="inlineStr"><is><t xml:space="preserve">${esc(value)}</t></is></c>`;
|
||||
}
|
||||
|
||||
/** 选「最常见的数据行样式」作为新行模板，避免拿模板里被手工改过的那一行当标准 */
|
||||
function pickDataRowStyles(dataRows) {
|
||||
const counted = new Map();
|
||||
for (const r of dataRows) {
|
||||
const st = rowStyles(r.xml);
|
||||
const sig = DATA_COLS.map(c => st[c] === undefined ? '-' : st[c]).join(',');
|
||||
const cur = counted.get(sig);
|
||||
if (cur) cur.n++;
|
||||
else counted.set(sig, { n: 1, styles: st });
|
||||
}
|
||||
let best = null;
|
||||
for (const [, v] of counted) {
|
||||
if (!best || v.n > best.n) best = v;
|
||||
}
|
||||
return best ? best.styles : { A: '6', B: '7', C: '7', D: '8', E: '6', F: '6', G: '6' };
|
||||
}
|
||||
|
||||
/**
|
||||
* 生成新的 sheetData。
|
||||
*
|
||||
* @param {string} sheetXml 原 sheet1.xml
|
||||
* @param {Array<Object>} rows buildPublicityRows 的产物
|
||||
* @returns {{ xml: string, dataRows: number, tailRow: number, styles: Object }}
|
||||
*/
|
||||
function patchSheetData(sheetXml, rows) {
|
||||
const sheetDataMatch = /<sheetData\b[^>]*>([\s\S]*?)<\/sheetData>/.exec(sheetXml);
|
||||
if (!sheetDataMatch) throw new Error('模板缺少 <sheetData>');
|
||||
|
||||
const allRows = sheetDataMatch[1].match(ROW_RE) || [];
|
||||
const head = [];
|
||||
const data = [];
|
||||
const tail = [];
|
||||
for (const r of allRows) {
|
||||
const n = rowNumber(r);
|
||||
if (n <= 2) head.push(r);
|
||||
else if (n >= SIGN_ROWS[0]) tail.push(r);
|
||||
else data.push({ n, xml: r });
|
||||
}
|
||||
if (head.length !== 2) throw new Error(`模板表头行应为 2 行，实际 ${head.length}`);
|
||||
if (data.length === 0) throw new Error('模板没有数据行可作样式参照');
|
||||
// 🔴 必须同时守住两条签字行：只保留一条等于把「裁判长签字」或「仲裁长签字」丢了
|
||||
if (tail.length !== SIGN_ROWS.length) {
|
||||
throw new Error(`模板签字行应为 ${SIGN_ROWS.length} 条（row ${SIGN_ROWS.join(' / ')}），实际 ${tail.length} 条`);
|
||||
}
|
||||
|
||||
const styles = pickDataRowStyles(data);
|
||||
// 备注块 H3:J8 的空单元格样式：直接取模板数据行里 H/I/J 的 s（row 3 有备注文本，取 row 4 起）
|
||||
const noteStyleFrom = {};
|
||||
for (const d of data) {
|
||||
if (d.n <= 8) {
|
||||
const st = rowStyles(d.xml);
|
||||
for (const c of NOTE_COLS) {
|
||||
if (st[c] !== undefined && noteStyleFrom[c] === undefined) noteStyleFrom[c] = st[c];
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
const count = Math.max(rows.length, MIN_DATA_ROWS_FOR_NOTE);
|
||||
const out = [];
|
||||
for (const h of head) out.push(h);
|
||||
|
||||
for (let i = 0; i < count; i++) {
|
||||
const r = DATA_FIRST_ROW + i;
|
||||
const row = rows[i] || null;
|
||||
const cells = [
|
||||
cellXml('A', r, styles.A, row ? row.seq : null),
|
||||
cellXml('B', r, styles.B, row ? row.org : null),
|
||||
cellXml('C', r, styles.C, row ? row.players : null),
|
||||
cellXml('D', r, styles.D, row ? row.teachers : null),
|
||||
cellXml('E', r, styles.E, row ? row.rank : null),
|
||||
cellXml('F', r, styles.F, row ? row.score : null),
|
||||
// 获奖等级：用户裁定「空置人工填入」⇒ 永远不写值
|
||||
cellXml('G', r, styles.G, null),
|
||||
];
|
||||
// 备注合并区 H3:J8 需要这些单元格存在才能撑住边框
|
||||
if (r <= 8) {
|
||||
for (const c of NOTE_COLS) cells.push(cellXml(c, r, noteStyleFrom[c], null));
|
||||
}
|
||||
out.push(`<row r="${r}" customHeight="1" spans="1:7">${cells.join('')}</row>`);
|
||||
}
|
||||
|
||||
const delta = (count + (DATA_FIRST_ROW - 1)) - DATA_LAST_ROW; // 新数据末行 - 旧数据末行
|
||||
const shiftRow = (xml, add) => {
|
||||
if (add === 0) return xml;
|
||||
return xml.replace(/(<row\b[^>]*\br=")(\d+)(")/, (m, p1, p2, p3) => p1 + (parseInt(p2, 10) + add) + p3)
|
||||
.replace(/(<c\b[^>]*\br="[A-Z]+)(\d+)(")/g, (m, p1, p2, p3) => p1 + (parseInt(p2, 10) + add) + p3);
|
||||
};
|
||||
for (const t of tail) out.push(shiftRow(t, delta));
|
||||
|
||||
const newSheetData = `<sheetData>${out.join('')}</sheetData>`;
|
||||
let xml = sheetXml.replace(sheetDataMatch[0], newSheetData);
|
||||
|
||||
// dimension 同步（否则 Excel 认为表格只到旧末行，滚动区/打印区会截断）
|
||||
const tailRow = TEMPLATE_TAIL_ROW + delta;
|
||||
xml = xml.replace(/<dimension\b[^>]*\bref="[^"]*"/, `<dimension ref="A1:J${tailRow}"`);
|
||||
|
||||
return { xml, dataRows: count, tailRow, styles };
|
||||
}
|
||||
|
||||
/**
|
||||
* 替换标题里的赛项名与赛项编号。
|
||||
*
|
||||
* 标题是 A1 一个单元格里的三行文本（存在 sharedStrings 第 0 项），
|
||||
* 所以改 sharedStrings 比改 sheet1 更准（A1 是 t="s" 引用，改 sheet 只能整体替换）。
|
||||
*
|
||||
* @param {string} xml sharedStrings.xml 原文
|
||||
* @param {{itemName?: string, itemCode?: string}} meta
|
||||
* @returns {{ xml: string, replacedItem: boolean, replacedCode: boolean }}
|
||||
*/
|
||||
function patchSharedStringsTitle(xml, meta) {
|
||||
const itemName = meta && meta.itemName ? String(meta.itemName).trim() : '';
|
||||
const itemCode = meta && meta.itemCode ? String(meta.itemCode).trim() : '';
|
||||
|
||||
let replacedItem = false;
|
||||
let replacedCode = false;
|
||||
|
||||
// 定位第 1 个 <si>（标题）
|
||||
const siMatch = /<si>([\s\S]*?)<\/si>/.exec(xml);
|
||||
if (!siMatch) throw new Error('sharedStrings 里没有 <si>');
|
||||
|
||||
let inner = siMatch[1];
|
||||
|
||||
if (itemName && inner.indexOf(TITLE_PLACEHOLDER_ITEM) >= 0) {
|
||||
// 赛项名替换掉「***」，保留「（选拔赛/国内决赛）比赛结果公示表」的公文后缀
|
||||
inner = inner.replace(TITLE_PLACEHOLDER_ITEM, `${esc(itemName)}（选拔赛/国内决赛）比赛结果公示表`);
|
||||
replacedItem = true;
|
||||
}
|
||||
if (itemCode && inner.indexOf(TITLE_PLACEHOLDER_CODE) >= 0) {
|
||||
// 编号为空时不追加，避免留下一个孤零零的「赛项编号：」
|
||||
inner = inner.replace(TITLE_PLACEHOLDER_CODE, `${TITLE_PLACEHOLDER_CODE}${esc(itemCode)}`);
|
||||
replacedCode = true;
|
||||
}
|
||||
|
||||
if (!replacedItem && !replacedCode) return { xml, replacedItem, replacedCode };
|
||||
|
||||
const newSi = `<si>${inner}</si>`;
|
||||
return { xml: xml.replace(siMatch[0], newSi), replacedItem, replacedCode };
|
||||
}
|
||||
|
||||
/**
|
||||
* 完整流程：模板字节 + 数据行 + 标题信息 → 新 xlsx 字节。
|
||||
* @param {Buffer} templateBuf
|
||||
* @param {Array<Object>} rows
|
||||
* @param {{itemName?: string, itemCode?: string}} [meta]
|
||||
*/
|
||||
function buildXlsx(templateBuf, rows, meta) {
|
||||
const entries = readZip(templateBuf);
|
||||
|
||||
const sheetEntry = entries.find(e => e.name === 'xl/worksheets/sheet1.xml');
|
||||
if (!sheetEntry) throw new Error('模板缺少 xl/worksheets/sheet1.xml');
|
||||
const sheetXml = entryText(sheetEntry);
|
||||
const patched = patchSheetData(sheetXml, rows);
|
||||
|
||||
let next = replaceEntryText(entries, 'xl/worksheets/sheet1.xml', patched.xml);
|
||||
|
||||
const ssEntry = next.find(e => e.name === 'xl/sharedStrings.xml');
|
||||
let titleResult = { replacedItem: false, replacedCode: false };
|
||||
if (ssEntry) {
|
||||
const ssXml = entryText(ssEntry);
|
||||
const r = patchSharedStringsTitle(ssXml, meta || {});
|
||||
titleResult = { replacedItem: r.replacedItem, replacedCode: r.replacedCode };
|
||||
if (r.replacedItem || r.replacedCode) {
|
||||
next = replaceEntryText(next, 'xl/sharedStrings.xml', r.xml);
|
||||
}
|
||||
}
|
||||
|
||||
return {
|
||||
buffer: writeZip(next),
|
||||
dataRows: patched.dataRows,
|
||||
tailRow: patched.tailRow,
|
||||
title: titleResult,
|
||||
styles: patched.styles,
|
||||
};
|
||||
}
|
||||
|
||||
// ==================== 数据构造（纯函数） ====================
|
||||
|
||||
/** 分数归一：null/''/NaN → null；字符串数字 → number */
|
||||
function toScore(v) {
|
||||
if (v === null || v === undefined || v === '') return null;
|
||||
const n = Number(v);
|
||||
return isFinite(n) ? Math.round(n * 100) / 100 : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 把「小组」数组排成公示表的行。
|
||||
*
|
||||
* 一行 = 一个小组（用户裁定：一组一人参赛、成绩全组共享 ⇒ 同一分数不该占多行）。
|
||||
* 排序：有分的按分数**由高到低**，未评分的排最后；同分按团队编号升序保证稳定。
|
||||
* 获奖等级不在此处产生（永远留空）。
|
||||
*
|
||||
* @param {Array<{teamUid?:number|string, teamId?:string, org?:string,
|
||||
* players?:string[]|string, teachers?:string[]|string, score?:number|string}>} teams
|
||||
* @returns {Array<{seq:number, org:string, players:string, teachers:string, rank:(number|null), score:(number|null), teamUid:any, teamId:string}>}
|
||||
*/
|
||||
function buildPublicityRows(teams) {
|
||||
const list = Array.isArray(teams) ? teams : [];
|
||||
const norm = list.map(t => {
|
||||
const players = Array.isArray(t.players) ? t.players : (t.players ? [t.players] : []);
|
||||
const teachers = Array.isArray(t.teachers) ? t.teachers : (t.teachers ? [t.teachers] : []);
|
||||
return {
|
||||
teamUid: t.teamUid === undefined ? null : t.teamUid,
|
||||
teamId: t.teamId === undefined || t.teamId === null ? '' : String(t.teamId),
|
||||
org: t.org === undefined || t.org === null ? '' : String(t.org),
|
||||
players: uniqKeepOrder(players).join('、'),
|
||||
teachers: uniqKeepOrder(teachers).join('、'),
|
||||
score: toScore(t.score),
|
||||
};
|
||||
});
|
||||
|
||||
norm.sort((a, b) => {
|
||||
const sa = a.score === null ? -Infinity : a.score;
|
||||
const sb = b.score === null ? -Infinity : b.score;
|
||||
if (sb !== sa) return sb - sa;
|
||||
// 未评分的两个也按编号定序，避免顺序随查询波动
|
||||
if (a.teamId < b.teamId) return -1;
|
||||
if (a.teamId > b.teamId) return 1;
|
||||
return 0;
|
||||
});
|
||||
|
||||
let rank = 0;
|
||||
return norm.map((t, i) => {
|
||||
// 未评分不参与排名（否则会出现「0 分并列第 N」的假排名）
|
||||
if (t.score !== null) rank++;
|
||||
return {
|
||||
seq: i + 1,
|
||||
org: t.org,
|
||||
players: t.players,
|
||||
teachers: t.teachers,
|
||||
rank: t.score === null ? null : rank,
|
||||
score: t.score,
|
||||
teamUid: t.teamUid,
|
||||
teamId: t.teamId,
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
/** 去重保序（同组同名只留一份） */
|
||||
function uniqKeepOrder(arr) {
|
||||
const seen = new Set();
|
||||
const out = [];
|
||||
for (const x of arr) {
|
||||
const s = String(x === null || x === undefined ? '' : x).trim();
|
||||
if (!s || seen.has(s)) continue;
|
||||
seen.add(s);
|
||||
out.push(s);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
TEMPLATE_HEADERS,
|
||||
DATA_FIRST_ROW,
|
||||
DATA_LAST_ROW,
|
||||
SIGN_ROWS,
|
||||
RESERVED_DATA_ROWS,
|
||||
TEMPLATE_TAIL_ROW,
|
||||
TAIL_OFFSET,
|
||||
MIN_DATA_ROWS_FOR_NOTE,
|
||||
DATA_COLS,
|
||||
TITLE_PLACEHOLDER_ITEM,
|
||||
TITLE_PLACEHOLDER_CODE,
|
||||
crc32,
|
||||
findEOCD,
|
||||
readZip,
|
||||
writeZip,
|
||||
entryText,
|
||||
replaceEntryText,
|
||||
rowNumber,
|
||||
rowStyles,
|
||||
cellXml,
|
||||
pickDataRowStyles,
|
||||
patchSheetData,
|
||||
patchSharedStringsTitle,
|
||||
buildXlsx,
|
||||
toScore,
|
||||
buildPublicityRows,
|
||||
uniqKeepOrder,
|
||||
};
|
||||
287
app/lib/teacherBackfill.js
Normal file
287
app/lib/teacherBackfill.js
Normal file
@@ -0,0 +1,287 @@
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* 指导教师回填 —— 纯判定层（R176）
|
||||
*
|
||||
* 背景：`contestants` 原本没有任何「指导教师」承载字段，而成绩公示表
|
||||
* （`7-2026一带一路暨金砖大赛成绩公示表-参考模版.xlsx`）第 4 列必须填写。
|
||||
* 报名表里其实有指导教师行，但导入流程按业务规则只导入「参赛选手」身份
|
||||
* （`service/admin.js` 的 IMPORT_IDENTITY），教师行被计入 `ignored` 丢弃。
|
||||
*
|
||||
* 本模块只负责**从报名表二维数组里把指导教师找出来、按小组归并**，
|
||||
* 不碰数据库、不碰文件、不依赖 Egg。落库由 `service/admin.js#backfillTeachers` 完成。
|
||||
*
|
||||
* 🔴 为什么不直接复用既有导入：`importContestants` 对已存在的身份证号一律 skip
|
||||
* （`result.skipped++`），所以「重导一次」不会更新任何字段。回填必须是独立通路。
|
||||
*
|
||||
* 🔴 为什么必须带 group：`teams.team_uid` 仅组内唯一、可跨组重号（实测本科组也有
|
||||
* team_uid=1），只按 teamId 归并会把别的组的教师挂到本组头上。
|
||||
*/
|
||||
|
||||
/** 教师身份白名单（归一化：去掉所有空白字符后比对） */
|
||||
const TEACHER_IDENTITIES = [
|
||||
'指导教师',
|
||||
'指导老师',
|
||||
'指导专家',
|
||||
'指导教师(专家)',
|
||||
'指导教师（专家）',
|
||||
'指导教师(教练)',
|
||||
'指导教师（教练）',
|
||||
'教练',
|
||||
'导师',
|
||||
];
|
||||
|
||||
/** 组别别名 → 系统 key。⚠️ 名字带 TEACHER_ 前缀，避免与 service/admin.js 的 GROUP_ALIAS 撞名 */
|
||||
const TEACHER_GROUP_ALIAS = {
|
||||
中职: 'zhongzhi',
|
||||
中职组: 'zhongzhi',
|
||||
高职: 'gaozhi',
|
||||
高职组: 'gaozhi',
|
||||
本科: 'benke',
|
||||
本科组: 'benke',
|
||||
教师: 'jiaoshi',
|
||||
教师组: 'jiaoshi',
|
||||
zhongzhi: 'zhongzhi',
|
||||
gaozhi: 'gaozhi',
|
||||
benke: 'benke',
|
||||
jiaoshi: 'jiaoshi',
|
||||
};
|
||||
|
||||
/** 报名表列名别名（与导入契约同源，但这里只取回填必需的 4 列） */
|
||||
const TEACHER_COLUMN_ALIAS = {
|
||||
name: ['姓名', '全名', 'name'],
|
||||
teamId: ['队伍编号', '队伍ID', '队伍id', 'team_id', 'team_number'],
|
||||
group: ['组别', 'group'],
|
||||
identity: ['身份', 'identity'],
|
||||
};
|
||||
|
||||
const ROW_STATUS = {
|
||||
TEACHER: 'TEACHER',
|
||||
NOT_TEACHER: 'NOT_TEACHER',
|
||||
TEACHER_NO_TEAM: 'TEACHER_NO_TEAM',
|
||||
TEACHER_NO_NAME: 'TEACHER_NO_NAME',
|
||||
TEACHER_NO_GROUP: 'TEACHER_NO_GROUP',
|
||||
BLANK_ROW: 'BLANK_ROW',
|
||||
};
|
||||
|
||||
/**
|
||||
* 去掉所有空白字符（含全角空格、不换行空格、零宽字符）。
|
||||
* ⛔ 不能只 trim：上游表格里「指导 教师」「指导教师」混用很常见，
|
||||
* 只 trim 会把前者判成非教师身份而整行丢掉。
|
||||
*/
|
||||
function squash(v) {
|
||||
if (v === null || v === undefined) return '';
|
||||
return String(v)
|
||||
.replace(/[\u3000\u00a0\u200b\u200c\u200d\ufeff]/g, '')
|
||||
.replace(/\s+/g, '');
|
||||
}
|
||||
|
||||
/** 组别归一；无法识别时返回空串（调用方据此判定"组别缺失"） */
|
||||
function normalizeGroup(v) {
|
||||
const s = squash(v);
|
||||
if (!s) return '';
|
||||
return TEACHER_GROUP_ALIAS[s] || TEACHER_GROUP_ALIAS[s.toLowerCase()] || '';
|
||||
}
|
||||
|
||||
/** 是否教师身份。归一化后精确命中白名单才算，⛔ 不做包含匹配（避免「非指导教师」被误判） */
|
||||
function isTeacherIdentity(v) {
|
||||
const s = squash(v);
|
||||
if (!s) return false;
|
||||
return TEACHER_IDENTITIES.indexOf(s) >= 0;
|
||||
}
|
||||
|
||||
/** 队伍编号归一：只 trim 首尾空白与零宽字符，⛔ 不折叠大小写（编号大小写不敏感会串组） */
|
||||
function normalizeTeamId(v) {
|
||||
if (v === null || v === undefined) return '';
|
||||
return String(v).replace(/[\u200b\u200c\u200d\ufeff]/g, '').replace(/^[\s\u3000\u00a0]+|[\s\u3000\u00a0]+$/g, '');
|
||||
}
|
||||
|
||||
/** 在给定行里按别名找列下标，返回 -1 表示未命中 */
|
||||
function findColumn(row, aliases) {
|
||||
if (!Array.isArray(row)) return -1;
|
||||
for (let i = 0; i < row.length; i++) {
|
||||
const cell = squash(row[i]);
|
||||
if (!cell) continue;
|
||||
for (const a of aliases) {
|
||||
if (cell === squash(a)) return i;
|
||||
}
|
||||
}
|
||||
return -1;
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析报名表 AOA，提取「小组 → 指导教师姓名列表」。
|
||||
*
|
||||
* @param {Array<Array>} aoa 二维数组（xlsx sheet_to_json header:1 的产物）
|
||||
* @param {Object} [opts]
|
||||
* @param {number} [opts.maxHeaderScan=10] 表头最多向下扫描的行数
|
||||
* @returns {{
|
||||
* ok: boolean, code: string, message: string,
|
||||
* teams: Array<{group: string, teamId: string, names: string[], rowNumbers: number[]}>,
|
||||
* stats: Object, errors: Array<Object>
|
||||
* }}
|
||||
*/
|
||||
function extractTeachers(aoa, opts) {
|
||||
const maxHeaderScan = (opts && opts.maxHeaderScan) || 10;
|
||||
const empty = { teams: [], stats: { rows: 0, teachers: 0, notTeachers: 0, blank: 0 }, errors: [] };
|
||||
|
||||
if (!Array.isArray(aoa) || aoa.length === 0) {
|
||||
return Object.assign({ ok: false, code: 'EMPTY_FILE', message: '文件内容为空' }, empty);
|
||||
}
|
||||
|
||||
// ---- 1) 定位表头 ----
|
||||
let headerRowIdx = -1;
|
||||
let colName = -1;
|
||||
let colTeam = -1;
|
||||
let colGroup = -1;
|
||||
let colIdentity = -1;
|
||||
for (let i = 0; i < Math.min(aoa.length, maxHeaderScan); i++) {
|
||||
const r = aoa[i];
|
||||
const cn = findColumn(r, TEACHER_COLUMN_ALIAS.name);
|
||||
const ci = findColumn(r, TEACHER_COLUMN_ALIAS.identity);
|
||||
if (cn >= 0 && ci >= 0) {
|
||||
headerRowIdx = i;
|
||||
colName = cn;
|
||||
colIdentity = ci;
|
||||
colTeam = findColumn(r, TEACHER_COLUMN_ALIAS.teamId);
|
||||
colGroup = findColumn(r, TEACHER_COLUMN_ALIAS.group);
|
||||
break;
|
||||
}
|
||||
}
|
||||
if (headerRowIdx < 0) {
|
||||
return Object.assign({
|
||||
ok: false,
|
||||
code: 'HEADER_NOT_FOUND',
|
||||
message: '前 10 行内没有同时包含「姓名」与「身份」的表头，请确认上传的是报名表',
|
||||
}, empty);
|
||||
}
|
||||
if (colTeam < 0) {
|
||||
return Object.assign({
|
||||
ok: false,
|
||||
code: 'TEAM_COLUMN_MISSING',
|
||||
message: '报名表缺少「队伍编号」列，无法把指导教师归到具体小组',
|
||||
}, empty);
|
||||
}
|
||||
if (colGroup < 0) {
|
||||
return Object.assign({
|
||||
ok: false,
|
||||
code: 'GROUP_COLUMN_MISSING',
|
||||
message: '报名表缺少「组别」列，无法限定同组（team_uid 跨组重号，不能只按编号归并）',
|
||||
}, empty);
|
||||
}
|
||||
|
||||
// ---- 2) 逐行收集 ----
|
||||
const stats = { rows: 0, teachers: 0, notTeachers: 0, blank: 0 };
|
||||
const errors = [];
|
||||
// key = group + '\u0000' + teamId，用不可见分隔符避免与编号里的字符冲突
|
||||
const bucket = new Map();
|
||||
|
||||
for (let i = headerRowIdx + 1; i < aoa.length; i++) {
|
||||
const r = aoa[i] || [];
|
||||
stats.rows++;
|
||||
const rowNumber = i + 1; // 1 基，与 Excel 行号一致
|
||||
|
||||
const nameRaw = colName >= 0 ? r[colName] : '';
|
||||
const identityRaw = colIdentity >= 0 ? r[colIdentity] : '';
|
||||
const allBlank = r.every(c => squash(c) === '');
|
||||
if (allBlank) {
|
||||
stats.blank++;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (!isTeacherIdentity(identityRaw)) {
|
||||
stats.notTeachers++;
|
||||
continue;
|
||||
}
|
||||
|
||||
const name = String(nameRaw === null || nameRaw === undefined ? '' : nameRaw).trim();
|
||||
if (!name) {
|
||||
stats.teachers++;
|
||||
errors.push({ row: rowNumber, status: ROW_STATUS.TEACHER_NO_NAME, message: '身份为导师但姓名为空，已跳过' });
|
||||
continue;
|
||||
}
|
||||
const group = normalizeGroup(colGroup >= 0 ? r[colGroup] : '');
|
||||
if (!group) {
|
||||
stats.teachers++;
|
||||
errors.push({
|
||||
row: rowNumber,
|
||||
status: ROW_STATUS.TEACHER_NO_GROUP,
|
||||
message: `指导教师「${name}」所在行组别为空或无法识别，已跳过（缺少 group 无法安全归组）`,
|
||||
});
|
||||
continue;
|
||||
}
|
||||
const teamId = normalizeTeamId(colTeam >= 0 ? r[colTeam] : '');
|
||||
if (!teamId) {
|
||||
stats.teachers++;
|
||||
errors.push({
|
||||
row: rowNumber,
|
||||
status: ROW_STATUS.TEACHER_NO_TEAM,
|
||||
message: `指导教师「${name}」所在行队伍编号为空，已跳过（无法定位到具体小组）`,
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
stats.teachers++;
|
||||
const key = `${group}\u0000${teamId}`;
|
||||
let item = bucket.get(key);
|
||||
if (!item) {
|
||||
item = { group, teamId, names: [], rowNumbers: [] };
|
||||
bucket.set(key, item);
|
||||
}
|
||||
if (item.names.indexOf(name) < 0) item.names.push(name);
|
||||
item.rowNumbers.push(rowNumber);
|
||||
}
|
||||
|
||||
const teams = Array.from(bucket.values());
|
||||
|
||||
if (teams.length === 0) {
|
||||
return Object.assign({
|
||||
ok: false,
|
||||
code: 'NO_TEACHER_FOUND',
|
||||
message: stats.teachers === 0
|
||||
? '报名表里没有身份为「指导教师」的行（请确认「身份」列的写法）'
|
||||
: '识别到指导教师行，但都缺少组别或队伍编号，无法归组',
|
||||
}, { stats, errors });
|
||||
}
|
||||
|
||||
return Object.assign({ ok: true, code: 'OK', message: `识别到 ${teams.length} 个小组的指导教师` }, { teams, stats, errors });
|
||||
}
|
||||
|
||||
/**
|
||||
* 把同一小组的多个指导教师姓名合成一个展示串。
|
||||
* ⛔ 去重保序：报名表里同一教师可能重复出现（同一人被登记两次），
|
||||
* 直接 join 会得到「张三、张三」。
|
||||
*/
|
||||
function joinNames(names) {
|
||||
if (!Array.isArray(names)) return '';
|
||||
const seen = new Set();
|
||||
const out = [];
|
||||
for (const n of names) {
|
||||
const s = String(n === null || n === undefined ? '' : n).trim();
|
||||
if (!s || seen.has(s)) continue;
|
||||
seen.add(s);
|
||||
out.push(s);
|
||||
}
|
||||
return out.join('、');
|
||||
}
|
||||
|
||||
/** 1 基数组是报名表原始行号，直接透出（调用方拼提示用） */
|
||||
function formatRowNumbers(nums) {
|
||||
if (!Array.isArray(nums) || nums.length === 0) return '';
|
||||
return nums.join('、');
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
TEACHER_IDENTITIES,
|
||||
TEACHER_GROUP_ALIAS,
|
||||
TEACHER_COLUMN_ALIAS,
|
||||
ROW_STATUS,
|
||||
squash,
|
||||
normalizeGroup,
|
||||
normalizeTeamId,
|
||||
isTeacherIdentity,
|
||||
findColumn,
|
||||
extractTeachers,
|
||||
joinNames,
|
||||
formatRowNumbers,
|
||||
};
|
||||
Reference in New Issue
Block a user