# CosMoe Bot

甜奈摄影会 Telegram 机器人，基于 [grammy](https://grammy.dev) 框架，部署在 Cloudflare Workers 上。

## 功能

| 命令 | 说明 |
|---|---|
| `/start` | 显示欢迎信息和可用命令 |
| `/login` | 交互式登录 CosMoe 账户 |
| `/logout` | 登出并清除账户凭证 |
| `/events` | 查看最新活动列表 |
| `/event_{id}` | 查看活动详情和可预约时段 |
| `/book_{eventId}_{slotIndex}` | 预约活动时段 |
| `/history` | 查看进行中的预约记录 |
| `/history all` | 查看全部预约记录 |
| `/cancel_{bookingId}` | 取消预约 |

机器人每分钟自动检查新活动，并通过 Telegram 推送通知给已登录用户。

## 技术栈

- **运行时**: Cloudflare Workers
- **框架**: grammy (Telegram Bot)
- **存储**: Cloudflare KV（用户凭证、会话状态、调度数据）
- **语言**: TypeScript (ES2024)
- **测试**: Vitest + @cloudflare/vitest-pool-workers

## 开发

```bash
# 安装依赖
npm install

# 本地开发
npm run dev

# 部署
npm run deploy

# 运行测试
npm test

# 重新生成 Worker 类型
npm run cf-typegen
```

### 环境变量

在 `.dev.vars` 中配置本地开发所需的密钥：

```
BOT_TOKEN=your_telegram_bot_token
```

生产环境的密钥通过 Cloudflare Dashboard 设置。

## 项目结构

```
src/
├── index.ts              # Worker 入口（fetch + scheduled handler）
├── client/
│   └── cosmoe.ts         # CosMoe API 客户端
├── command/
│   ├── index.ts          # 命令路由和注册
│   └── handlers/         # 各命令处理器
│       ├── start.ts
│       ├── login.ts
│       ├── logout.ts
│       ├── events.ts
│       ├── eventDetails.ts
│       ├── bookEvent.ts
│       ├── cancel.ts
│       └── history.ts
└── scheduler/
    └── index.ts          # 定时任务：新活动通知
```

## License

Private