feat: 交接班报告支持 Confluence/Jira 集成,添加 N/A 记录时间归属功能

- 集成 Confluence API 获取船舶报告数据
- 集成 Jira API 查询故障数量
- 支持船号显示 (462#、463# 等)
- 支持故障次数/故障率、人工介入次数/介入率显示
- 跨班作业使用 Card 69 按时间查询效率
- 不跨班作业使用整船效率(剔除异常)
- N/A 记录根据作业时间归属到对应船舶
- 更新 AGENTS.md 和 README.md 文档
- 删除 daily_report_gui.py
This commit is contained in:
Developer
2026-03-14 02:52:23 +08:00
parent cc989a8ddb
commit 5d0cafac32
13 changed files with 1746 additions and 394 deletions

View File

@@ -6,14 +6,15 @@
## 概述
从飞书获取排班信息,从 Metabase 获取船舶作业数据,生成标准化日报。
从飞书获取排班信息,从 Metabase 获取船舶作业数据,从 Confluence 获取船舶报告数据,从 Jira 获取故障信息,生成标准化日报和交接班报告
## 结构
```
Gloria/
├── daily_report_gui.py # GUI入口 (Tkinter)
├── report_generator.py # CLI入口 + 核心生成逻辑
├── report_generator.py # CLI入口 + 日报生成核心
├── shift_report.py # 班次交接报告(新增)
├── feishu/ # 飞书API集成
│ ├── client.py # HTTP客户端 + Token管理
│ ├── manager.py # 排班管理器(统一入口)
@@ -21,7 +22,13 @@ Gloria/
├── metabase/ # Metabase数据查询
│ ├── time_operations.py # 按时间范围查询
│ └── vessel_operations.py # 按船舶查询
├── confluence/ # Confluence API集成新增
│ ├── client.py # Confluence HTTP客户端
│ └── vessel_reports.py # 船舶报告解析器
├── jira_client.py # Jira API客户端新增
└── template/ # 日报模板
├── daily_report_template.txt
└── shift_handover_template.txt
```
## 查找指南
@@ -29,10 +36,13 @@ Gloria/
| 任务 | 位置 |
|------|------|
| 修改日报格式 | `template/daily_report_template.txt` |
| 调整班次时间规则 | `report_generator.py:36-78` (`get_shift_time_range`) |
| 修改交接班报告格式 | `template/shift_handover_template.txt` |
| 调整班次时间规则 | `shift_report.py:69-104` (`get_shift_time_range`) |
| 添加飞书功能 | `feishu/manager.py` |
| 新增Metabase查询 | `metabase/` 对应客户端 |
| 新增Confluence查询 | `confluence/vessel_reports.py` |
| 修改GUI界面 | `daily_report_gui.py` |
| 船舶记录合并逻辑 | `shift_report.py:501-546` (`_merge_vessels_by_name`) |
## 关键约定
@@ -41,6 +51,10 @@ Gloria/
- **月底最后一天:** 08:00 ~ 23:59
- **其他日期:** 08:00 ~ 次日08:00
### 交接班班次
- **白班:** 08:00 - 20:00
- **夜班:** 20:00 - 次日08:00
### 环境变量 (.env)
```
MATEBASE_USERNAME=xxx
@@ -48,6 +62,11 @@ MATEBASE_PASSWORD=xxx
FEISHU_APP_ID=xxx
FEISHU_APP_SECRET=xxx
FEISHU_SPREADSHEET_TOKEN=xxx
CONFLUENCE_URL=https://confluence.xxx.com
CONFLUENCE_TOKEN=xxx
JIRA_URL=https://jira.xxx.com
JIRA_USERNAME=xxx
JIRA_TOKEN=xxx
```
### 运行方式
@@ -55,10 +74,27 @@ FEISHU_SPREADSHEET_TOKEN=xxx
# GUI模式
python daily_report_gui.py
# CLI模式
# 日报 (CLI)
python report_generator.py --date 2026-03-01
# 班次交接报告
python shift_report.py --date 2026-03-13 --shift day
python shift_report.py --date 2026-03-13 --shift night
python shift_report.py --date 2026-03-13 --shift all
```
## 新功能:班次交接报告
`shift_report.py` 生成班次交接报告,支持:
- **船号显示**: 从 Confluence 获取船舶编号(如 462#、463#
- **故障数据**: 从 Jira 查询故障数量(如 FZ-2042、FZ-2043
- **故障率计算**: 故障次数 / (TEU/2) * 100%
- **效率获取**:
- 不跨班:使用整船效率(剔除异常)
- 跨班:使用 Card 69 按班次时间范围查询效率
- **N/A记录处理**: Metabase 中 vesselVisitID 为 "N/A" 的记录根据作业时间归属到对应的船舶
## 依赖
- `requests` - HTTP请求
@@ -69,4 +105,5 @@ python report_generator.py --date 2026-03-01
- 程序需在 **8:00 后运行**确保最后一条船指令结束时间超过8点
- 飞书 Token 自动刷新提前30分钟续期
- Metabase 无原生 Python SDK使用 REST API
- Metabase 无原生 Python SDK使用 REST API
- Confluence 和 Jira 需要配置相应 Token 才能启用完整功能