测评平台（三）：批量保存、草稿试答与可追溯发布

mumu — Sat, 11 Jul 2026 00:00:00 +0000

系列导航：5 | 6 | 7

配置后台需要允许半成品存在。题目编辑、评分配置和报告模板通常分几次完成，保存过程还会遇到浏览器刷新和并发修改。预览要尽量接近正式作答，发布后又必须冻结内容。把这几个动作压进一个 status 字段，容易出现草稿进入统计或审核后内容仍被修改。

草稿状态和发布状态分开

草稿版本可以有 editing、ready_for_review、rejected；发布包只有 building、published、retired。试答引用草稿版本，正式任务只引用已发布的 AssessmentRelease。发布状态改变后，原发布包不再接受编辑。

stateDiagram-v2 [*] --> Editing Editing --> Review: 提交审核 Review --> Editing: 驳回修改 Review --> Building: 审核通过 Building --> Published: 快照与校验成功 Building --> Review: 生成失败 Published --> Retired: 新包替换 Published --> Trial: 草稿试答只读发布快照

图中的 Trial 不是发布包状态，它表示运行入口。试答可以使用草稿的 FormDSL，但评分和答案解析仍由服务端完成，避免页面自己解释规则。

批量保存的边界

90 道题的工作台不适合每次输入都提交整份 JSON。前端发送带路径的补丁：题目标识、字段路径、客户端序号和内容摘要。服务端校验路径属于当前草稿版本，再按版本号合并。两个窗口同时编辑时，后到的旧版本返回冲突，调用方选择重新加载或覆盖，不能静默丢失另一方修改。

批量保存接口返回服务端版本、已接受项和拒绝项。部分成功时，页面逐项显示错误，不能把整个请求显示为“保存失败”后让用户猜测哪些题已经写入。服务端保存时限制数组深度、字符串长度和单次补丁数量，防止一条请求耗尽解析资源。

草稿复制使用新版本 ID，复制源、操作人和时间进入审计。发布包不能通过改数据库指针“变成”另一个版本，所有关系用显式外键和状态校验保护。

预览和正式作答共用解析器

试答页面调用和正式作答相同的 FormDSL 校验、可见性计算和 FrozenFormAnswerResolver。NUMBER 类型从 numberValue 解析，不能从展示字符串 rawValue 评分。试答结果标记为临时，不写入正式参与者报告和统计。

预览数据使用合成参与者 ID，提交令牌只在开发或测试范围有效。服务端返回给浏览器的快照递归移除 score、scoreRangeJson、标准答案和其他评分字段，键名大小写变化也要过滤。清理逻辑不能只处理顶层对象，否则嵌套报告规则会泄漏。

发布是一个事务边界

发布请求先确认草稿版本仍是审核通过状态，再编译 FormDSL、检查引用、写入题目快照和报告配置，计算 checksum，末步插入 AssessmentRelease。事务提交前，运行入口看不到这条发布记录。发布完成后，运行入口只接受 release_id，不接受前端传来的任意版本号。

工程正确性（四）：构建成功不等于交付物可用

mumu — Sat, 11 Jul 2026 00:00:00 +0000

系列导航：11 | 12 | 13 | 14

编译器显示成功，只能证明源码在当前环境生成了产物。用户安装的是 JAR、npm 包或容器，真正的验收对象是这些文件能否被目标运行时加载，Native 资源是否随包分发，文档示例是否使用了正确入口。发布链路如果只跑单元测试，问题会在上传后才出现。

GMKit 的发布整理说明了这条边界：Java 的 gmkit-sm9 需要把多平台 Native 运行时装入同一个 JAR，TypeScript 包还要检查 tarball 内容和生产依赖。源码测试通过并不能证明打出来的包包含这些资源。

flowchart TD subgraph Build[源码验证与构建] direction LR Source[源码与向量] --> Verify[测试与 parity] --> Package[构建制品] end subgraph Audit[制品审计] direction LR Inspect[包内容与 checksum] --> Install[干净环境安装] --> Smoke[运行时 smoke] end subgraph Release[发布] direction LR Publish[发布仓库] end Package --> Inspect Smoke --> Publish Inspect -->|缺资源或多余文件| Reject[阻断发布]

先确定交付清单

Java 发布清单写明 group、artifact、版本、依赖、服务文件和 Native 路径。gmkit-sm9 的 JAR 中应有 META-INF/gmkit/sm9-native.properties、各平台运行时和摘要文件，加载逻辑按当前平台选择资源并校验 checksum。Native 库缺失时启动要给出明确错误，不能回退到一个“未实现但返回成功”的空实现。