# 财务报表数据处理工具集

这是一套用于处理财务报表数据的 Python 工具集，包含资产负债表和利润表处理功能。

---

## 📋 工具列表

### 主程序：财务报表统一处理工具 ⭐ 推荐使用

**脚本**：`main.py`

**主要功能**：

-   🔍 **自动识别**：智能识别资产负债表和利润表文件
-   📊 **统一处理**：自动调用对应的处理工具
-   📁 **合并输出**：将两个报表合并到一个 Excel 的不同 Tab 页
-   🎯 **智能命名**：自动清理文件名，去除"合并报表"等冗余文字
-   💯 **单位统一**：所有数据统一转换为亿（保留 2 位小数）

### 1. 资产负债表处理工具

**脚本**：`process_balance_sheet.py`

**主要功能**：

-   按照预定义分类重新组织数据
-   自动计算分类汇总
-   数字转换为亿（保留 2 位小数）
-   第一行显示日期
-   统一输出为 Excel 格式

**详细说明**：📖 [资产负债表处理说明.md](资产负债表处理说明.md)

### 2. 利润表处理工具

**脚本**：`process_income_statement.py`

**主要功能**：

-   将大数字转换为以亿为单位（保留 2 位小数）
-   保留小数/比率不变
-   删除指定的无用行
-   第一行显示日期
-   统一输出为 Excel 格式

**详细说明**：📖 [利润表处理说明.md](利润表处理说明.md)

---

## 🗂️ 目录结构

```
organize_excel_data/
├── config/                                    # 配置文件目录
│   ├── balance_sheet_categories.json         # 资产负债表分类配置
│   └── income_statement_config.json          # 利润表配置
├── input/                                     # 输入文件目录
│   ├── *资产负债表*.csv/*.xlsx               # 资产负债表文件
│   └── *利润表*.csv/*.xlsx                   # 利润表文件
├── output/                                    # 输出文件目录
│   └── *.xlsx                                # 处理结果（包含多个 Tab）
├── main.py                                   # 主程序（推荐使用）⭐
├── process_balance_sheet.py                  # 资产负债表处理脚本
├── process_income_statement.py               # 利润表处理脚本
├── README.md                                 # 总体说明文档（本文件）
├── 资产负债表处理说明.md                     # 资产负债表详细说明
└── 利润表处理说明.md                          # 利润表详细说明
```

---

## 🚀 快速开始

### 1. 环境准备

确保已安装 Python 3 和必要的依赖库：

```bash
pip install pandas openpyxl
```

或使用：

```bash
pip install -r requirements.txt
```

### 2. 准备数据

将待处理的文件放入 `input/` 目录：

-   资产负债表文件（建议文件名包含"资产负债表"）
-   利润表文件（建议文件名包含"利润表"）

### 3. 运行相应脚本

**处理资产负债表：**

```bash
python3 process_balance_sheet.py
```

**处理利润表：**

```bash
python3 process_income_statement.py
```

### 4. 查看结果

处理完成后，文件将保存在 `output/` 目录下：

-   资产负债表：`organized_原文件名.xlsx`
-   利润表：`processed_原文件名.xlsx`

---

## 📊 处理效果对比

### 资产负债表

| 处理前           | 处理后           |
| ---------------- | ---------------- |
| 数据分散，无分类 | 按 9 大类组织    |
| 无汇总数据       | 自动计算汇总     |
| 一、资产总计     | 资产总计（简化） |
| 股票代码在第一行 | 日期在第一行     |
| 数据保持原始单位 | 数据保持原始单位 |

**输出示例：**

```
日期              2024/12/31    2023/12/31    ...
资产总计           604,352亿     486,038亿     ...
所有者权益合计      227,667亿     174,300亿     ...
负债合计           376,684亿     311,739亿     ...
类现金            216,678亿     142,001亿     ... ← 汇总行
  货币资金        140,410亿      81,674亿     ...
  交易性金融资产     6,936亿       1,791亿     ...
```

### 利润表

| 处理前             | 处理后                  |
| ------------------ | ----------------------- |
| 数据单位为"元"     | 转换为"亿"（保留 2 位） |
| 包含无用信息行     | 删除指定行              |
| 股票代码在第一行   | 日期在第一行            |
| 营业收入: 4.07E+11 | 营业收入: 4071.50       |
| 毛利率: 0.2642     | 毛利率: 0.2642（不变）  |

