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

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

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

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

src/data/sources.py

@@ -0,0 +1,52 @@
+"""数据源协议 + 注册表。
+
+定义 DataSource 契约,并提供全局注册表供路由层分发。
+每个比赛数据源实现该协议,注册后即可通过统一入口调度。
+
+注: injuries 是球员级独立领域(写 Injury 表),不遵循此协议。
+"""
+from __future__ import annotations
+
+from typing import Protocol
+
+from src.db.base import AsyncSession
+
+
+class DataSource(Protocol):
+    """比赛数据源契约:抓取 → 规范化 → 入库。"""
+
+    @property
+    def name(self) -> str:
+        """数据源标识名(用于路由/日志)。"""
+        ...
+
+    async def ingest(self, db: AsyncSession, **kwargs) -> dict:
+        """执行完整采集流程,返回统计。"""
+        ...
+
+
+# ── 注册表 ──
+_SOURCES: dict[str, DataSource] = {}
+
+
+def register(source: DataSource) -> DataSource:
+    """装饰器:将数据源注册到全局注册表。"""
+    _SOURCES[source.name] = source
+    return source
+
+
+def get_source(name: str) -> DataSource:
+    """按名获取数据源。"""
+    if name not in _SOURCES:
+        raise ValueError(f"未知数据源: {name}")
+    return _SOURCES[name]
+
+
+def list_sources() -> list[str]:
+    """列出所有已注册数据源名。"""
+    return list(_SOURCES.keys())
+
+
+# ── 导入数据源触发 @register ──
+from src.data.bzzoiro import BzzoiroSource  # noqa: E402, F401
+from src.data.understat import UnderstatSource  # noqa: E402, F401