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

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

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

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

src/api/routes/predict.py

@@ -0,0 +1,106 @@
+"""预测路由。"""
+from __future__ import annotations
+
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy import select
+from sqlalchemy.orm import selectinload
+
+from src.api.schemas import PredictOut, PredictRequest, PredictionOut
+from src.db.base import AsyncSession, get_db, get_db_read
+from src.db.models import Prediction
+from src.llm.predict import predict_match, PredictResult
+
+router = APIRouter(prefix="/api/v1", tags=["predict"])
+
+
+@router.post("/predict", response_model=PredictOut)
+async def predict(req: PredictRequest, db: AsyncSession = Depends(get_db)):
+    """对一场比赛调 LLM 预测。mode=multi(默认,5专家+终裁)或 single。"""
+    try:
+        result = await predict_match(
+            req.match_id,
+            model=req.model,
+            prompt_version=req.prompt_version,
+            mode=req.mode,
+        )
+    except ValueError as e:
+        raise HTTPException(404, str(e))
+    except RuntimeError as e:
+        raise HTTPException(502, str(e))
+
+    # single / multi 两种结果统一映射
+    return PredictOut(
+        prediction_id=result.prediction_id,
+        provider=result.provider,
+        model=result.model,
+        prompt_version=getattr(result, "prompt_version", None),
+        mode=getattr(result, "mode", "single"),
+        pred_home_goals=result.pred_home_goals,
+        pred_away_goals=result.pred_away_goals,
+        pred_1x2=result.pred_1x2,
+        confidence=result.confidence,
+        reasoning=result.reasoning,
+        agent_outputs=getattr(result, "agent_outputs", None),
+        agent_weights=getattr(result, "agent_weights", None),
+        context=result.context,
+        latency_ms=result.latency_ms,
+    )
+
+
+@router.get("/predictions", response_model=list[PredictionOut])
+async def list_predictions(
+    match_id: int | None = None,
+    limit: int = 50,
+    db: AsyncSession = Depends(get_db_read),
+):
+    stmt = select(Prediction).options(selectinload(Prediction.match))
+    if match_id:
+        stmt = stmt.where(Prediction.match_id == match_id)
+    stmt = stmt.order_by(Prediction.created_at.desc()).limit(limit)
+    rows = (await db.execute(stmt)).scalars().all()
+    return [
+        PredictionOut(
+            id=p.id,
+            match_id=p.match_id,
+            provider=p.provider,
+            model=p.model,
+            prompt_version=p.prompt_version,
+            mode=p.mode or "single",
+            pred_home_goals=p.pred_home_goals,
+            pred_away_goals=p.pred_away_goals,
+            pred_1x2=p.pred_1x2,
+            confidence=p.confidence,
+            reasoning=p.reasoning,
+            agent_outputs=p.agent_outputs,
+            created_at=p.created_at,
+            actual_home_goals=p.actual_home_goals,
+            actual_away_goals=p.actual_away_goals,
+            settled=p.settled,
+        )
+        for p in rows
+    ]
+
+
+@router.get("/predictions/{prediction_id}", response_model=PredictionOut)
+async def get_prediction(prediction_id: int, db: AsyncSession = Depends(get_db_read)):
+    p = await db.get(Prediction, prediction_id)
+    if p is None:
+        raise HTTPException(404, "prediction not found")
+    return PredictionOut(
+        id=p.id,
+        match_id=p.match_id,
+        provider=p.provider,
+        model=p.model,
+        prompt_version=p.prompt_version,
+        mode=p.mode or "single",
+        pred_home_goals=p.pred_home_goals,
+        pred_away_goals=p.pred_away_goals,
+        pred_1x2=p.pred_1x2,
+        confidence=p.confidence,
+        reasoning=p.reasoning,
+        agent_outputs=p.agent_outputs,
+        created_at=p.created_at,
+        actual_home_goals=p.actual_home_goals,
+        actual_away_goals=p.actual_away_goals,
+        settled=p.settled,
+    )