---
title: MRO Data Summary
emoji: 📊
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
---

# 多维度汇总网页工具

基于 Flask 的网页工具。支持上传单个 `.xlsx` 或 `.csv` 文件，自动生成一份结果文件，内含以下工作表：

- `原始数据`
- `SGUID汇总`
- `SKUID汇总`
- `产品线汇总`
- `字段说明`

## 功能

- 上传后自动处理，无需额外点击开始按钮
- 同一份结果文件内同时生成 `SGUID`、`SKUID`、`产品线` 三种维度汇总
- 三张汇总表都会输出 `channel`，并按“当前维度 + channel”分开统计，同时额外追加 `channel=全站点` 的合计行
- 三张汇总表都会新增 `pl_date` 列，取自 I 列 `pl_date` 的月份，并按月份汇总数据
- 结果文件会永久保存到项目目录下的 `saved_outputs/`，不会被程序自动清理
- 保留原始数据页，并附带统一的字段说明页
- 支持 `GMV = 0` 时占比输出为 `0`
- 支持缺少必要列、空表、乱码、格式错误等异常时自动生成错误说明 `xlsx`
- 记录今日、本月、近七天使用次数

## 运行

直接双击 `run_app.bat`

或手动执行：

```bash
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python app.py
```

浏览器访问 `http://127.0.0.1:5001`

## 目录

- `app.py`: Flask 入口
- `sguid_tool/processor.py`: 文件读取、三维度汇总、结果文件生成
- `sguid_tool/stats.py`: 使用次数统计
- `templates/`、`static/`: 页面模板与前端资源
- `saved_outputs/`: 自动生成并永久保留的结果文件目录
- `data/usage_stats.json`: 使用次数统计文件