# TG Live Game Hono 后端 - Claude Code 配置

> 2级子项目配置 | 继承自 tg-live-game (1级)

## 项目信息

| 属性 | 值 |
|------|-----|
| 项目名称 | tg-live-game-hono |
| 所属项目 | tg-live-game |
| 项目类型 | backend (后端 API) |
| 框架 | Hono 4.x |
| 运行时 | Cloudflare Workers |
| 数据库 | Cloudflare D1 (SQLite) |

## 技术栈

| 类别 | 技术 | 版本 |
|------|------|------|
| 框架 | Hono | 4.11.1 |
| 运行时 | Cloudflare Workers | - |
| 数据库 | Cloudflare D1 | - |
| 验证 | Zod | 4.3.5 |
| 语言 | TypeScript | 5.9.3 |
| 测试 | Vitest | 3.2.4 |
| Lint | Biome | 2.3.11 |
| 部署 | Wrangler | 4.56.0 |

## 项目结构

```
src/
├── index.ts              # 应用入口
├── node.ts               # Node.js 本地开发入口
├── middleware/           # 中间件
│   └── auth.ts          # JWT 认证 + RBAC 权限
├── routes/              # API 路由
│   ├── auth.ts         # 认证接口
│   ├── user.ts         # 用户管理 (admin only)
│   ├── cameras.ts      # 摄像头管理
│   ├── sessions.ts     # 会话管理
│   ├── stats.ts        # 观看统计
│   ├── stream.ts       # Cloudflare Stream
│   └── audit.ts        # 审计日志
├── services/            # 业务服务
├── types/               # TypeScript 类型
└── utils/               # 工具函数
```

## API 路由

### 公开接口
| 方法 | 路由 | 描述 |
|------|------|------|
| POST | `/api/auth/login` | 用户登录 |
| POST | `/api/auth/refresh` | 刷新 Token |

### 认证接口
| 方法 | 路由 | 描述 |
|------|------|------|
| GET | `/api/auth/me` | 获取当前用户 |
| POST | `/api/auth/logout` | 退出登录 |
| GET/POST/PUT/DELETE | `/api/users/*` | 用户管理 (admin) |
| GET/POST/PUT/DELETE | `/api/cameras/*` | 摄像头管理 |
| GET/POST/DELETE | `/api/stream/*` | Stream 管理 |
| GET | `/api/stats/*` | 观看统计 |
| GET | `/api/audit/*` | 审计日志 |

## RBAC 角色

| 角色 | 权限 |
|------|------|
| admin | 所有权限 |
| operator | 摄像头/视频/直播管理 |
| viewer | 只读访问 |

## 部署信息

| 属性 | 值 |
|------|------|
| Worker 名称 | tg-live-game-api |
| 域名 | https://tg-live-game-api.ifoodme.com |
| D1 Database ID | 970f081e-42c8-46bb-b385-b7c1ab2ceaa5 |

## 开发命令

```bash
pnpm install          # 安装依赖
pnpm dev              # 本地开发 (使用本地 D1)
pnpm dev:remote       # 远程开发 (使用远程 D1)
pnpm typecheck        # 类型检查
pnpm test             # 运行测试
pnpm lint             # 代码检查
pnpm deploy           # 部署
```

### D1 数据库操作

```bash
# 本地执行 SQL
npx wrangler d1 execute tg_live_game --command "SELECT * FROM users;"

# 远程执行 SQL
npx wrangler d1 execute tg_live_game --remote --command "SELECT * FROM users;"
```

## 核心文档

| 文档 | 位置 | 内容 |
|------|------|------|
| 子系统架构 | `architecture.canvas` | API 架构图 |
| 数据库设计 | `d1-database.canvas` | D1 表结构 |
| 认证系统 | `auth-system.canvas` | JWT + RBAC |
| 整体架构 | `../architecture.canvas` | 系统架构图 |