feat(切换): 支持并行试跑，新站先挂 oj2.xuyue.cc 跑几天

设计文档写的是「不双跑不灰度」，这次改主意了。理由：「只换前后端」形态下新栈
本来就不碰数据库进程，双跑的增量风险只剩「两个后端同时写同一个库」这一条；
换来的是**正式切换退化成改一行 NPM 上游**，比停机切换更稳，回滚也不用停任何容器。

## 两个新变量

    WEB_PORT          对外端口。8080 还被旧 backend 占着（机房是 81）
    JUDGE_STATE_DIR   判题机运行状态目录

JUDGE_STATE_DIR 是必须的：不设的话新旧两个 judger 会同时往
`data/judge_server/{run,log}` 里写。默认值用嵌套写法跟着 DATA_DIR 走
（`${JUDGE_STATE_DIR:-${DATA_DIR:-../data}/judge_server}`，compose 支持嵌套默认值，
试过），所以一次性切换那条路径完全不受影响。

test_case 和 public/upload 仍然共享 —— 那是故意的，测试点和题面图片两边必须
看到同一份。

## 手册

新增第四节「并行试跑」，后面章节顺移（原四~九 → 五~十），两处交叉引用一并改了。
第五节拆成两条路径：试跑过的只需改 NPM 上游 + 事后停旧栈；没试跑的走原来那套。
第七节回滚同理。

试跑那节写明了三件容易踩的：NPM 的 Websockets Support 必须打开（漏了的话页面
一切正常，唯独「判题中…」永远不动，而刷新一下结果就出来，自测很难发现）、
两边登录态不互通、以及双写的是真实数据不是沙盒（别在 oj2 上办正式比赛）。

## 验证

试跑形态 `config` 解析：判题机目录落到 judge_server_oj2、端口 8090、test_case
仍指向共享的那份；不设新变量时默认值一个没变（judge_server / 8080）。
四份 compose `config -q` 全通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docker/.env.example

@@ -47,6 +47,25 @@ DB_PORT=
 REDIS_HOST=
 REDIS_PORT=
 
+# --- 并行试跑（oj2.xuyue.cc）才需要 ---
+#
+# 新站和旧站同时跑的时候，这两个必须设，否则会跟旧栈抢资源。
+#
+# 对外端口。旧 backend 占着 8080（机房 81），新栈换一个，NPM 那边把
+# oj2.xuyue.cc 指到这个端口。**NPM 的记录要打开 Websockets Support**，
+# 否则学生那边「判题中…」永远不动。
+WEB_PORT=
+
+# 判题机的运行状态目录。不设的话是 `$DATA_DIR/judge_server`，和旧判题机同一份 ——
+# 试跑期间两个 judger 都在跑，必须分开，例如：
+#
+#   JUDGE_STATE_DIR=/root/OJDeploy/data/judge_server_oj2
+#
+# 建完记得 `mkdir -p .../{log,run}`。
+# `test_case` 和 `public/upload` 仍然共享，那是**故意的** —— 测试点和题面图片
+# 两边必须看到同一份。
+JUDGE_STATE_DIR=
+
 # --- 只有机房那套需要 ---
 # 机房走 http 直连 IP，没有 TLS，必须 false，否则 Cookie 发不回来。
 COOKIE_SECURE=false

docker/compose.debian.yml

@@ -22,6 +22,10 @@
 #
 # 后者要在 env 里设 `DB_HOST` / `REDIS_HOST` / `DATA_DIR`，见 `.env.example` 末尾。
 #
+# **并行试跑**（新站挂在 oj2.xuyue.cc、旧站原样不动）是「只换前后端」再加两个变量：
+# `WEB_PORT`（8080 被旧 backend 占着）和 `JUDGE_STATE_DIR`（两个判题机不能共用运行目录）。
+# 这种形态下旧栈一个容器都不用停。见手册第四节。
+#
 # ⚠️ `DATA_DIR` 默认值 `../data` 解析出来是 **`OJ2/data`**，不是部署目录的 `data/`。
 # 旧栈用的是 `<部署目录>/data/`，两者不是一个地方 —— 直接用默认值切过去，postgres 会在
 # 空目录上初始化一个全新的空库，测试点和题面图片也全都不在。**用旧数据就必须设 `DATA_DIR`。**
@@ -83,8 +87,11 @@ services:
       - /tmp
     volumes:
       - ${DATA_DIR:-../data}/backend/test_case:/test_case:ro
-      - ${DATA_DIR:-../data}/judge_server/log:/log
-      - ${DATA_DIR:-../data}/judge_server/run:/judger
+      # 判题机的运行状态目录。默认跟着 DATA_DIR 走，和旧栈是同一份 ——
+      # 一次性切换时无所谓（旧判题机已经停了），但**并行试跑时必须单独设 JUDGE_STATE_DIR**，
+      # 否则新旧两个 judger 同时往一个 run/log 目录里写。
+      - ${JUDGE_STATE_DIR:-${DATA_DIR:-../data}/judge_server}/log:/log
+      - ${JUDGE_STATE_DIR:-${DATA_DIR:-../data}/judge_server}/run:/judger
     environment:
       SERVICE_URL: http://oj-judge:8080
       # 心跳路径跟着新后端改了：judge_server_heartbeat/ → judge-server/heartbeat
@@ -164,5 +171,6 @@ services:
       # Caddy 只往这里写访问日志，静态资源在镜像里
       - ${DATA_DIR:-../data}/backend/log:/data/log
     ports:
-      - "0.0.0.0:8080:8000"
+      # 并行试跑（oj2.xuyue.cc）时换一个端口，8080 还被旧 backend 占着。
+      - "0.0.0.0:${WEB_PORT:-8080}:8000"
     mem_limit: 256m

docker/compose.school.yml

@@ -44,8 +44,9 @@ services:
       - /tmp
     volumes:
       - ${DATA_DIR:-../data}/backend/test_case:/test_case:ro
-      - ${DATA_DIR:-../data}/judge_server/log:/log
-      - ${DATA_DIR:-../data}/judge_server/run:/judger
+      # 并行试跑时必须单独设 JUDGE_STATE_DIR，否则新旧两个 judger 共用一个运行目录
+      - ${JUDGE_STATE_DIR:-${DATA_DIR:-../data}/judge_server}/log:/log
+      - ${JUDGE_STATE_DIR:-${DATA_DIR:-../data}/judge_server}/run:/judger
     environment:
       SERVICE_URL: http://oj-judge:8080
       BACKEND_URL: http://oj-api:3000/api/judge-server/heartbeat
@@ -111,5 +112,6 @@ services:
     volumes:
       - ${DATA_DIR:-../data}/backend/log:/data/log
     ports:
-      - "81:8000"
+      # 并行试跑时换一个端口，81 还被旧 backend 占着
+      - "${WEB_PORT:-81}:8000"
     mem_limit: 256m