169 lines
3.8 KiB
Markdown
169 lines
3.8 KiB
Markdown
# 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. 数据导出功能
|
||
|
||
### 已知问题
|
||
- 部分财务指标的中文名称映射需要完善
|
||
- 大数据量表格可能需要虚拟滚动优化
|
||
- 错误提示可以更详细
|
||
|
||
---
|
||
|
||
**快速开始完成！** 祝使用愉快 🎉
|