FA3-Datafetch/DOC/walkthrough.md
2025-12-15 22:05:19 +09:00

75 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 财务数据获取与分析系统 - 执行演示
本演示记录了使用该后端系统获取中国Tushare和美国Alpha Vantage市场股票数据并生成财务分析报告的全过程。
## 1. 验证目标
- **中国市场**: 获取 贵州茅台 (600519.SH) 近 10 年财务数据。
- **美国市场**: 获取 Apple Inc. (AAPL) 近 10 年财务数据。
- **功能**: 下载数据 -> 本地存储 (CSV) -> 计算指标 (ROE, 净利率等) -> 生成带有颜色标记的 Markdown 报告。
## 2. 执行过程
通过运行 `main.py` 脚本执行了验证:
```bash
python main.py
```
### 运行日志摘要
```text
Processing CN stock: 600519.SH...
Fetching Income Statement...
Fetching Balance Sheet...
Fetching Cash Flow...
Saved data/CN/600519.SH/income_statement.csv
Saved data/CN/600519.SH/balance_sheet.csv
Saved data/CN/600519.SH/cash_flow.csv
Calculating Financial Indicators...
Generating Report...
Analysis completed! Report saved to: data/CN/600519.SH/report.md
--------------------------------------------------
Processing US stock: AAPL...
Fetching Income Statement...
Fetching Balance Sheet...
Fetching Cash Flow...
Saved data/US/AAPL/income_statement.csv
Saved data/US/AAPL/balance_sheet.csv
Saved data/US/AAPL/cash_flow.csv
Calculating Financial Indicators...
Generating Report...
Analysis completed! Report saved to: data/US/AAPL/report.md
```
## 3. 输出结果演示
### 3.1 生成的文件结构
系统按预期在 `data/` 目录下生成了对应的文件夹和文件:
```
data/
├── CN/
│ └── 600519.SH/
│ ├── balance_sheet.csv
│ ├── cash_flow.csv
│ ├── income_statement.csv
│ └── report.md
└── US/
└── AAPL/
├── balance_sheet.csv (等)
└── report.md
```
### 3.2 报表内容示例 (AAPL)
生成的 `report.md` 包含带有背景色的 Markdown/HTML 表格,直观展示财务健康状况。
*(以下为报告片段)*
> **# Financial Analysis Report: US AAPL**
>
> <table><thead><tr><th>year</th><th>revenue</th><th>net_income</th><th>ROE</th><th>NetMargin</th><th>DebtToEquity</th><th>CurrentRatio</th></tr></thead><tbody><tr><td>2024</td><td style=''>391,035,000,000</td><td style=''>93,736,000,000</td><td style='background-color: #d1e7dd;'>147.28%</td><td style='background-color: #d1e7dd;'>23.97%</td><td style='background-color: #f8d7da;'>4.55</td><td style=''>0.82</td></tr><tr><td>2023</td><td style=''>383,285,000,000</td><td style=''>96,995,000,000</td><td style='background-color: #d1e7dd;'>156.08%</td><td style='background-color: #d1e7dd;'>25.31%</td><td style='background-color: #f8d7da;'>4.67</td><td style=''>0.99</td></tr>...
## 4. 结论
- **数据获取**: 成功连接 Tushare 和 Alpha Vantage API 并下载了数据。
- **数据清洗**: 修复了日期格式不一致问题,确保了指标计算时年份正确对齐。
- **报告生成**: 成功生成了包含 ROE、净利率、偿债能力分析的 Markdown 报告。