feat: 足球 LLM 预测服务初始提交

Profeto — 给 LLM 提供数据,让 LLM 预测足球比分。

核心模块:
- FastAPI 后端 + PostgreSQL (SQLAlchemy async)
- 多 Agent LLM 预测 (5 专家 + 终裁)
- 数据采集 (bzzoiro / understat / injuries)
- React 前端 (Vite + Tailwind)

包含:
- 数据源抽象 (DataSource 协议 + 注册表)
- Alembic 数据库迁移
- Prompt 模板 (单/多 Agent)
- 核心路径单元测试

src/core/config.py

@@ -0,0 +1,37 @@
+"""pydantic-settings 配置。"""
+from __future__ import annotations
+
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(env_file=".env", extra="ignore")
+
+    # --- app ---
+    APP_ENV: str = "development"
+    LOG_LEVEL: str = "INFO"
+
+    # --- database ---
+    DATABASE_URL: str = "postgresql+asyncpg://football:football@localhost:5432/football"
+
+    # --- LLM (OpenAI-compatible) ---
+    LLM_PROVIDER: str = "openai"
+    LLM_API_KEY: str = ""
+    LLM_BASE_URL: str = "https://api.openai.com/v1"
+    LLM_MODEL: str = "gpt-4o"
+    LLM_TIMEOUT: int = 60
+    # multi-agent 分档: 专家用便宜快模型,终裁用强模型;空则回落 LLM_MODEL
+    LLM_SPECIALIST_MODEL: str = ""
+    LLM_AGGREGATOR_MODEL: str = ""
+
+    # --- data sources ---
+    BZZOIRO_KEY: str = ""
+    BZZOIRO_BASE: str = "https://sports.bzzoiro.com/api/v2"
+    API_FOOTBALL_KEY: str = ""
+
+    # --- CORS ---
+    CORS_ORIGINS: str = "http://localhost:5173,http://localhost:3000"
+
+
+settings = Settings()

src/core/http_client.py

@@ -0,0 +1,31 @@
+"""共享 httpx 异步客户端(连接池复用 + 生命周期管理)。
+
+使用方:
+  - src/llm/provider.py: LLM 调用
+  - src/data/understat.py: xG 抓取
+  - src/data/injuries.py: 伤停抓取
+
+生命周期由 FastAPI lifespan 管理(关闭时 aclose)。
+"""
+from __future__ import annotations
+
+import httpx
+
+_shared_client: httpx.AsyncClient | None = None
+_default_timeout = 30
+
+
+def get_client() -> httpx.AsyncClient:
+    """获取共享客户端(懒初始化)。"""
+    global _shared_client
+    if _shared_client is None or _shared_client.is_closed:
+        _shared_client = httpx.AsyncClient(timeout=_default_timeout)
+    return _shared_client
+
+
+async def close_client() -> None:
+    """关闭共享客户端(在 FastAPI shutdown 时调用)。"""
+    global _shared_client
+    if _shared_client is not None and not _shared_client.is_closed:
+        await _shared_client.aclose()
+    _shared_client = None