mro_data_assistant / README.md
yyh1112's picture
Upload 4 files
e4a5715 verified
|
Raw
History Blame Contribute Delete
1.66 kB
---
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`: 使用次数统计文件