curl测试接口

curl -X POST http://127.0.0.1:3000/api/v1/gpu/red-black/tasks/query-wiki-link \
  -H "Content-Type: application/json" \
  -d '{
    "stat_cycle_type": "week",
    "stat_cycle_value": "2026.2.1-2026.2.8",
    "rank_type": "red",
    "biz_category": "AMU"
  }'

一、整体设计模块(四层架构)

┌─────────────────────────────────────────────────────────┐
│  1. 路由层 (Router)         — 接收 HTTP 请求,分发给 Service │
│     gpu_red_black_task_router.py                        │
├─────────────────────────────────────────────────────────┤
│  2. 数据模型层 (Models)      — 定义请求体/响应体的结构       │
│     gpu_red_black_task_models.py                        │
├─────────────────────────────────────────────────────────┤
│  3. 服务层 (Service)        — 核心业务逻辑 + 数据库操作      │
│     gpu_red_black_task_service.py                       │
├─────────────────────────────────────────────────────────┤
│  4. ORM 模型 (数据库表映射)   — Python 类 ↔ 数据库表         │
│     也在 gpu_red_black_task_service.py 中定义             │
└─────────────────────────────────────────────────────────┘
再加上一个贯穿各层的关键机制:

  5. 依赖注入 (DI Injector)   — 管理数据库连接的生命周期
     SQLGpuRedBlackTaskServiceInjector
还有一个 路由注册入口:

  6. v1_router.py             — 将各模块的 router 注册到主应用

二、各模块详解