lyman/FA3-Datafetch
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
fb89ae2d51
FA3-Datafetch/QUICKSTART.md

3.8 KiB
Raw Blame History

FA3 新架构快速开始指南

启动应用

1. 启动后端

cd /Users/xucheng/git.qubit.ltd/FA3/backend
uvicorn app.main:app --reload --port 8000

2. 启动前端

cd /Users/xucheng/git.qubit.ltd/FA3/frontend
npm run dev

3. 访问应用

打开浏览器访问: http://localhost:3001

使用新架构

完整流程示例（HK市场）

  1. 搜索公司

    • 在搜索框输入 "腾讯"
    • 点击搜索结果中的 "选择" 按钮

  2. 选择数据源

    • 系统自动显示 HK 市场可用的数据源（iFinD）
    • 确认选择或切换数据源

  3. 获取数据

    • 点击 "获取数据" 按钮
    • 等待数据获取完成（约30秒-2分钟）
    • 系统会自动轮询状态并更新

  4. 查看财务数据

    • 数据获取完成后，自动显示财务表格
    • 切换 Tab 查看不同报表：
      • 利润表
      • 资产负债表
      • 现金流量表
      • 估值数据

  5. 启动AI分析

    • 点击 "开始 AI 分析" 按钮
    • 等待分析完成（约1-2分钟）

  6. 查看分析报告

    • 分析完成后，自动显示报告
    • 切换 Tab 查看不同部分：
      • 公司简介
      • 基本面分析
      • 内部人士分析
      • 看涨分析
      • 看跌分析

API 测试

使用 curl 测试新API

# 1. 检查数据状态
curl "http://localhost:8000/api/data/check?market=HK&symbol=00700&data_source=iFinD"

# 2. 获取可用数据源
curl "http://localhost:8000/api/data/sources?market=HK"

# 3. 触发数据获取
curl -X POST "http://localhost:8000/api/data/fetch" \
  -H "Content-Type: application/json" \
  -d '{
    "market": "HK",
    "symbol": "00700",
    "company_name": "腾讯控股",
    "data_source": "iFinD"
  }'

# 4. 查询获取状态（替换 {update_id}）
curl "http://localhost:8000/api/data/status/1"

# 5. 读取财务数据（替换 {company_id}）
curl "http://localhost:8000/api/data/financial?company_id=1&data_source=iFinD"

# 6. 启动AI分析
curl -X POST "http://localhost:8000/api/analysis/start" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": 1,
    "data_source": "iFinD",
    "model": "gemini-2.0-flash"
  }'

# 7. 查询分析状态（替换 {analysis_id}）
curl "http://localhost:8000/api/analysis/status/1"

# 8. 获取分析结果
curl "http://localhost:8000/api/analysis/result/1"

常见问题

Q: 数据获取失败怎么办？

A: 检查以下几点：

  1. 确认 API Token 配置正确（.env 文件）
  2. 检查数据库连接是否正常
  3. 查看后端日志中的错误信息

Q: 前端显示类型错误？

A: 运行以下命令重新编译：

cd frontend
npm run build

Q: Bloomberg 数据源不可用？

A: Bloomberg Fetcher 需要 Bloomberg API License，目前为存根实现。

Q: 如何查看数据库中的数据？

A: 使用 psql 或 pgAdmin：

psql -h 192.168.3.195 -U value -d fa3
SELECT * FROM companies;
SELECT * FROM data_updates;

数据库表结构

核心表

  • companies - 公司信息
  • data_updates - 数据更新记录
  • ai_analyses - AI分析报告
  • data_source_availability - 数据源可用性
  • settings - 系统配置

数据源表

  • ifind_hk_* - iFinD 香港数据
  • ifind_int_* - iFinD 国际数据（JP, US, VN）
  • bloomberg_* - Bloomberg 数据
  • tushare_cn_* - Tushare 中国数据

下一步优化

待实现功能

  1. get_financial_data_from_db() - 从数据库读取财务数据
  2. Bloomberg Fetcher 完整实现
  3. WebSocket 实时更新（替代轮询）
  4. 图表可视化
  5. 数据导出功能

已知问题

  • 部分财务指标的中文名称映射需要完善
  • 大数据量表格可能需要虚拟滚动优化
  • 错误提示可以更详细

快速开始完成！ 祝使用愉快 🎉