ljwx-stock/QUICK_REFERENCE.md

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

🎯 核心实施成果

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

---

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

Step 1: 重建Docker (5分钟)

docker-compose build backend
docker-compose restart backend

Step 2: 加载测试数据 (2分钟)

# 加载10只A股，30天数据
docker-compose exec backend python services/historical_data_loader.py \
  --market a_share --years 0.08

Step 3: 生成推荐并验证 (2分钟)

# 生成推荐
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

---

📊 验证命令

检查数据库

# 查看所有表
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;"

监控数据加载进度

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                  # 测试脚本

---

🔧 常用命令

数据加载

# 快速测试 (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

策略推荐

# 单个策略
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

数据库查询

# 查看最新推荐
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

---

🎯 成功标准

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

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

---

📞 故障排除

"Module not found" 错误

# 重建Docker镜像
docker-compose build backend && docker-compose restart backend

查看数据加载日志

docker-compose logs -f backend | grep "Processing batch"

手动进入数据库

docker-compose exec -it postgres psql -U stockai -d stockai

检查Docker容器状态

docker-compose ps
docker-compose logs backend | tail -n 50

---

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