fix(一言): 接回真数据集,之前线上返回的是三条硬编码

/quotes/random 在阶段 3 基线里只铺了个桩(三条写死的句子),读盘逻辑没移植,
所以 oj2.xuyue.cc 上一直是假数据——和 DATA_DIR 无关,哪儿部署都一样。

数据本来就在服务器上、位置也已经对上:旧栈挂 ./data/backend:/data,Django 的
HITOKOTO_DIR 就是它下面的 hitokoto/;OJ2 的 api 挂的是同一个目录。所以
Dockerfile 里跟着 TEST_CASE_DIRECTORY 写死 /data/hitokoto 即可,不用搬文件。

按分类懒加载并常驻,但只留前端用得上的 hitokoto/from 两个字段:原样缓存
7160 条要 2.5MB,裁完 1.4MB,而 api 容器只有 512m。读不到数据集时回落到
内置三条,不影响启动(本机 dev 默认就走这条)。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-16 10:20:00 -06:00
parent 36e4ac2f78
commit 604857b25e
4 changed files with 64 additions and 6 deletions

View File

@@ -1,8 +1,20 @@
# CLAUDE.md
OJ2 是判题狗Online Judge的后端重写Django 6 → Bun + TypeScript前后端同仓。
上一代在 `../OnlineJudge/`Django`../ojnext/`Vue SPA**两者都已冻结
是回滚路径,任何情况下都不要改。**
上一代在 `../OnlineJudge/`Django`../ojnext/`Vue SPA**两者都是回滚路径
默认冻结。**
冻结的目的是「回滚那天旧站能原样起来、和新站看到同一份数据」,不是「一个字节都不许动」。
所以红线是**外部可观测的东西**
- **不许动**:接口路径与响应结构、数据库 schema、磁盘上的数据布局、密码哈希格式、
依赖版本。这些一动,回滚就不再是「把上游切回去」那么简单。
- **可以动**:纯内部实现的小修(缓存放哪、日志、注释),前提是签名、异常、
返回结构逐一对齐不变,且 `uv run ruff check` 通过。改完在 commit message 里
写清楚为什么值得破例。
已发生的破例:`utils/cache.py``JsonDataLoader` 把一言数据集塞 Redis每次请求
都要把 323KB 的 pickle 拉过网络再反序列化,改成了进程内缓存。响应结构没动。
设计文档:`docs/specs/2026-08-06-bun-backend-rewrite-design.md`
切换手册:`docs/specs/phase5-cutover-runbook.md` ← 上线当天照这份走