72 lines
1.9 KiB
Markdown
72 lines
1.9 KiB
Markdown
|
# GLORIA 日报管理系统
|
|||
|
|
|
|||
|
|
**生成时间:** 2026-03-03
|
|||
|
|
**语言:** Python 3.10+
|
|||
|
|
**用途:** 福州港日报生成与管理
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
|
|||
|
|
从飞书获取排班信息，从 Metabase 获取船舶作业数据，生成标准化日报。
|
|||
|
|
|
|||
|
|
## 结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Gloria/
|
|||
|
|
├── daily_report_gui.py # GUI入口 (Tkinter)
|
|||
|
|
├── report_generator.py # CLI入口 + 核心生成逻辑
|
|||
|
|
├── feishu/ # 飞书API集成
|
|||
|
|
│ ├── client.py # HTTP客户端 + Token管理
|
|||
|
|
│ ├── manager.py # 排班管理器（统一入口）
|
|||
|
|
│ └── parser.py # 月度/年度表格解析
|
|||
|
|
├── metabase/ # Metabase数据查询
|
|||
|
|
│ ├── time_operations.py # 按时间范围查询
|
|||
|
|
│ └── vessel_operations.py # 按船舶查询
|
|||
|
|
└── template/ # 日报模板
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 查找指南
|
|||
|
|
|
|||
|
|
| 任务 | 位置 |
|
|||
|
|
|------|------|
|
|||
|
|
| 修改日报格式 | `template/daily_report_template.txt` |
|
|||
|
|
| 调整班次时间规则 | `report_generator.py:36-78` (`get_shift_time_range`) |
|
|||
|
|
| 添加飞书功能 | `feishu/manager.py` |
|
|||
|
|
| 新增Metabase查询 | `metabase/` 对应客户端 |
|
|||
|
|
| 修改GUI界面 | `daily_report_gui.py` |
|
|||
|
|
|
|||
|
|
## 关键约定
|
|||
|
|
|
|||
|
|
### 班次时间规则
|
|||
|
|
- **每月1号:** 00:00 ~ 次日08:00
|
|||
|
|
- **月底最后一天:** 08:00 ~ 23:59
|
|||
|
|
- **其他日期:** 08:00 ~ 次日08:00
|
|||
|
|
|
|||
|
|
### 环境变量 (.env)
|
|||
|
|
```
|
|||
|
|
MATEBASE_USERNAME=xxx
|
|||
|
|
MATEBASE_PASSWORD=xxx
|
|||
|
|
FEISHU_APP_ID=xxx
|
|||
|
|
FEISHU_APP_SECRET=xxx
|
|||
|
|
FEISHU_SPREADSHEET_TOKEN=xxx
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 运行方式
|
|||
|
|
```bash
|
|||
|
|
# GUI模式
|
|||
|
|
python daily_report_gui.py
|
|||
|
|
|
|||
|
|
# CLI模式
|
|||
|
|
python report_generator.py --date 2026-03-01
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 依赖
|
|||
|
|
|
|||
|
|
- `requests` - HTTP请求
|
|||
|
|
- `python-dotenv` - 环境变量
|
|||
|
|
- `tkinter` - GUI (标准库)
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
- 程序需在 **8:00 后运行**，确保最后一条船指令结束时间超过8点
|
|||
|
|
- 飞书 Token 自动刷新，提前30分钟续期
|
|||
|
|
- Metabase 无原生 Python SDK，使用 REST API
|