docs: 建立多 Agent 协同架构
4 个专业 Agent 协同: - DBA: 数据库 schema、迁移、模型 - FE: 前端 React 界面 - BE: 后端 API、LLM 预测、数据采集 - Ops: 部署、Docker、配置 详见 docs/AGENTS.md 和各 Agent 上下文文件
This commit is contained in:
@@ -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
|
||||
Reference in New Issue
Block a user