Misaka_Company 79a95465e7 refactor(web): API 路由统一 /api 前缀 + 完善 OpenAPI 文档 ...

- 路由挂 APIRouter(prefix="/api")，健康检查路径 /health -> /api/health，
  后期加接口（/api/compare、/api/queue 等）自动共享前缀。
- 文档路径归到 /api 下：/api/docs、/api/redoc、/api/openapi.json
  （原 /docs、/redoc、/openapi.json 已 404）。
- 新增 Pydantic 响应模型 schemas.py，并在 /api/health 挂 response_model，
  使 /api/docs 展示完整响应结构。
- 为接口和每个响应字段补详细英文 description（覆盖范围、status 三态判定、
  HTTP 码含义、各字段语义如 cycle_lag 阈值/dead 含义等）。

不动业务逻辑与同步主循环，仅 Web 层。

2026-08-05 12:55:45 +08:00

6.9 KiB

Raw Blame History

View Raw