> ⚠️ **历史文档(已过时)**:伤停(injuries)数据源与 api-football 集成已移除,
> 数据源收敛为 bzzoiro 唯一来源。本文仅作历史决策记录保留,
> 现状请见 [05-data.md](05-data.md) 与 [01-architecture.md](01-architecture.md)。

---

"""检查 injuries 数据源 api-football 的响应结构。"""
API_FOOTBALL_INJURY_RESPONSE_EXAMPLE = """
{
  "response": [
    {
      "player": {
        "id": 12345,
        "name": "Bukayo Saka",
        "photo": "https://...",
        "type": "Missing Fixture"
      },
      "team": {"id": 42, "name": "Arsenal"},
      "fixture": {"id": 100000, "date": "2026-09-15T19:00:00+00:00"},
      "league": {"id": 39, "name": "Premier League"},
      "reason": "Hamstring Injury",
      "type": "Missing Fixture"
    }
  ]
}
"""

"""
injuries 表设计:

CREATE TABLE injuries (
    id SERIAL PRIMARY KEY,
    player_id INT,                        -- api-football 球员 ID
    player_name VARCHAR(120) NOT NULL,    -- 球员名
    team_id INT REFERENCES teams(id),     -- 关联球队(按名归一后匹配)
    fixture_id INT,                       -- api-football 比赛 ID(无法直接关联 matches.id)
    league_id INT,
    injury_type VARCHAR(50),              -- 'Missing Fixture' / 'Suspended'
    reason VARCHAR(200),                  -- 伤停原因(如 'Hamstring Injury')
    injury_date DATE,                     -- 伤停日期
    return_date DATE,                     -- 预计回归日期(如有)
    retrieved_at TIMESTAMPTZ DEFAULT now(),
    UNIQUE(player_id, fixture_id, injury_type)  -- 幂等
);

-- 查询某队某场比赛的伤停:
SELECT player_name, injury_type, reason
FROM injuries
WHERE team_id = :team_id
  AND injury_date <= :match_date
  AND (return_date IS NULL OR return_date >= :match_date);
"""