FA3-Datafetch/QUICKSTART.md

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:3000

---

使用新架构

完整流程示例（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. 数据导出功能

已知问题

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

---

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