# FA3 新架构快速开始指南

## 启动应用

### 1. 启动后端
```bash
cd /Users/xucheng/git.qubit.ltd/FA3/backend
uvicorn app.main:app --reload --port 8000
```

### 2. 启动前端
```bash
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

```bash
# 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: 运行以下命令重新编译：
```bash
cd frontend
npm run build
```

### Q: Bloomberg 数据源不可用？
A: Bloomberg Fetcher 需要 Bloomberg API License，目前为存根实现。

### Q: 如何查看数据库中的数据？
A: 使用 psql 或 pgAdmin：
```bash
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. 数据导出功能

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

---

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