shangfangjian
f50784f9dc
4 个专业 Agent 协同: - DBA: 数据库 schema、迁移、模型 - FE: 前端 React 界面 - BE: 后端 API、LLM 预测、数据采集 - Ops: 部署、Docker、配置 详见 docs/AGENTS.md 和各 Agent 上下文文件
44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
# 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
|