FA3-Datafetch/DOC/walkthrough.md

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

本演示记录了使用该后端系统获取中国（Tushare）和美国（Alpha Vantage）市场股票数据，并生成财务分析报告的全过程。

1. 验证目标

• 中国市场: 获取 贵州茅台 (600519.SH) 近 10 年财务数据。
• 美国市场: 获取 Apple Inc. (AAPL) 近 10 年财务数据。
• 功能: 下载数据 -> 本地存储 (CSV) -> 计算指标 (ROE, 净利率等) -> 生成带有颜色标记的 Markdown 报告。

2. 执行过程

通过运行 main.py 脚本执行了验证：

python main.py

运行日志摘要

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

...

4. 结论

• 数据获取: 成功连接 Tushare 和 Alpha Vantage API 并下载了数据。
• 数据清洗: 修复了日期格式不一致问题，确保了指标计算时年份正确对齐。
• 报告生成: 成功生成了包含 ROE、净利率、偿债能力分析的 Markdown 报告。

year	revenue	net_income	ROE	NetMargin	DebtToEquity	CurrentRatio
2024	391,035,000,000	93,736,000,000	147.28%	23.97%	4.55	0.82
2023	383,285,000,000	96,995,000,000	156.08%	25.31%	4.67	0.99