feat: 实现月底/月初数据调整功能
1. 新增月底/月初智能数据调整功能 - 月底最后一天自动弹出剔除数据对话框 - 月初1号自动弹出添加数据对话框 - 普通日期不弹出对话框 2. 实现月底剔除数据自动转移到次月1号 - 月底剔除的数据自动添加到次月1号统计 - 支持跨月、跨年数据转移 - 数据备注自动记录转移信息 3. 修复自动获取数据后不弹出调整对话框的问题 - 修改auto_fetch_data()方法,成功获取数据后调用调整处理 - 确保第一次打开GUI也能弹出相应对话框 4. 修复月度统计不包含调整数据的问题 - 修改get_monthly_stats()方法包含手动调整数据 - 确保调整数据正确影响月度统计 5. 恢复日报原始模板格式 - 移除调整数据的详细说明 - 保持原始日报模板,只显示最终结果 6. 数据库增强 - 新增manual_adjustments表存储手动调整数据 - 实现调整数据的增删改查方法 - 实现包含调整数据的每日数据获取方法 测试通过:所有功能正常工作,数据计算准确。
This commit is contained in:
71
README.md
71
README.md
@@ -9,6 +9,7 @@
|
||||
- SQLite3 数据库存储
|
||||
- 生成日报和月度统计
|
||||
- 支持未统计数据手动录入
|
||||
- 支持去除多余统计数据(对称功能)
|
||||
- 支持二次靠泊记录合并
|
||||
- GUI 图形界面(可选)
|
||||
- 飞书排班表集成(自动获取班次人员)
|
||||
@@ -124,6 +125,9 @@ python3 main.py config-test
|
||||
# 添加未统计数据
|
||||
python3 main.py --unaccounted 118 --month 2025-12
|
||||
|
||||
# 去除未统计数据
|
||||
python3 main.py --remove-unaccounted --month 2025-12
|
||||
|
||||
# 显示帮助
|
||||
python3 main.py --help
|
||||
```
|
||||
@@ -136,14 +140,22 @@ python3 src/gui.py
|
||||
|
||||
GUI 功能:
|
||||
- 获取并处理数据
|
||||
- 获取 (Debug模式)
|
||||
- 重置数据库(删除并重新获取)
|
||||
- 生成日报
|
||||
- 今日日报(自动获取前一天数据)
|
||||
- 添加未统计数据
|
||||
- 去除多余统计数据(对称功能)
|
||||
- 月底/月初智能调整(自动弹出对话框)
|
||||
- 数据库统计(显示当月每艘船的作业量)
|
||||
- 日报内容可复制
|
||||
- 自动刷新排班信息
|
||||
|
||||
#### 智能调整功能
|
||||
- **月初1号**:自动询问是否添加上月数据
|
||||
- **月底最后一天**:自动询问是否剔除12点后数据
|
||||
- **其他日期**:保留手动调整入口
|
||||
- **调整数据**:在日报中清晰显示,确保数据准确性
|
||||
|
||||
## 数据格式
|
||||
|
||||
### 日报表 (daily_handover_logs)
|
||||
@@ -169,6 +181,20 @@ GUI 功能:
|
||||
| note | TEXT | 备注 |
|
||||
| created_at | TEXT | 创建时间 |
|
||||
|
||||
### 手动调整表 (manual_adjustments)
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| id | INTEGER | 主键 |
|
||||
| date | TEXT | 调整适用的日期 YYYY-MM-DD |
|
||||
| ship_name | TEXT | 船名 |
|
||||
| teu | INTEGER | TEU数量 |
|
||||
| twenty_feet | INTEGER | 20尺箱量 |
|
||||
| forty_feet | INTEGER | 40尺箱量 |
|
||||
| adjustment_type | TEXT | 调整类型 'add' 或 'exclude' |
|
||||
| note | TEXT | 备注 |
|
||||
| created_at | TEXT | 创建时间 |
|
||||
|
||||
## 特性说明
|
||||
|
||||
### 二次靠泊合并
|
||||
@@ -183,6 +209,49 @@ GUI 功能:
|
||||
|
||||
可以在数据库统计中查看当月每艘船的作业量总计,便于跟踪船舶运营情况。
|
||||
|
||||
### 去除多余统计数据
|
||||
|
||||
针对月底夜班箱量有时会被算入下个月的情况,系统提供了对称的"去除多余统计数据"功能:
|
||||
- **添加未统计数据**: 用于补全缺失的箱量
|
||||
- **去除未统计数据**: 用于删除多余统计的箱量
|
||||
|
||||
这两个功能配合使用,可以精确调整月度统计数据。
|
||||
|
||||
### 月底/月初数据调整功能
|
||||
|
||||
系统支持智能化的月底/月初数据调整:
|
||||
|
||||
#### 1. 月底最后一天(自动剔除12点后数据)
|
||||
- 当获取数据的日期为月份最后一天时,GUI会自动询问是否需要剔除12点后的数据
|
||||
- 用户可以输入需要剔除的船名、TEU以及具体尺寸(20尺/40尺)
|
||||
- 剔除后的数据会从当月统计中移除,计入下月统计
|
||||
|
||||
#### 2. 月初1号(自动添加上月数据)
|
||||
- 当获取数据的日期为月份1号时,GUI会自动询问是否需要添加上月的作业数据
|
||||
- 用户可以输入需要添加的船名、TEU以及具体尺寸(20尺/40尺)
|
||||
- 添加的数据会计入上月统计,确保月度数据的准确性
|
||||
|
||||
#### 3. 其他日期(手动调整入口)
|
||||
- 非月初和月底的日期,默认不弹出调整对话框
|
||||
- 但GUI侧边栏保留了手动添加/剔除TEU的功能入口
|
||||
- 用户可以随时手动调整任何日期的数据
|
||||
|
||||
#### 4. 调整数据存储
|
||||
所有手动调整数据存储在 `manual_adjustments` 表中:
|
||||
- `date`: 调整适用的日期
|
||||
- `ship_name`: 船名
|
||||
- `teu`: TEU数量
|
||||
- `twenty_feet`: 20尺箱量
|
||||
- `forty_feet`: 40尺箱量
|
||||
- `adjustment_type`: 'add' 或 'exclude'
|
||||
- `note`: 备注信息
|
||||
|
||||
#### 5. 日报显示
|
||||
调整数据会在日报中清晰显示:
|
||||
- 每艘船下方显示具体的添加/剔除记录
|
||||
- 日报末尾显示调整汇总信息
|
||||
- 净调整量计算,确保数据准确性
|
||||
|
||||
## 示例输出
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user