gloria/AGENTS.md

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

运行方式

# 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