# 订单日报系统 用户使用说明

## 一、系统概述

订单日报系统是一个基于 Flask 的 Web 应用，用于自动生成充电订单的日报报表。系统支持按企业/用户/场站拆分数据，自定义字段和求和功能，并支持合并特来电平台数据。

## 二、登录系统

1. 打开浏览器，访问系统地址（如：http://localhost:5000）
2. 在登录页面输入用户名和密码
3. 点击"登录"按钮进入系统

## 三、配置管理

### 3.1 创建配置

1. 在"配置管理"页面点击"创建配置"按钮
2. 填写配置名称（如：西南79路）
3. 选择拆分方式：
   - 按企业：按企业ID拆分数据
   - 按用户：按用户ID拆分数据
   - 按场站：按场站ID拆分数据
4. 搜索并选择拆分对象（可多选）
5. 在"选择字段"区域勾选需要在报表中显示的字段
6. （可选）在"字段顺序"区域调整字段显示顺序和自定义表头名称
7. （可选）勾选"合并特来电平台数据"并输入车量自编号
8. （可选）配置分时段电量统计（尖峰平谷）
9. （可选）配置自定义服务费和实收总金额
10. 点击"保存"按钮完成创建

### 3.2 编辑配置

1. 在配置列表中找到目标配置
2. 点击"编辑"按钮
3. 修改需要调整的配置项
4. 点击"保存"按钮

### 3.3 复制配置

1. 在配置列表中找到目标配置
2. 点击"复制"按钮
3. 系统会自动创建一个"配置名_副本"的新配置
4. 可根据需要修改新配置

### 3.4 启用/禁用配置

1. 在配置列表中找到目标配置
2. 点击"启用"或"禁用"按钮
3. 禁用的配置不会参与定时任务自动生成

### 3.5 删除配置

1. 在配置列表中找到目标配置
2. 点击"删除"按钮
3. 确认删除操作

## 四、日报生成

### 4.1 手动生成日报

1. 切换到"日报生成"页面
2. 选择需要生成的配置（可多选）
3. 选择报表日期（默认昨天）
4. 点击"生成日报"按钮
5. 等待生成完成，可查看生成结果

### 4.2 定时任务

系统每天 08:01 自动执行日报生成任务，遍历所有启用的配置逐一生成日报。

## 五、历史记录

### 5.1 查看历史记录

1. 切换到"历史记录"页面
2. 可按日期范围和配置名称筛选
3. 查看每条记录的状态（成功/失败）、订单数、总电量等信息

### 5.2 下载报表

1. 在历史记录列表中找到目标记录
2. 点击"下载"按钮
3. 浏览器会自动下载报表文件

### 5.3 删除历史记录

1. 在历史记录列表中找到目标记录
2. 点击"删除"按钮，或勾选多条记录后点击"批量删除"
3. 确认删除操作

## 六、求和数据

### 6.1 查看求和数据

1. 切换到"求和数据"页面
2. 可按日期范围、配置名称、数据来源筛选
3. 表格显示各配置的每日求和数据，包括：
   - 充电电量（必选字段）
   - 分时电量（尖、峰、平、谷）
   - 其他配置的求和字段

### 6.2 从历史采集

1. 在"求和数据"页面选择日期范围
2. 点击"从历史采集"按钮
3. 确认操作后，系统会从历史记录中采集求和数据
4. **注意**：会先清除该日期范围内旧的自动采集数据

### 6.3 手动添加

1. 点击"手动添加"按钮
2. 填写报表日期、配置名称、拆分方式、拆分值等信息
3. 输入各求和字段的值（至少输入一个）
4. （可选）填写备注/修改原因
5. 点击"保存"按钮

### 6.4 编辑求和数据

1. 在求和数据列表中找到目标记录
2. 点击"编辑"按钮
3. 修改求和字段的值
4. （可选）填写修改原因
5. 点击"保存"按钮

### 6.5 删除求和数据

1. 在求和数据列表中找到目标记录
2. 点击"删除"按钮，或勾选多条记录后点击"批量删除"
3. 确认删除操作

### 6.6 导出求和数据

1. 在"求和数据"页面选择筛选条件
2. 点击"导出"按钮
3. 系统会生成 Excel 文件并下载

### 6.7 全局配置（重要）

**功能说明**：控制求和数据采集和显示的字段范围，避免采集和显示不需要的数据。

**操作步骤**：

1. 在"求和数据"页面点击"全局配置"按钮
2. 在弹出的配置窗口中，勾选需要采集和显示的字段
3. **注意**：充电电量（charge_degree）是必选字段，始终采集和显示
4. 取消勾选不需要的字段（如电费金额、服务费金额等）
5. 点击"保存"按钮
6. 页面会自动刷新，只显示勾选的字段

**可配置字段**：

| 字段名称 | 说明 |
|----------|------|
| 尖时电量(kWh) | 尖时段充电电量 |
| 峰时电量(kWh) | 峰时段充电电量 |
| 平时电量(kWh) | 平时段充电电量 |
| 谷时电量(kWh) | 谷时段充电电量 |
| 实收电费(元) | 实际收取的电费金额 |
| 实收服务费(元) | 实际收取的服务费金额 |
| 实收总金额(元) | 实际收取的总金额（电费+服务费） |
| 充电次数 | 充电订单次数 |
| 自定义服务费(元) | 按自定义单价计算的服务费 |
| 自定义实收总金额(元) | 实收电费+自定义服务费 |

**配置生效范围**：
- **采集时**：从历史记录采集数据时，只采集勾选的字段
- **显示时**：求和数据页面只显示勾选的字段
- **向后兼容**：如果没有配置任何字段，则采集和显示所有字段

## 七、常见问题

### 7.1 配置加载失败

**问题**：编辑配置时提示"加载配置失败: selectedFields is not defined"

**解决**：系统已修复此问题，请刷新页面重试。

### 7.2 报表生成失败

**问题**：生成日报时提示错误

**解决**：
- 检查配置是否正确（拆分方式、拆分值、字段选择等）
- 确认订单数据存在
- 查看日志文件（/app/work/logs/bypass/）

### 7.3 求和数据显示字段过多

**问题**：求和数据页面显示了不需要的字段

**解决**：
- 点击"全局配置"按钮
- 取消勾选不需要的字段
- 点击"保存"按钮

### 7.4 充电电量显示为0或空

**问题**：求和数据中充电电量为0或显示"-"

**解决**：
- 检查对应日期是否有充电订单数据
- 尝试重新从历史采集数据

### 7.5 手动添加的数据不显示

**问题**：手动添加求和数据后，页面不显示

**解决**：
- 确认添加操作成功（弹出"添加成功"提示）
- 刷新页面查看
- 检查筛选条件是否正确

### 7.6 配置名称搜索自动填充用户名

**问题**：配置名称搜索框自动填充了登录用户名

**解决**：搜索框已设置 `autocomplete="off"`，请清除浏览器缓存后重试。

## 八、快捷键

| 快捷键 | 功能 |
|--------|------|
| Ctrl + Enter | 搜索（在搜索框中） |

## 九、系统要求

### 浏览器要求

- Chrome 90+
- Firefox 88+
- Edge 90+

### 分辨率要求

- 推荐分辨率：1920×1080 及以上
- 最小分辨率：1280×720