Prune obsolete docs and update navigation

docs/technical/M7_TEST_DEPLOY_CUTOVER_EXECUTION_PLAN_2026-04-22.md

@@ -11,7 +11,7 @@ M7 的目标不是新增玩法功能，而是在 `M0 ~ M6` 已迁移的 Rust 后
 1. 固定本地、灰度、切流前的检查命令。
 2. 固定 `Axum + SpacetimeDB + OSS` 的部署与回滚口径。
 3. 固定观测字段、慢请求、上游失败日志与资产任务日志。
-4. 固定旧 `server-node` 与新 `server-rs` 的双跑和 API 对比方式。
+4. 固定旧 `server-node` 删除后的 Rust 主线回归与部署验证方式。
 5. 等价拆分 `server-rs/crates/spacetime-module/src/lib.rs`，避免 SpacetimeDB 主工程继续退化为单大文件。
 
 ## 2. 执行约束
@@ -19,8 +19,8 @@ M7 的目标不是新增玩法功能，而是在 `M0 ~ M6` 已迁移的 Rust 后
 1. 不改变现有 HTTP contract、SSE contract、SpacetimeDB 表名、reducer 名、procedure 名和对象键前缀。
 2. 不把 LLM、OSS、短信、微信等外部副作用移入 SpacetimeDB reducer。
 3. `spacetime-module` 拆分只做物理结构收口，不做 schema 重命名、字段删除、字段重排或 reducer/procedure 改名。
-4. 迁移期保留 `server-node` 作为回退锚点，M7 不删除旧后端。
-5. 前端切换默认仍指向 Node；只有显式设置 `GENARRATIVE_BACKEND_STACK=rust` 或 `GENARRATIVE_RUNTIME_SERVER_TARGET` 时才切到 Rust。
+4. `server-node/` 已进入物理删除流程，M7 不再把旧 Node 后端作为运行时回退锚点。
+5. 前端默认指向 Rust `api-server`；如需临时覆盖目标，只允许使用 `RUST_SERVER_TARGET` 或 `GENARRATIVE_RUNTIME_SERVER_TARGET` 指向 Rust 兼容服务。
 
 ## 3. 测试体系
 
@@ -36,7 +36,6 @@ M7 固定四层测试入口：
 ```powershell
 .\server-rs\scripts\m7-preflight.ps1
 .\server-rs\scripts\smoke.ps1
-node scripts\run-tsx.cjs scripts\m7-api-compare.ts
 ```
 
 ## 4. 部署准备
@@ -72,32 +71,32 @@ OSS / CDN / 域名方案：
 6. `DASHSCOPE_BASE_URL`、`DASHSCOPE_API_KEY`
 7. `SMS_AUTH_ENABLED` 与短信供应商变量
 8. `WECHAT_AUTH_ENABLED` 与微信 OAuth 变量
-9. `GENARRATIVE_BACKEND_STACK`、`NODE_SERVER_TARGET`、`RUST_SERVER_TARGET`、`GENARRATIVE_RUNTIME_SERVER_TARGET`
+9. `RUST_SERVER_TARGET`、`GENARRATIVE_RUNTIME_SERVER_TARGET`
 
 ## 5. 灰度与切流
 
 灰度环境固定为三段：
 
-1. `shadow`：Node 继续承接用户流量，Rust 只由脚本和内部账号请求。
-2. `dual-run`：同一组 smoke/API compare 同时打 Node 与 Rust，差异必须登记。
-3. `rust-primary`：反向代理或 Vite dev proxy 指向 Rust，Node 进程保留但不作为主入口。
+1. `preflight`：只跑 Rust 预检、smoke 与人工主链验证，不接正式用户流量。
+2. `limited-rust`：小范围账号或灰度域名访问 Rust `api-server`，差异必须登记到 M7 验收记录。
+3. `rust-primary`：反向代理或 Vite dev proxy 指向 Rust `api-server`，旧 Node 后端不作为运行时入口保留。
 
 前端切换方式：
 
