docs: 阶段 0/1/2 出口标准核验 + 阶段 3 覆盖率对账

核验为逐条实跑，不采信文档声称。阶段 0/1/2 出口标准全部通过，
其中阶段 2 判题链路端到端实测（注册→登录→提交→JudgeServer→WS 推送）。

覆盖率对账：oj 侧 65 条已全部实现，admin 侧 45 条一条未做。
新旧路径不同名（API 已重新设计），对照关系为人工按语义逐条比对。

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

docs/specs/phase3-coverage.md

@@ -0,0 +1,123 @@
+# 阶段 3 覆盖率对账
+
+日期：2026-08-07
+基准：`docs/specs/endpoint-inventory.md` 的 110 条 KEEP 端点
+对象：`apps/api/src/routes/*.ts` 的 79 个路由 handler（含未提交工作树）
+
+## 结论
+
+| | 旧端点 KEEP | 新后端已实现 | 缺口 |
+|---|---|---|---|
+| **oj 侧** | 65 | 65（另有 4 条新增） | **0** |
+| **admin 侧** | 45 | **0** | **45** |
+| 合计 | 110 | 65 | 45 |
+
+**oj 侧已全部覆盖，admin 侧一条未做。** 这与设计文档第 11 节的阶段划分一致 —— admin 本就排在阶段 4。
+
+> 对账方法说明：阶段 0 已定案 API 重新设计，新旧路径不同名（如旧 `/api/problem` → 新 `/api/problems`、
+> 旧 `/api/pickone` → 新 `/api/problems/random`），**无法按字符串自动匹配**。本表由人工按语义逐条比对，
+> 判断依据是路由文件归属 + 路径语义 + HTTP 动词。个别条目的对应关系带主观判断，下表逐条列出以便复核。
+
+## oj 侧逐条对照（65 条）
+
+| 旧 app | 旧端点 | 新路由 |
+|---|---|---|
+| account | `login` | `POST auth/login` |
+| account | `logout` | `DELETE auth/session` |
+| account | `register` | `POST users` |
+| account | `profile` | `GET me` / `GET profiles/:username` / `PUT me/profile` |
+| account | `profile/fresh_display_id` | `POST me/problem-display-ids/refresh` |
+| account | `metrics` | `GET users/:id/metrics` |
+| account | `upload_avatar` | `POST me/avatar` |
+| account | `user_rank` | `GET rankings/users` |
+| account | `user_activity_rank` | `GET rankings/activity` |
+| account | `user_problem_rank` | `GET problems/:displayId/rank` |
+| achievement | `achievements` | `GET achievements` |
+| achievement | `achievements/summary` | `GET achievements/summary` |
+| achievement | `achievements/pending` | `GET achievements/pending` |
+| ai | `ai/detail` | `GET ai/detail` |
+| ai | `ai/duration` | `GET ai/duration` |
+| ai | `ai/heatmap` | `GET ai/heatmap` |
+| ai | `ai/login_summary` | `GET ai/login-summary` |
+| ai | `ai/pinned` | `GET ai/pinned` |
+| ai | `ai/analysis` | `POST ai/analysis` |
+| ai | `ai/hint` | `POST ai/hint` |
+| ai | `ai/class_pk` | `POST ai/class-pk-analysis` |
+| ai | `ai/class_single` | `POST ai/class-analysis` |
+| announcement | `announcement` | `GET announcements` / `GET announcements/:id` |
+| class_pk | `class_rank` | `GET rankings/classes` |
+| class_pk | `user_class_rank` | `GET me/class-rank` |
+| class_pk | `class_pk` | `POST classes/comparison` |
+| conf | `website` | `GET site` |
+| conf | `hitokoto` | `GET quotes/random` |
+| conf | `class_usernames` | `GET classes/:className/usernames` |
+| conf | `judge_server_heartbeat/` | `POST judge-server/heartbeat` |
+| contest | `contests` | `GET contests` |
+| contest | `contest` | `GET contests/:id` |
+| contest | `contest/password` | `POST contests/:id/access` |
+| contest | `contest/access` | `GET contests/:id/access` |
+| contest | `contest_rank` | `GET contests/:id/rank` |
+| flowchart | `flowchart/submission`（POST） | `POST flowcharts` |
+| flowchart | `flowchart/submissions` | `GET flowcharts` |
+| flowchart | `flowchart/submission/retry` | `POST flowcharts/:id/retry` |
+| flowchart | `flowchart/submission/detail` | `GET flowcharts/:id` |
+| flowchart | `flowchart/submission/current` | `GET problems/:id/flowchart/current` |
+| message | `message` | `GET messages` / `POST messages` |
+| problem | `problem/tags` | `GET problem-tags` |
+| problem | `problem` | `GET problems/:displayId` |
+| problem | `problem/beat_count` | `GET problems/:id/beat-count` |
+| problem | `problem/similar` | `GET problems/:displayId/similar` |
+| problem | `problem/author` | `GET problem-authors` |
+| problem | `problem/yearly_ac` | `GET problems/:displayId/yearly-ac` |
+| problem | `pickone` | `GET problems/random` |
+| problem | `contest/problem` | `GET contests/:id/problems` + `GET contests/:id/problems/:displayId` |
+| problemset | `problemset` | `GET problem-sets` |
+| problemset | `problemset/<id>` | `GET problem-sets/:id` |
+| problemset | `problemset/<id>/problems` | `GET problem-sets/:id/problems` |
+| problemset | `problemset/progress` | `POST problem-set-progress` / `PUT problem-set-progress` |
+| problemset | `user/badges` | `GET users/:username/badges` |
+| problemset | `problemset/<id>/badges` | `GET problem-sets/:id/badges` |
+| problemset | `problemset/<id>/users_progress` | `GET problem-sets/:id/user-progress` |
+| reaction | `reaction` | `GET problems/:id/reaction` / `POST problems/:id/reaction` |
+| submission | `submission` | `GET submissions/:id` |
+| submission | `submissions` | `GET submissions` |
+| submission | `submissions/today_count` | `GET submissions/today-count` |
+| submission | `format_code` | `POST code/format` |
+| submission | `contest_submissions` | `GET contests/:contestId/submissions` |
+| tutorial | `tutorial` | `GET tutorials/:id` |
+| tutorial | `tutorials` | `GET tutorials` |
+| tutorial | `exercises` | `GET tutorials/:id/exercises` |
+
+### 新增的 4 条（旧后端没有对应）
+
+| 新路由 | 说明 |
+|---|---|
+| `POST submissions` | 旧后端提交走 `POST /api/submission`，与 `GET submission` 同路径不同动词，拆开后成独立条目 |
+| `PUT submissions/:id` | 判题结果写回 |
+| `POST achievements/pending/read` | 成就已读标记 |
+| `GET problems/:id/flowchart/history` | 流程图历史 |
+| `GET dev/problems` | **阶段 1 的临时验证端点，应删除** |
+
+## admin 侧缺口（45 条，按 app）
+
+| app | 条数 |
+|---|---|
+| problem | 14 |
+| problemset | 10 |
+| conf | 5 |
+| contest | 3 |
+| tutorial | 3 |
+| account | 2 |
+| achievement | 2 |
+| submission | 2 |
+| ai | 1 |
+| announcement | 1 |
+| flowchart | 1 |
+| utils | 1 |
+
+`problem` 与 `problemset` 两块占了 24 条，超过 admin 缺口的一半 —— 排期时应作为主体。
+
+## 待处理项
+
+1. **`GET dev/problems` 是阶段 1 的临时验证端点**，与 `apps/web` 里的临时验证页 `dev-problems.vue` 配套，两者都应在本阶段收尾时删除。
+2. 本报告的对照关系带人工判断成分，若某条对应有异议，以实际业务行为为准。