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,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 路由
|
||||
- 不写前端代码
|
||||
- 不修改业务逻辑
|
||||
Reference in New Issue
Block a user