# Profeto — 先知

足球 LLM 预测服务。

## 多 Agent 协同

本项目采用 4 Agent 协同模式。详见 `docs/AGENTS.md`。

| Agent | 所有权 | 上下文文件 |
|---|---|---|
| 🗄️ DBA (数据库) | `src/db/`, `alembic/`, 数据模型 | `docs/agents/dba.md` |
| 🖥️ FE (前端) | `frontend/` | `docs/agents/fe.md` |
| ⚙️ BE (后端) | `src/api/`, `src/core/`, `src/llm/`, `src/data/` | `docs/agents/be.md` |
| 🚀 Ops (部署) | `Dockerfile`, `docker-compose.yml`, 配置 | `docs/agents/ops.md` |

## 技术栈

- **后端**: Python 3.11+, FastAPI, SQLAlchemy async, PostgreSQL
- **前端**: React, TypeScript, Vite, Tailwind CSS
- **LLM**: OpenAI-compatible (OpenAI / Deepseek / Ollama)
- **数据源**: bzzoiro, understat, api-football

## 常用命令

```bash
# 后端
uvicorn src.api.app:app --reload        # 启动 API
pytest                                   # 测试
alembic upgrade head                     # 数据库迁移

# 前端
cd frontend && npm run dev               # 开发
cd frontend && npm run build             # 构建

# 部署
docker compose up -d                     # 启动全部服务
```

## 协作原则

- 每个 Agent 在自己的所有权范围内工作
- 跨 Agent 变更通过接口契约协调（REST API / ORM 模型 / docker-compose）
- 修改接口前通知相关 Agent