gloria/README.md

Gloria - 福州港日报管理系统

从飞书获取排班信息，从 Metabase 获取船舶作业数据，生成标准化日报。

功能

• 日报生成: 自动生成每日作业报告
• 班次交接报告: 分别统计白班/夜班作业情况
• GUI 界面: 基于 Tkinter 的图形界面
• CLI 支持: 命令行方式运行

项目结构

Gloria/
├── daily_report_gui.py    # GUI 入口
├── report_generator.py    # 日报生成核心
├── shift_report.py        # 班次交接报告
├── feishu/                # 飞书 API 集成
├── metabase/              # Metabase 数据查询
└── template/              # 报告模板

快速开始

环境要求

• Python 3.10+
• 依赖: requests, python-dotenv

安装

pip install requests python-dotenv

配置

创建 .env 文件：

MATEBASE_USERNAME=xxx
MATEBASE_PASSWORD=xxx
FEISHU_APP_ID=xxx
FEISHU_APP_SECRET=xxx
FEISHU_SPREADSHEET_TOKEN=xxx

运行

# GUI 模式
python daily_report_gui.py

# 日报 (CLI)
python report_generator.py --date 2026-03-01

# 班次交接报告
python shift_report.py --date 2026-03-01 --shift day
python shift_report.py --date 2026-03-01 --shift night

班次时间

类型	时间范围
白班	08:00 - 20:00
夜班	20:00 - 次日 08:00

注意事项

• 程序需在 8:00 后运行，确保最后一条船指令结束时间超过 8 点
• 飞书 Token 自动刷新，提前 30 分钟续期

License

MIT