chore(阶段0): 端点对账脚本与机器初判清单

KEEP 100 / CUT 16 / REVIEW 6，合计 122。

修复 brief key() 里的归一化 bug：/^\/?api\/(admin\/)?/ 会把后端
admin 端点的 admin/ 前缀也剥掉，但前端 http 客户端共用一个 axios
实例（baseURL: /api），admin 接口路径是前端代码里手写的字面
admin/xxx，不该被剥。未修复时 REVIEW 卡在 40（几乎全是被误判的
admin 端点），修复后降到 6。

REVIEW 里 5 条经核实是提取脚本的已知/新发现盲点（动态变量传路径、
原生 fetch() 调用）导致的假阴性，已在生成的 markdown 里写明提示；
唯一真正需要人工裁决的是 judge_server_heartbeat（判题机而非前端
调用的接口）。

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

docs/spikes/reconcile.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env bun
+// 对账后端端点全集与前端调用全集，产出三态清单
+type Endpoint = { app: string; side: "oj" | "admin"; pattern: string; view: string; name: string; deprecated: boolean }
+type Call = { file: string; fn: string; method: string; path: string }
+
+const backend: Endpoint[] = await Bun.file("endpoints-backend.json").json()
+const frontend: Call[] = await Bun.file("endpoints-frontend.json").json()
+
+// 归一化到可比 key：去掉 /api 前缀、占位符统一成 :param、去掉首尾斜杠、转小写
+//
+// 注意：只能去掉 /api 前缀，不能连带去掉 admin/ 段。
+// 前端所有 http 调用共用同一个 axios 实例（baseURL: "/api"，见 ojnext/src/utils/http.ts），
+// admin 接口是前端代码里手写的字面路径，例如 http.get("admin/dashboard_info")——
+// 也就是说前端 path 里的 "admin/" 是真实存在的一段，不是像 "/api" 那样的传输层前缀。
+// 后端 pattern 是 "/api/admin/dashboard_info"，去掉 "/api/" 之后应该保留 "admin/dashboard_info"
+// 才能跟前端对上；如果连 "admin/" 也一并剥掉（brief 原稿的 `(admin\/)?` 分组），
+// 后端 key 变成 "dashboard_info"，前端 key 仍是 "admin/dashboard_info"，永远对不上——
+// 会把所有本该 KEEP 的 admin 端点错判成 REVIEW。
+function key(s: string): string {
+  return s
+    .replace(/^\/?api\//, "")
+    .replace(/<[^>]*>/g, ":param")
+    .replace(/^\/+|\/+$/g, "")
+    .toLowerCase()
+}
+
+const feKeys = new Set(frontend.map((c) => key(c.path)))
+
+type Verdict = "KEEP" | "CUT" | "REVIEW"
+const rows = backend.map((e) => {
+  const k = key(e.pattern)
+  const called = feKeys.has(k)
+  let verdict: Verdict
+  if (called && !e.deprecated) verdict = "KEEP"
+  else if (!called && e.deprecated) verdict = "CUT"
+  else verdict = "REVIEW" // 标了 DEPRECATED 却有人调，或没标却没人调 —— 两种都要人看
+  return { ...e, key: k, called, verdict }
+})
+
+const count = (v: Verdict) => rows.filter((r) => r.verdict === v).length
+console.log(`KEEP ${count("KEEP")} / CUT ${count("CUT")} / REVIEW ${count("REVIEW")}  合计 ${rows.length}`)
+
+const md = [
+  "# 端点清单（机器初判）",
+  "",
+  `生成时间：${new Date().toISOString().slice(0, 10)}`,
+  `合计 ${rows.length} 个端点 —— KEEP ${count("KEEP")}、CUT ${count("CUT")}、REVIEW ${count("REVIEW")}`,
+  "",
+  "> REVIEW 项需人工裁决，裁决后把本行的 REVIEW 改成 KEEP 或 CUT，并在末列写明理由。",
+  "",
+  "> 已知盲点 1：`ojnext/src/oj/api.ts` 第 45、73 行用变量动态传路径（形如 `http.get(endpoint)`），提取脚本的正则匹配不到这类调用。因此对应的后端端点会被本表判成“前端无调用”，但实际可能仍在使用 —— 例如 `/api/contest_submissions`（`getSubmissions` 里 `endpoint` 变量的另一分支）。",
+  "",
+  "> 已知盲点 2：`ojnext` 里有 4 处用原生 `fetch(\"/api/...\")` 而非 `http.get/post(...)` 发起请求（AI 流式响应场景：`src/oj/store/ai.ts`、`src/oj/problem/components/SubmissionResult.vue`、`src/oj/rank/list.vue`、`src/oj/class/pk.vue`），提取脚本只认 `get/post/put/delete(...)` 调用形式，完全抓不到 `fetch(...)`。本轮 REVIEW 里的 `/api/ai/analysis`、`/api/ai/hint`、`/api/ai/class_pk`、`/api/ai/class_single` 经人工核实均属此类，实际都在用。",
+  "",
+  "> 上述两类盲点都是“前端有调用=否”但实际有调用，人工裁决时不要仅凭本表这一列就判 CUT；REVIEW 里唯一不属于此类的是 `/api/judge_server_heartbeat/`——它是判题机而非前端调用的接口，不受提取脚本盲点影响，是否保留需按后端间调用来判断。",
+  "",
+  "| 裁决 | app | 侧 | 路径 | 视图 | 前端有调用 | 已标 DEPRECATED | 理由 |",
+  "|---|---|---|---|---|---|---|---|",
+  ...rows
+    .sort((a, b) => a.verdict.localeCompare(b.verdict) || a.app.localeCompare(b.app))
+    .map((r) => `| ${r.verdict} | ${r.app} | ${r.side} | \`${r.pattern}\` | ${r.view} | ${r.called ? "是" : "否"} | ${r.deprecated ? "是" : "否"} | |`),
+  "",
+].join("\n")
+
+await Bun.write("../specs/endpoint-inventory.md", md)
+console.log("→ docs/specs/endpoint-inventory.md")