ylt_diy/docs/用户使用说明.md

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

一、系统概述

订单日报系统是一个基于 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