存储与评测包交付

文档状态：部署运维方案尚未成熟

本分区文档描述的是开发期部署与运维方式（手动分步启动、开发期脚本），尚未提供面向生产的一键部署方案——当前不具备守护进程管理、TLS、备份、升级等生产级能力，生产部署请谨慎参考。项目后续将提供成熟的一键部署方式，届时本文档将整体更新。

Neuro OJ 使用两层 URL 区分持久存储和评测交付。

存储层 URL

noj-storage:// 表示资源在存储后端中的位置，会写入数据库。

本地模式示例：

noj-storage://local/<base64>?checksum_sha256=...

S3 模式示例：

noj-storage://s3/<key>?checksum_sha256=...

评测交付 URL

noj-download:// 表示 Judge Worker 如何获取纯净评测包内容，会放入评测任务。

本地或内联交付示例：

noj-download://base64/?content=<base64>&checksum_sha256=...

S3 交付示例：

noj-download://s3?url=<encoded-presigned-url>&checksum_sha256=...

为什么要分两层

数据库只需要知道资源归属和校验和；Judge Worker 需要知道当前这次任务如何下载纯净评测包。把两者分开后，同一个数据库记录可以在 local、S3 或其他存储后端之间切换交付方式。

评测包生命周期

正式题目的默认生命周期：

1. 出题人在 Web 界面创建或编辑题目。
2. 出题人上传统一题目包 zip（含 problem.json/evaluate.py；旧式松散支持包上传已废弃）。
3. noj-core 校验并剥离元数据，通过 StorageProvider 注册纯净评测包为 noj-storage:// URL。
4. noj-core 创建评测任务时把存储 URL 转换为 Judge Worker 可下载的 noj-download:// URL。
5. noj-judge 下载、校验并缓存纯净评测包，再注入 Evaluator 容器执行评测。

内置样例题的开发生命周期：

1. 维护者把样例题源文件放在 noj-core/data/problems-src/<id>/。
2. 维护者运行 deno task problems:build 生成 noj-core/data/packages/<id>.zip。
3. 维护者运行 deno task problems:import（或 deno task dev-setup）导入统一题目包， 由 noj-core 剥离元数据并把纯净评测包注册到 StorageProvider。

样例题流程用于开发和测试，不是正式出题发布路径。