实现考试归档并永久锁定成绩流程

tests/system.test.mjs

@@ -83,6 +83,8 @@ try {
   assert.doesNotMatch(appSource, /onclick=["']event\.stopPropagation\(\)/, '弹窗不得截断内部按钮的委托点击事件');
   assert.match(appSource, /data-modal-backdrop/, '弹窗应仅在点击背景层本身时关闭');
   assert.match(appSource, /data-action="edit-exam"/, '考试草稿应提供编辑入口');
+  assert.match(appSource, /data-action="archive-exam"/, '超级管理员界面应提供不可逆考试归档入口');
+  assert.match(appSource, /归档不可撤销/, '归档前应明确提示成绩将永久锁定');
 
   const { DatabaseSync } = await import('node:sqlite');
   const inspector = new DatabaseSync(testDb, { readOnly: true });
@@ -92,14 +94,18 @@ try {
     ORDER BY name
   `).all().map(row => row.name);
   const schemaVersion = inspector.prepare('SELECT schema_version FROM schema_metadata WHERE id = 1').get().schema_version;
+  const resultLockTriggers = inspector.prepare("SELECT name FROM sqlite_master WHERE type = 'trigger' AND name LIKE 'trg_results_lock_archived_%'").all().map(row => row.name);
   const admitCardColumns = inspector.prepare('PRAGMA table_info(admit_cards)').all().map(row => row.name);
   const admitSubjectColumns = inspector.prepare('PRAGMA table_info(admit_card_subjects)').all().map(row => row.name);
   const examSubjectColumns = inspector.prepare('PRAGMA table_info(exam_subjects)').all().map(row => row.name);
+  const examColumns = inspector.prepare('PRAGMA table_info(exams)').all().map(row => row.name);
   const userColumns = inspector.prepare('PRAGMA table_info(users)').all().map(row => row.name);
   inspector.close();
   assert.deepEqual(tableNames, [...relationalTables].sort(), '业务数据必须按关系模型分表存储');
   assert.ok(!tableNames.includes('app_state'), '不得使用单表 JSON 状态存储');
-  assert.equal(schemaVersion, 13, '账户归档应使用 v13 数据结构');
+  assert.equal(schemaVersion, 14, '考试归档应使用 v14 数据结构');
+  assert.ok(['archived_at', 'archived_by'].every(column => examColumns.includes(column)), '考试应保存不可逆归档时间和超级管理员');
+  assert.equal(resultLockTriggers.length, 3, '数据库应从插入、更新、删除三个方向永久锁定归档成绩');
   assert.ok(['archived_at', 'archived_by'].every(column => userColumns.includes(column)), '账户应保存独立归档状态和校方操作人');
   assert.ok(['center_code', 'center_address'].every(column => admitCardColumns.includes(column)), '准考证应保存考点代码与详细地址快照');
   assert.ok(['building', 'floor'].every(column => admitSubjectColumns.includes(column)), '分科考场应保存楼栋楼层快照');
@@ -616,6 +622,33 @@ try {
   assert.equal(appealedResults.data.results.find(item => item.subjectId === exam.subjects[0].id).score, 128, '考生端应立即看到复议后的语文成绩');
   assert.equal(appealedResults.data.results.find(item => item.subjectId === exam.subjects[2].id).score, 89, '考生端应立即看到复议后的外语成绩');
 
+  assert.equal((await schoolAdmin.request(`/api/admin/exams/${exam.id}/archive`, { method: 'POST' })).response.status, 403, '只有超级管理员可以归档考试');
+  const archivedExam = await admin.request(`/api/admin/exams/${exam.id}/archive`, { method: 'POST' });
+  assert.equal(archivedExam.response.status, 200, '超级管理员应能归档考试');
+  assert.ok(archivedExam.data.exam.archivedAt, '归档应记录不可逆时间戳');
+  assert.equal(archivedExam.data.exam.status, 'closed', '归档考试应退出公开发布状态');
+  assert.equal((await admin.request(`/api/admin/exams/${exam.id}/archive`, { method: 'POST' })).response.status, 409, '归档操作不可重复或撤销');
+  assert.equal((await admin.request(`/api/admin/exams/${exam.id}`, { method: 'PATCH', body: { status: 'published' } })).response.status, 409, '归档后考试配置不得再修改');
+  assert.equal((await admin.request(`/api/admin/exams/${exam.id}/admission-arrangement`, { method: 'POST', body: arrangementBody })).response.status, 409, '归档后不得重新编排准考证');
+  assert.equal((await admin.request('/api/admin/results', { method: 'POST', body: { registrationId, subjectId: exam.subjects[0].id, score: 1, published: true } })).response.status, 409, '归档后手工录入不得修改成绩');
+  const lockInspector = new DatabaseSync(testDb);
+  assert.throws(() => lockInspector.prepare('UPDATE results SET score = 1 WHERE id = ?').run(appealResults[0].id), /永久锁定/, '绕过接口直接写库也不得修改归档成绩');
+  lockInspector.close();
+  const archivedResultFile = Buffer.from(await buildWorkbook('results', [{ candidateNumber, examCode: exam.code, subjectName: exam.subjects[0].name, score: 1, published: '发布' }]));
+  const archivedPreview = await admin.request('/api/admin/excel/results', { method: 'POST', headers: { 'Content-Type': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' }, body: archivedResultFile });
+  assert.equal(archivedPreview.response.status, 200, '归档成绩 Excel 仍应返回逐行预览');
+  assert.match(archivedPreview.data.rows[0].errors.join(''), /永久锁定/, '归档场次的 Excel 行必须标记为不可提交');
+  assert.equal((await admin.request('/api/admin/results/import', { method: 'POST', body: { rows: archivedPreview.data.rows } })).response.status, 400, '归档后 Excel 批量提交不得修改成绩');
+  assert.equal((await candidate.request(`/api/candidate/results/${appealResults[0].id}/appeals`, { method: 'POST', body: { reason: '归档后再次申请复议' } })).response.status, 409, '归档后考生不得再发起成绩复议');
+  const archivedAdminResults = await admin.request('/api/admin/results');
+  assert.ok(archivedAdminResults.data.exams.find(item => item.id === exam.id)?.archivedAt, '管理端成绩中心应返回归档状态');
+  const archivedCandidateResults = await candidate.request('/api/candidate/results');
+  assert.ok(archivedCandidateResults.data.results.filter(item => item.examId === exam.id).every(item => item.archivedAt), '考生历史成绩应标记为归档并进入折叠区');
+  const archivedRegistrations = await candidate.request('/api/candidate/registrations');
+  assert.ok(archivedRegistrations.data.registrations.find(item => item.exam.id === exam.id)?.exam.archivedAt, '报名和准考证信息应同步进入归档折叠区');
+  const homeAfterArchive = await anonymous.request('/api/public/home');
+  assert.ok(!homeAfterArchive.data.exams.some(item => item.id === exam.id), '归档考试不得继续出现在公开考试列表');
+
   const workflowDefinitions = await admin.request('/api/admin/workflows');
   const profileWorkflow = workflowDefinitions.data.workflows.find(item => item.businessType === 'profile_change');
   assert.ok(workflowDefinitions.data.workflows.some(item => item.businessType === 'center_change'), '流程设计应包含考点考场变更审批');