# 财务数据获取与分析系统 - 执行演示

本演示记录了使用该后端系统获取中国（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 报告。
