# Quick Reference - 完整数据流快速参考

## 🎯 核心实施成果

✅ **数据库**: 7表3视图，已部署
✅ **ORM模型**: 完整SQLAlchemy模型
✅ **数据加载器**: TuShare批量加载5000只A股
✅ **策略引擎**: 4种策略（价值/成长/动量/综合）
⏸️ **待完成**: Docker重建 → 数据加载 → API集成

---

## 🚀 立即开始（3步骤，30分钟）

### Step 1: 重建Docker (5分钟)
```bash
docker-compose build backend
docker-compose restart backend
```

### Step 2: 加载测试数据 (2分钟)
```bash
# 加载10只A股，30天数据
docker-compose exec backend python services/historical_data_loader.py \
  --market a_share --years 0.08
```

### Step 3: 生成推荐并验证 (2分钟)
```bash
# 生成推荐
docker-compose exec backend python app/modules/strategy_engine.py \
  --strategy comprehensive --top 10

# 验证数据库
docker-compose exec -T postgres psql -U stockai -d stockai \
  -c "SELECT * FROM latest_recommendations LIMIT 5;"

# 测试API
curl "http://localhost:8001/api/recommendations?limit=5" | jq
```

---

## 📊 验证命令

### 检查数据库
```bash
# 查看所有表
docker-compose exec -T postgres psql -U stockai -d stockai -c "\dt"

# 查看策略配置
docker-compose exec -T postgres psql -U stockai -d stockai \
  -c "SELECT * FROM strategy_configs;"

# 查看数据量
docker-compose exec -T postgres psql -U stockai -d stockai -c "
SELECT 'stocks' as table_name, COUNT(*) FROM stocks
UNION ALL
SELECT 'daily_quotes', COUNT(*) FROM daily_quotes
UNION ALL
SELECT 'technical_indicators', COUNT(*) FROM technical_indicators
UNION ALL
SELECT 'recommendations', COUNT(*) FROM recommendations;"
```

### 监控数据加载进度
```bash
docker-compose exec -T postgres psql -U stockai -d stockai -c "
SELECT task_name, status, loaded_records, total_records,
       ROUND((loaded_records::float / NULLIF(total_records, 0)) * 100, 2) as progress
FROM data_load_tasks
ORDER BY created_at DESC LIMIT 5;"
```

---

## 📁 关键文件位置

```
backend/
├── database/
│   └── schema_v2.sql                        # 数据库Schema (已部署)
├── app/
│   ├── models/
│   │   └── stock_models.py                  # ORM模型
│   ├── modules/
│   │   └── strategy_engine.py               # 策略引擎
│   └── routes/
│       └── recommendations.py               # API路由 (需更新)
├── services/
│   └── historical_data_loader.py            # 数据加载器
└── scripts/
    ├── init_database_v2.py                  # 数据库初始化
    └── test_data_loader.py                  # 测试脚本
```

---

## 🔧 常用命令

### 数据加载
```bash
# 快速测试 (10只股票，1个月)
docker-compose exec backend python services/historical_data_loader.py --market a_share --years 0.08

# 完整加载 (5000只股票，1年) - 后台运行
docker-compose exec -d backend python services/historical_data_loader.py --market a_share --years 1
```

### 策略推荐
```bash
# 单个策略
docker-compose exec backend python app/modules/strategy_engine.py --strategy comprehensive --top 20

# 所有策略
for strategy in value growth momentum comprehensive; do
  docker-compose exec backend python app/modules/strategy_engine.py --strategy $strategy --top 20
done
```

### 数据库查询
```bash
# 查看最新推荐
docker-compose exec -T postgres psql -U stockai -d stockai \
  -c "SELECT * FROM latest_recommendations LIMIT 10;"

# 查看技术指标汇总
docker-compose exec -T postgres psql -U stockai -d stockai \
  -c "SELECT * FROM stock_technical_summary LIMIT 10;"

# 查看基本面汇总
docker-compose exec -T postgres psql -U stockai -d stockai \
  -c "SELECT * FROM stock_fundamental_summary LIMIT 10;"
```

---

## 📖 详细文档

- `IMPLEMENTATION_SUMMARY.md` - 完整实施总结
- `HISTORICAL_DATA_LOADER_GUIDE.md` - 数据加载器使用指南
- `FULL_DATA_PIPELINE_PLAN.md` - 原始实施计划
- `FULL_DATA_PIPELINE_IMPLEMENTATION_STATUS.md` - 详细状态

---

## ⚠️ 注意事项

### API限流
- **TuShare**: 500次/分钟 (0.5秒延迟)
- **yfinance**: 2000次/小时 (1秒延迟)
- **Alpha Vantage**: 25次/天 (12秒延迟)

### 预计时间
- **10只股票，1个月**: 2分钟
- **100只股票，3个月**: 10分钟
- **5000只股票，1年**: 1.5小时

### 存储需求
- **1年×5000股票**: ~2GB数据库空间
- **建议可用空间**: 至少5GB

---

## 🎯 成功标准

- [x] Schema部署成功
- [x] 策略配置加载
- [ ] 至少10只股票数据加载
- [ ] 推荐生成成功
- [ ] API返回真实数据
- [ ] Dashboard显示真实推荐

**当前进度**: 2/6 (数据库准备完成，待数据加载)

---

## 📞 故障排除

### "Module not found" 错误
```bash
# 重建Docker镜像
docker-compose build backend && docker-compose restart backend
```

### 查看数据加载日志
```bash
docker-compose logs -f backend | grep "Processing batch"
```

### 手动进入数据库
```bash
docker-compose exec -it postgres psql -U stockai -d stockai
```

### 检查Docker容器状态
```bash
docker-compose ps
docker-compose logs backend | tail -n 50
```

---

**最后更新**: 2025-11-16 20:00
**下一步**: 执行 Step 1 (Docker重建)