236 lines
6.8 KiB
Markdown
236 lines
6.8 KiB
Markdown
# 订单日报系统 用户使用说明
|
||
|
||
## 一、系统概述
|
||
|
||
订单日报系统是一个基于 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 |