yuetsh
0f999aa5b1
核验为逐条实跑，不采信文档声称。阶段 0/1/2 出口标准全部通过， 其中阶段 2 判题链路端到端实测（注册→登录→提交→JudgeServer→WS 推送）。 覆盖率对账：oj 侧 65 条已全部实现，admin 侧 45 条一条未做。 新旧路径不同名（API 已重新设计），对照关系为人工按语义逐条比对。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
5.9 KiB
5.9 KiB
阶段 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 缺口的一半 —— 排期时应作为主体。
待处理项
GET dev/problems是阶段 1 的临时验证端点，与apps/web里的临时验证页dev-problems.vue配套，两者都应在本阶段收尾时删除。- 本报告的对照关系带人工判断成分，若某条对应有异议，以实际业务行为为准。