docs: 添加 README 文档

README.md

@@ -0,0 +1,77 @@
+# 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`
+
+### 安装
+
+```bash
+pip install requests python-dotenv
+```
+
+### 配置
+
+创建 `.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
+
+# 班次交接报告
+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