mhh-dianpuxiaoshouehuizong

---
name: mhh-dianpuxiaoshouehuizong
description: 中国电商平台财务数据分析工具，支持天猫、京东、拼多多、抖音、小红书5大平台。自动识别平台、聚合账单数据、与参考文件对比验证、生成Excel报表。已实现100%数据匹配率，支持23家店铺的财务数据自动化处理。
license: MIT
---

# 店铺销售额汇总

中国电商平台财务数据分析系统，支持天猫(TM)、京东(JD)、拼多多(PDD)、抖音(DY)、小红书(XHS)五大平台。

## 核心功能

- 自动平台识别：从文件夹名称自动识别平台
- 数据聚合：将多个店铺的财务数据按账单类型聚合...

---
name: mhh-dianpuxiaoshouehuizong
description: 中国电商平台财务数据分析工具，支持天猫、京东、拼多多、抖音、小红书5大平台。自动识别平台、聚合账单数据、与参考文件对比验证、生成Excel报表。已实现100%数据匹配率，支持23家店铺的财务数据自动化处理。
license: MIT
---

# 店铺销售额汇总

中国电商平台财务数据分析系统，支持天猫(TM)、京东(JD)、拼多多(PDD)、抖音(DY)、小红书(XHS)五大平台。

## 核心功能

- 自动平台识别：从文件夹名称自动识别平台
- 数据聚合：将多个店铺的财务数据按账单类型聚合
- 数据验证：与参考文件对比验证数据准确性
- Excel报表：生成包含所有平台的综合Excel报表
- 编码转换：自动处理GBK到UTF-8的编码转换
- 批量处理：支持批量处理多个店铺的数据

## 支持的平台

| 平台 | 文件夹识别关键词 | 文件类型 |
|------|----------------|----------|
| 天猫 | tm, 天猫, tmall | xlsx, csv, zip |
| 京东 | jd, 京东, jingdong | xlsx, csv, zip |
| 拼多多 | pdd, 拼多多, pinduoduo | xlsx, csv, zip |
| 抖音 | dy, 抖音, douyin | csv, png |
| 小红书 | xhs, 小红书, xiaohongshu | xlsx |

## 快速开始

```python
import sys
from pathlib import Path

# 添加skills目录到路径
skills_dir = Path("skills").resolve()
sys.path.insert(0, str(skills_dir))

# 导入run_analysis函数
from ecommerce_financial_analysis import run_analysis

# 分析指定目录中的所有平台
results = run_analysis(base_dir="/path/to/data/directory")
```

## 数据映射规则

每个平台都有特定的账单类型映射规则，详见 references/mappings.md

### 天猫核心映射

- 商品货款 → 交易收款
- 交易佣金 → 淘宝客佣金
- 营销费用 → 万相台充值
- 转账 → 根据备注内容分类

### 京东核心映射

- 货款 → 交易收入
- 佣金 → 佣金
- 服务费 → 服务费
- 提现 → 提现

### 拼多多核心映射

- 订单收入 → 交易收入
- 技术服务费 → 基础技术服务费
- 多多进宝 → 营销费用-多多进宝

## 输出格式

生成的Excel文件(店铺数据.xlsx)包含：

1. 平台工作表 - 每个平台一个工作表
   - 天猫
   - 京东
   - 拼多多
   - 小红书
   - 抖音

2. 汇总工作表
   - 销售 - 所有平台销售汇总
   - 提现 - 所有平台提现汇总
   - 业务空白 - 天猫业务描述为空的记录

## 核心组件

- platform_detector.py - 平台检测器
- shop_detector.py - 店铺检测器
- file_processor.py - 文件处理器
- tmall_analysis.py - 天猫分析器
- jd_analysis.py - 京东分析器
- pdd_analysis.py - 拼多多分析器
- douyin_analysis.py - 抖音分析器
- xiaohongshu_analysis.py - 小红书分析器
- excel_generator.py - Excel生成器
- data_validator.py - 数据验证器

## 数据库结构

每个平台都有独立的SQLite数据库，包含以下表：

- shops - 店铺信息
- bills - 账单明细
- errors - 错误记录

## 使用方法

1. 将电商数据按平台分类到不同的文件夹
2. 确保文件夹名称包含平台识别关键词
3. 运行run_analysis函数
4. 查看生成的Excel报表

## 注意事项

- CSV文件使用GBK编码，系统会自动转换
- 一个店铺的数据只在其对应的文件夹中
- 需要先解压zip文件
- 数据库和Excel文件会生成在"分析结果"文件夹中
- 原始数据不会被修改

## 文档

- QUICK_REFERENCE.md - 快速参考指南
- TROUBLESHOOTING.md - 故障排除指南
- references/mappings.md - 完整的账单类型映射
- references/database-schema.md - 数据库结构