# excelTool

**Repository Path**: chen-han-0128/excel-tool

## Basic Information

- **Project Name**: excelTool
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-27
- **Last Updated**: 2026-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 酒店订单Excel处理工具

一个用于处理酒店订单Excel文件并通过企业微信机器人发送通知的桌面应用程序。

## 功能特性

- 🏨 **Excel数据处理**：支持.xlsx和.xls格式的酒店订单文件
- 📊 **数据清洗**：自动过滤无效数据，标准化日期格式和金额
- 🤖 **企业微信集成**：支持单条、批量和定时发送订单通知
- ⚙️ **配置管理**：灵活的消息模板和Webhook配置
- 📈 **统计面板**：实时显示发送状态和统计数据
- 📝 **日志追踪**：详细的发送日志和错误报告

## 技术栈

- **后端**: Python Flask
- **前端**: HTML/CSS/JavaScript
- **数据处理**: Pandas
- **打包**: PyInstaller
- **部署**: 单一可执行文件

## 安装与运行

### 方法一：直接运行（开发者）

1. 克隆或下载项目
2. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```
3. 运行应用：
   ```bash
   python main.py
   ```
4. 在浏览器中打开 `http://127.0.0.1:5000`

### 方法二：运行打包版本（最终用户）

1. 下载打包好的可执行文件
2. 直接双击运行，无需安装Python环境

## 使用说明

### 1. 上传Excel文件

- 点击或拖拽Excel文件到上传区域
- 系统会自动清洗数据并显示预览
- 支持的字段包括：订单号、酒店名称、联系人、联系电话、房型、数量、入住日期、离店日期、总金额等

### 2. 配置Webhook

- 在"配置管理"部分添加企业微信机器人的Webhook地址
- 可以添加多个Webhook以同时发送到多个群组
- 自定义消息模板以适应不同需求

### 3. 发送订单

- **单条发送**：点击订单行的"发送"按钮
- **批量发送**：勾选多个订单，点击"批量发送"
- **定时发送**：勾选订单后，点击"定时发送"并设置发送时间

### 4. 查看日志

- 在"发送日志"部分查看历史发送记录
- 可按日期筛选日志
- 了解每条消息的发送状态和错误信息

## 数据清洗规则

- 删除订单号为空的行
- 删除总金额≤0的行
- 去除重复订单号
- 日期格式标准化为YYYY-MM-DD
- 金额保留2位小数

## 消息模板

默认消息模板为：

```markdown
## 🏨 酒店订单通知

**订单号**：{订单号}
**酒店名称**：{酒店名称}
**联系人**：{联系人} ({联系电话})
**房型**：{房型} × {数量}间
**入住日期**：{入住日期}
**离店日期**：{离店日期}
**总金额**：¥{总金额:.2f}
**订单状态**：{订单状态}
**发送时间**：{发送时间}

**备注**：{备注}
```

## 打包说明

使用以下命令打包为单个可执行文件：

```bash
python pyinstaller_build.py
```

这将创建一个独立的可执行文件，可以在没有Python环境的Windows/Mac系统上运行。

## 企业微信机器人配置

1. 在企业微信群中添加机器人
2. 复制Webhook地址
3. 在应用的配置管理中添加Webhook地址
4. 可以设置发送频率限制以防刷屏

## 故障排除

### 常见问题

1. **无法上传文件**
   - 确认文件格式为.xlsx或.xls
   - 检查文件大小是否超过限制（16MB）

2. **消息发送失败**
   - 检查Webhook地址是否正确
   - 确认网络连接正常
   - 查看发送日志中的具体错误信息

3. **数据格式错误**
   - 确认Excel中有必需字段
   - 检查日期和金额格式是否正确

### 联系支持

如遇其他问题，请联系技术支持。