-1. 默认 `GENARRATIVE_BACKEND_STACK=node`。
-2. 本地或灰度切 Rust 设置 `GENARRATIVE_BACKEND_STACK=rust`，并配置 `RUST_SERVER_TARGET`。
-3. 紧急回退设置 `GENARRATIVE_BACKEND_STACK=node` 或直接覆盖 `GENARRATIVE_RUNTIME_SERVER_TARGET` 指回 Node。
+1. 默认使用 `RUST_SERVER_TARGET` 或 `GENARRATIVE_API_TARGET` 指向 Rust `api-server`。
+2. 本地或灰度可覆盖 `GENARRATIVE_RUNTIME_SERVER_TARGET`，但目标仍必须是 Rust 兼容服务。
+3. 紧急回退优先回滚到上一个 Rust 发布包或反向代理配置，不恢复 `server-node/` 工程目录。
 
-## 6. API 对比
+## 6. API 回归
 
-`scripts/m7-api-compare.ts` 负责对比 Node 与 Rust 的基础 contract：
+第一批删除后不再保留 Node/Rust 对比脚本，M7 回归改为 Rust 主线 contract 验证：
 
-1. 默认对比 `/healthz` 与 `/api/auth/login-options`。
-2. 可通过 `M7_COMPARE_PATHS` 扩展只读路径清单。
-3. 对比时会固定传入 `x-request-id`，并归一化 `requestId / timestamp / latencyMs` 等波动字段。
-4. 默认严格模式下发现差异直接返回非零退出码。
+1. `server-rs/scripts/m7-preflight.ps1` 覆盖 Rust 工作区构建、测试与关键脚本门禁。
+2. `server-rs/scripts/smoke.ps1` 覆盖 `/healthz`、envelope 与 request id 基础 contract。
+3. `server-rs/scripts/oss-smoke.ps1` 覆盖真实 OSS 链路。
+4. 新增只读 contract 时优先补进 Rust 侧 smoke 或 handler 测试，不恢复 Node 对比脚本。
 
-该脚本只承担“无状态 GET contract”对比；带登录、写入、OSS 或 SSE 的主流程仍由专门 smoke 脚本负责。
+带登录、写入、OSS 或 SSE 的主流程仍由专门 smoke、handler 测试和人工验证清单负责。
 
 ## 7. 观测能力
 
@@ -113,10 +112,10 @@ M7 观测字段固定为：
 
 ## 8. 数据迁移与回滚
 
-当前 M7 不做一次性“Node PostgreSQL 全量导入 SpacetimeDB”的危险迁移，采用双跑验证与按主链确认的渐进策略：
+当前 M7 不做一次性历史数据导入 SpacetimeDB 的危险迁移，采用按主链确认的渐进策略：
 
 1. 已迁移主链以 SpacetimeDB 为真相源。
-2. 未迁移或灰度失败主链继续回退到 Node。
+2. 未迁移或灰度失败主链必须继续迁入 Rust 主线后再开放，不回退到旧 Node 工程。
 3. 资产二进制以 OSS 为真相，不回滚到本地 `public/generated-*` 写盘。
 4. 若 SpacetimeDB schema 需要清库重发，只允许在开发库或明确灰度库执行 `--clear-database`。
 5. 生产回滚优先切反向代理目标，不优先改代码。
@@ -128,6 +127,6 @@ M7 完成时必须满足：
 1. M7 文档、脚本、任务清单均同步。
 2. `api-server` 和 `spacetime-module` 至少通过 `cargo check`。
 3. 基础 smoke 脚本可执行，并覆盖 `healthz + envelope + request id`。
-4. Node/Rust API 对比脚本可执行。
-5. Vite dev proxy 已具备 Node/Rust 切换与回退开关。
+4. Rust 主线预检和 smoke 脚本可执行。
+5. Vite dev proxy 默认指向 Rust `api-server`，仅保留 Rust 目标覆盖开关。
 6. `spacetime-module` 已从单 `lib.rs` 拆为按 `runtime / gameplay / custom_world / asset_metadata / ai` 组织的文件结构。