**转换规则：**

-   大数字（≥1）→ 转换为亿（保留 2 位小数）
-   小数/比率（<1）→ 保持不变

---

## ⚙️ 配置说明

### 资产负债表配置

**文件**：`config/balance_sheet_categories.json`

**用途**：定义分类和项目归属

**示例**：

```json
{
    "categories": [
        {
            "name": "类现金",
            "items": ["货币资金", "交易性金融资产", "衍生金融资产(流动)"]
        }
    ]
}
```

### 利润表配置

**文件**：`config/income_statement_config.json`

**用途**：定义需要删除的行

**示例**：

```json
{
    "rows_to_delete": ["股票代码", "上市公司", "财报类型", "货币"]
}
```

---

## 💡 使用场景

### 场景 1：财务分析

-   快速查看资产负债结构
-   按分类汇总查看各类资产/负债占比
-   利润表数据单位统一，便于分析

### 场景 2：数据对比

-   多年度数据横向对比
-   分类汇总数据纵向对比
-   Excel 格式便于制作图表

### 场景 3：报告制作

-   处理后的数据格式规范
-   可直接用于报告和演示
-   减少手工整理时间

---

## ⚠️ 注意事项

### 通用事项

1. 支持的输入文件格式：`.csv`、`.xlsx`、`.xls`
2. 输出文件格式：统一为 `.xlsx`（Excel 格式）
3. CSV 文件使用 UTF-8 编码
4. 脚本会自动处理 `input/` 目录下的相关文件
5. 输出文件会覆盖同名的已有文件

### 资产负债表特别注意

-   项目名称必须与原始数据完全匹配
-   数据保持原始单位，不进行转换
-   汇总计算会自动处理空值

### 利润表特别注意

-   绝对值 ≥ 1 的数字会转换为亿
-   绝对值 < 1 的数字保持不变
-   转换后可能损失精度（保留 2 位小数）

---

## 🔧 常见问题

### Q1: 如何批量处理多个文件？

**A**: 将所有文件放入 `input/` 目录，运行相应脚本即可自动处理所有文件。

### Q2: 处理后的数据准确吗？

**A**:

-   资产负债表：数据保持原样，仅重新组织
-   利润表：大数字转换为亿，保留 2 位小数，比率保持不变

### Q3: 如何修改配置？

**A**:

-   资产负债表：编辑 `config/balance_sheet_categories.json` 添加/修改分类
-   利润表：编辑 `config/income_statement_config.json` 添加/删除要删除的行

### Q4: 文件没有被处理怎么办？

**A**:

1. 检查文件是否在 `input/` 目录
2. 检查文件名是否包含关键词（资产负债表/利润表）
3. 查看脚本输出的提示信息

### Q5: 如何查看详细说明？

**A**: 查看对应的详细说明文档：

-   资产负债表：[资产负债表处理说明.md](资产负债表处理说明.md)
-   利润表：[利润表处理说明.md](利润表处理说明.md)

---

## 📖 详细文档

-   📘 [资产负债表处理说明.md](资产负债表处理说明.md) - 资产负债表处理详细说明
-   📙 [利润表处理说明.md](利润表处理说明.md) - 利润表处理详细说明
-   📗 [更新日志.md](更新日志.md) - 版本更新历史

---

## 🎯 版本历史

### v1.2 (2025-11-09)

**资产负债表：**

-   优化输出：第一行显示日期而非股票代码
-   简化名称：特殊分类使用配置中的 name
-   完善分类配置：新增多个遗漏的资产负债项目

**利润表：**

-   新增利润表处理工具
-   数字单位转换为亿（保留 2 位小数）
-   删除指定的无用行

### v1.1 (2025-11-09)

-   优化输出格式：统一输出为 `.xlsx` 格式
-   新增分类汇总功能：自动计算每个分类的金额总和
-   优化特殊分类显示

### v1.0 (2025-11-09)

-   初始版本
-   支持 CSV 和 Excel 文件输入
-   支持自定义分类配置
-   自动处理批量文件

---

## 📞 技术支持

如有问题或建议，请：

1. 查看详细说明文档
2. 检查配置文件格式
3. 查看脚本输出的提示信息

---

**祝使用愉快！🎉**