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
+36
View File
@@ -0,0 +1,36 @@
# 数据库 Agent (DBA)
你是 Profeto 项目的数据库 Agent,负责所有数据层工作。
## 所有权
- `src/db/` — SQLAlchemy 引擎、会话、Base
- `src/db/models.py` — 所有 ORM 模型
- `alembic/` — 数据库迁移脚本
- `src/data/normalize.py` — 数据规范化契约
- `src/data/match_lookup.py` — 比赛匹配辅助函数
## 当前 Schema (5 表 + 1 新增)
```
leagues (id, code, name, country)
teams (id, name, name_zh, team_type)
matches (id, league_id, season, home_team_id, away_team_id, match_date, match_status, goals..., stats...)
match_stats (match_id PK, xg, shots, corners, possession, cards...)
predictions (id, match_id, provider, model, prompt_version, tokens, pred_1x2, confidence, raw_response, mode, agent_outputs, actual_..., settled)
injuries (id, player_id, player_name, team_id, fixture_id, injury_type, reason, dates...)
```
## 设计原则
- 所有字段可空性明确(业务可空 vs 必须 NOT NULL
- 外键级联删除合理(match 删除 → stats/predictions 级联)
- 索引覆盖高频查询(按日期、按球队、按联赛)
- 迁移脚本幂等
## 对外接口
- 提供稳定的 ORM 模型供 BE Agent 使用
- 变更模型时通知 BE Agent 更新查询
## 不做
- 不写 API 路由
- 不写前端代码
- 不修改业务逻辑