订单日报系统 - Python Flask版本

一个基于Python Flask的订单日报自动生成系统，用于公交等企业的订单报表自动生成。

功能特性

• ✅ 定时生成：每天早上8:01自动生成前一天的日报
• ✅ 配置管理：支持创建、编辑、删除、启用/禁用、排序
• ✅ 日报生成：按配置+时间范围生成
• ✅ 自定义字段：100+字段可选，中文显示
• ✅ 求和功能：支持多字段求和
• ✅ 按企业/用户拆分：灵活选择拆分方式
• ✅ 预设时间：昨天、最近3天、最近7天
• ✅ 自定义时间：任意时间范围
• ✅ Excel导出：格式化Excel文件
• ✅ 历史记录：查看、下载、批量下载

技术栈

• 后端：Python 3.8+ / Flask 3.0
• 数据库：MySQL / Apache Doris（PyMySQL驱动）
• Excel：openpyxl
• 定时任务：APScheduler
• 前端：原生HTML + CSS + JavaScript

项目结构

.
├── app.py                      # Flask主应用
├── requirements.txt            # Python依赖
├── lib/                        # 业务逻辑
│   ├── __init__.py
│   ├── db.py                   # 数据库连接
│   ├── field_mapping.py        # 字段映射
│   └── report_generator.py     # 日报生成
├── templates/                  # HTML模板
│   └── index.html              # 主页面
├── public/reports/             # Excel文件存储
└── README.md                   # 本文件

快速开始

1. 安装Python依赖

pip install -r requirements.txt

2. 配置数据库

编辑 lib/db.py，修改数据库连接信息：

DB_CONFIG = {
    'host': 'haoslm2.xicp.net',
    'port': 10216,
    'user': 'root',
    'password': 'DsideaL147258369',
    'database': 'yltcharge',
    'charset': 'utf8mb4',
    'cursorclass': pymysql.cursors.DictCursor
}

3. 启动服务

python app.py

服务将在 http://localhost:5000 启动。

4. 初始化数据库

首次运行需要初始化数据库表：

访问：http://localhost:5000/api/init-tables

或运行：

curl -X POST http://localhost:5000/api/init-tables

5. 使用系统

1. 打开浏览器访问：http://localhost:5000
2. 切换到"配置管理"标签，创建配置
3. 切换到"日报生成"标签，生成日报
4. 切换到"历史记录"标签，查看和下载日报

API接口

配置管理

• GET /api/config - 获取所有配置
• POST /api/config - 创建配置
• PUT /api/config/<id> - 更新配置
• DELETE /api/config/<id> - 删除配置
• POST /api/config/<id>/toggle - 启用/禁用配置
• POST /api/config/reorder - 重新排序

日报生成

• POST /api/report/generate - 生成日报
• GET /api/report/history - 获取历史记录
• GET /api/download - 下载Excel文件

数据库

• POST /api/init-tables - 初始化数据库表

数据库表结构

t_daily_report_config（配置表）

• id - 配置ID
• config_name - 配置名称
• split_type - 拆分方式（company_id/user_id）
• split_value - 拆分值
• split_name - 拆分显示名称
• selected_fields - 选择的字段（JSON）
• sum_fields - 求和字段（JSON）
• is_active - 是否启用
• sort_order - 排序顺序
• create_time - 创建时间
• update_time - 更新时间

t_daily_report_history（历史表）

• id - 记录ID
• report_date - 报表日期
• start_time - 开始时间
• end_time - 结束时间
• split_type - 拆分方式
• split_value - 拆分值
• split_name - 拆分显示名称
• config_id - 配置ID
• config_name - 配置名称
• total_orders - 订单总数
• total_amount - 总金额
• sum_results - 求和结果（JSON）
• file_path - 文件路径
• status - 状态（0=失败，1=成功）
• error_msg - 错误信息
• create_time - 创建时间

定时任务

系统内置定时任务，每天8:01（北京时间）自动生成日报：

• 为所有启用的配置生成日报
• 时间范围：前一天8:00到当天8:00
• 生成的Excel文件保存在 public/reports/ 目录

Windows运行

启动服务

python app.py

常见问题

端口被占用

# 查看占用5000端口的进程
netstat -ano | findstr :5000

# 结束进程
taskkill /PID <进程ID> /F

依赖安装失败

# 使用国内镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

Linux/Mac运行

启动服务

python3 app.py

后台运行

nohup python3 app.py > app.log 2>&1 &

注意事项

1. 数据库连接：确保数据库地址、端口、用户名、密码正确
2. 字段映射：使用实际数据库中的字段名，参考 lib/field_mapping.py
3. 文件权限：确保 public/reports/ 目录有写入权限
4. 定时任务：保持服务持续运行，定时任务才会执行

许可证

MIT License