NeteaseUrl

24 Commits 1 Branch 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
snowy-yang	f5d1e3c3a9	feat: 支持纯 FastAPI 模式（根路径服务前端）+ 修任务端点路径 - web/app.py：create_app(api_prefix=) 参数化前缀——'' 即根路径模式， 87 条路由直接服务前端使用的路径，无需 Flask 兜底 - web/main.py：WEB_MODE=dual（默认，迁移期）/ fastapi（纯 FastAPI）切换 - 修真实路径缺陷：任务类端点漏了 /api 段（Flask 为 /api/topen 等，原写成 /topen），根路径模式下前端会 404。已改为 /api/topen、/api/queue、 /api/batch_progress、/api/task/*；fe_error 同步修正 - 奇偶校验路径映射同步更新验证： - tests/test_root_mode.py 新增 66 项：前端调用的每条路径在纯 FastAPI 模式下均非 404；root 模式不再暴露 /api/v1 - 纯 FastAPI 模式真实启动（uvicorn, PORT=5002）实测： /health、/、/static 200，/song、/api/task/list 401（鉴权生效） - 全套 pytest 135/135；ruff All checks passed；pyright 0 errors；奇偶 36/36	2026-09-26 10:25:05 +08:00
snowy-yang	cd0f1f78a3	refactor: 迁移收尾（管理员2FA）+ 抽取公共工具层，消除 router 间重复补齐最后缺口： - POST /api/v1/auth/admin_login/email、/auth/admin_login/verify（管理员 2FA Step2/3），复用 auth_routes 的票据表与尝试上限（跨栈共享），签发会话 Cookie 重构（消除约 200 行重复，11 个 router 受益）： - web/request_utils.py：request_data / safe_int / extract_id / cookies / dedup_ids 原在各 router 各复制一份，现集中 - web/serializers.py：format_credits / user_public / record_req_log - 各 router 改为导入别名，行为逐字不变覆盖率：Flask 90 条业务路由全部有 FastAPI 等价端点（含 5 个向后兼容别名）。验证：pytest 69/69；ruff All checks passed；pyright 0 errors；奇偶 36/36；冒烟 10/10。	2026-09-26 10:20:46 +08:00
snowy-yang	f588d313f0	feat(routes): 迁移任务状态端点（topen/queue/batch_progress/task/） - web/routers/tasks.py：topen、queue、batch_progress、task/cancel、 task/heartbeat、task/list 迁至 /api/v1/ - 读写 core.state 共享任务表/统计（与 Flask 同一批对象）——两栈迁移期看到同一份任务状态，这是单进程双框架成立的关键 - task/cancel 保持 POST-only（与 Flask 同口径，杜绝顶层导航 GET 触发取消）契约奇偶校验：24 项全 OK（新增 queue/topen/task:list/heartbeat/progress404）；验证：pytest 46/46；ruff All checks passed；pyright 0 errors；冒烟 10/10。	2026-09-26 01:18:51 +08:00

Author

SHA1

Message

Date

snowy-yang

f5d1e3c3a9

feat: 支持纯 FastAPI 模式（根路径服务前端）+ 修任务端点路径

- web/app.py：create_app(api_prefix=) 参数化前缀——'' 即根路径模式，
  87 条路由直接服务前端使用的路径，无需 Flask 兜底
- web/main.py：WEB_MODE=dual（默认，迁移期）/ fastapi（纯 FastAPI）切换
- 修真实路径缺陷：任务类端点漏了 /api 段（Flask 为 /api/topen 等，
  原写成 /topen），根路径模式下前端会 404。已改为 /api/topen、/api/queue、
  /api/batch_progress、/api/task/*；fe_error 同步修正
- 奇偶校验路径映射同步更新

验证：
- tests/test_root_mode.py 新增 66 项：前端调用的每条路径在纯 FastAPI 模式下
  均非 404；root 模式不再暴露 /api/v1
- 纯 FastAPI 模式真实启动（uvicorn, PORT=5002）实测：
  /health、/、/static 200，/song、/api/task/list 401（鉴权生效）
- 全套 pytest 135/135；ruff All checks passed；pyright 0 errors；奇偶 36/36

2026-09-26 10:25:05 +08:00

snowy-yang

cd0f1f78a3

refactor: 迁移收尾（管理员2FA）+ 抽取公共工具层，消除 router 间重复

补齐最后缺口：
- POST /api/v1/auth/admin_login/email、/auth/admin_login/verify（管理员 2FA Step2/3），
  复用 auth_routes 的票据表与尝试上限（跨栈共享），签发会话 Cookie

重构（消除约 200 行重复，11 个 router 受益）：
- web/request_utils.py：request_data / safe_int / extract_id / cookies / dedup_ids
  原在各 router 各复制一份，现集中
- web/serializers.py：format_credits / user_public / record_req_log
- 各 router 改为导入别名，行为逐字不变

覆盖率：Flask 90 条业务路由全部有 FastAPI 等价端点（含 5 个向后兼容别名）。
验证：pytest 69/69；ruff All checks passed；pyright 0 errors；奇偶 36/36；冒烟 10/10。

2026-09-26 10:20:46 +08:00

snowy-yang

f588d313f0

feat(routes): 迁移任务状态端点（topen/queue/batch_progress/task/*）

- web/routers/tasks.py：topen、queue、batch_progress、task/cancel、
  task/heartbeat、task/list 迁至 /api/v1/*
- 读写 core.state 共享任务表/统计（与 Flask 同一批对象）——两栈迁移期看到同一份
  任务状态，这是单进程双框架成立的关键
- task/cancel 保持 POST-only（与 Flask 同口径，杜绝顶层导航 GET 触发取消）

契约奇偶校验：24 项全 OK（新增 queue/topen/task:list/heartbeat/progress404）；
验证：pytest 46/46；ruff All checks passed；pyright 0 errors；冒烟 10/10。

2026-09-26 01:18:51 +08:00