46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# 需求文档：公司财务数据获取与分析系统
|
||
|
||
## 1. 项目概述
|
||
构建一个后端系统，根据证券代码和所属市场，获取目标公司的财务数据（资产负债表、利润表、现金流量表）。系统将保存原始数据，计算关键财务指标，并生成一份带有样式（背景色）的 Markdown 格式报告。
|
||
|
||
## 2. 项目范围
|
||
- **目标市场**：
|
||
- **中国 (CN)**: 使用 Tushare API。
|
||
- **香港 (HK)**: 使用 Tushare API (已确认支持)。
|
||
- **美国 (US)**: 使用 Alpha Vantage API。
|
||
- **日本 (JP)**: 尝试使用 Alpha Vantage API (需验证数据完整性)。
|
||
- **数据覆盖**：最近 10 年的年度数据（或可获取的历史数据）。
|
||
- **数据内容**：三大主要财务报表（利润表、资产负债表、现金流量表）。
|
||
|
||
## 3. 功能需求
|
||
|
||
### 3.1 数据获取
|
||
- **输入**：`证券代码` (Stock Code), `市场` (CN, HK, US, JP)。
|
||
- **逻辑**：
|
||
- 若 `市场 == CN` 或 `HK`: 调用 Tushare API。
|
||
- 若 `市场 == US`: 调用 Alpha Vantage API。
|
||
- 若 `市场 == JP`: 尝试调用 Alpha Vantage API。
|
||
- **规模**：获取过去 10 年的数据。
|
||
|
||
### 3.2 数据存储
|
||
- 将获取的原始财务报表保存为本地文件。
|
||
- **格式**：CSV (推荐，便于后续处理)。
|
||
- **命名规范**：`data/{市场}/{代码}_{报表类型}.csv`。
|
||
|
||
### 3.3 数据分析
|
||
- 读取本地保存的财务报表文件。
|
||
- 计算关键财务指标 (具体指标待定，预设包含：ROE, 净利率, 负债率等)。
|
||
|
||
### 3.4 报告生成
|
||
- 生成 Markdown 格式的汇总报告。
|
||
- **样式要求**：表格需包含背景色（如根据指标优劣显示红/绿，或隔行变色）。
|
||
- *注*：由于标准 Markdown 不支持背景色，将采用嵌入 HTML 的方式实现。
|
||
|
||
## 4. 技术需求
|
||
- **开发语言**：Python。
|
||
- **配置管理**：API Key (Tushare, Alpha Vantage) 需可配置（建议使用环境变量或配置文件）。
|
||
|
||
## 5. 待确认事项
|
||
1. **日本市场数据源**：Alpha Vantage 对日本市场的财务报表支持程度需在实施阶段验证。
|
||
2. **具体的财务指标**：用户需通过文档或沟通确认具体需要计算哪些指标。
|