ProductionDataBaseSync_DataMacro

AllForCompany/ProductionDataBaseSync_DataMacro

Fork 0

Commit Graph

Author	SHA1	Message	Date
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
Misaka_Company	03d7bcea39	feat(health): 被动式健康检查 API（FastAPI，覆盖服务健康+数据健康）在同步进程内内置 FastAPI/uvicorn HTTP endpoint (GET /health)，返回结构化健康快照，便于运维/监控被动探活： - 服务健康：cycle_lag（核心指标，超过 3×poll_interval 判 unhealthy）、队列状态（pending/error/dead/cleaned 实时查）、capture 累计（enqueued/ deferred/aged_out）、最近 cycle 时间/耗时/错误。 - 数据健康：解析最近一次定时 compare_ids 报告（不跑全量 compare 太重）、实时查 SyncLogArchive 异常痕迹（AgedOut/降级）、SyncQueue dead 行样本。 status 三态：healthy(200) / degraded(503, 有dead/error/aged_out/compare 不一致) / unhealthy(503, 主循环停滞)。状态码映射便于按码告警。线程模型：uvicorn 占主线程，capture/apply/cleanup 循环跑后台 daemon 线程， NSSM 停服务时主线程退出、daemon 自动终止。health.enabled=false 时退化为旧行为（同步循环占主线程）。Web 层(routes/)与业务逻辑(HealthChecker) 解耦，后期加运维接口（compare触发/死信管理/metrics）零结构改动。零 SQL/零 schema 改动。新增依赖 fastapi/uvicorn[standard]。	2026-08-05 12:13:14 +08:00

Author

SHA1

Message

Date

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

Misaka_Company

03d7bcea39

feat(health): 被动式健康检查 API（FastAPI，覆盖服务健康+数据健康）

在同步进程内内置 FastAPI/uvicorn HTTP endpoint (GET /health)，返回结构化
健康快照，便于运维/监控被动探活：

- 服务健康：cycle_lag（核心指标，超过 3×poll_interval 判 unhealthy）、
  队列状态（pending/error/dead/cleaned 实时查）、capture 累计（enqueued/
  deferred/aged_out）、最近 cycle 时间/耗时/错误。
- 数据健康：解析最近一次定时 compare_ids 报告（不跑全量 compare 太重）、
  实时查 SyncLogArchive 异常痕迹（AgedOut/降级）、SyncQueue dead 行样本。

status 三态：healthy(200) / degraded(503, 有dead/error/aged_out/compare
不一致) / unhealthy(503, 主循环停滞)。状态码映射便于按码告警。

线程模型：uvicorn 占主线程，capture/apply/cleanup 循环跑后台 daemon 线程，
NSSM 停服务时主线程退出、daemon 自动终止。health.enabled=false 时退化为
旧行为（同步循环占主线程）。Web 层(routes/)与业务逻辑(HealthChecker)
解耦，后期加运维接口（compare触发/死信管理/metrics）零结构改动。

零 SQL/零 schema 改动。新增依赖 fastapi/uvicorn[standard]。

2026-08-05 12:13:14 +08:00

2 Commits