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:
47
AGENTS.md
47
AGENTS.md
@@ -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 才能启用完整功能
|
||||
|
||||
Reference in New Issue
Block a user