docs: 建立多 Agent 协同架构

4 个专业 Agent 协同:
- DBA: 数据库 schema、迁移、模型
- FE: 前端 React 界面
- BE: 后端 API、LLM 预测、数据采集
- Ops: 部署、Docker、配置

详见 docs/AGENTS.md 和各 Agent 上下文文件
This commit is contained in:
shangfangjian
2026-09-14 21:59:45 +08:00
parent 3071ffd533
commit f50784f9dc
6 changed files with 361 additions and 0 deletions
+43
View File
@@ -0,0 +1,43 @@
# 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