# TG Live Game - Claude Code 配置

## 项目信息

| 属性 | 值 |
|------|-----|
| 项目名称 | tg-live-game |
| 项目类型 | project-group (多项目组) |
| 包含子项目 | tg-live-game-hono (后端), tg-live-game-web (前端) |

## 子项目

| 子项目 | 类型 | 技术栈 | 目录 |
|--------|------|--------|------|
| tg-live-game-hono | 后端 API | Hono + Cloudflare Workers + D1 | `./tg-live-game-hono/` |
| tg-live-game-web | 前端应用 | Vue 3 + TypeScript + Vite | `./tg-live-game-web/` |

## 关联配置

### Obsidian 文档路径
```
文档根目录: /Users/yibu/dev_workspace/vibe-coding-cn
项目文档:   /Users/yibu/dev_workspace/vibe-coding-cn/tg-live-game
```

### Vibe Kanban 项目
| 项目 | Kanban ID |
|------|-----------|
| tg-live-game-hono | `7c6bb2ce-90a2-4e96-bc04-5facdcdb337f` |
| tg-live-game-web | `32214e97-f833-485f-8c7c-cf4d82327e0b` |

## 多项目协作开发规范

### 启动方式
```bash
# 在父目录启动 Claude Code，可同时操作前后端
cd /Users/yibu/dev_workspace/vibe-coding-cn/tg-live-game
claude
```

### 开发顺序
同时涉及前后端的功能，按以下顺序开发：
1. **后端 API** (`tg-live-game-hono/`) - 先实现接口
2. **前端调用** (`tg-live-game-web/`) - 再实现页面

### 任务关联
在 Obsidian canvas 中创建关联任务时，使用以下格式：

**后端任务**:
```
任务YYYYMMDD-NN-hono
─────────────────
后端：功能名称

project: tg-live-game-hono
related: 任务YYYYMMDD-NN-web

1. 需求描述
```

**前端任务**:
```
任务YYYYMMDD-NN-web
─────────────────
前端：功能名称

project: tg-live-game-web
related: 任务YYYYMMDD-NN-hono
depends: 任务YYYYMMDD-NN-hono

1. 需求描述
```

### 任务字段说明
| 字段 | 含义 | 必填 |
|------|------|------|
| `project` | 目标 Kanban 项目名 | ✅ |
| `related` | 关联任务编号 | 可选 |
| `depends` | 依赖任务（需先完成） | 可选 |

### 代码提交
分别在各子项目目录提交：
```bash
# 后端
cd tg-live-game-hono && git add . && git commit -m "feat: xxx"

# 前端
cd tg-live-game-web && git add . && git commit -m "feat: xxx"
```

## 系统架构

```
Mac摄像头 → RTMPS → Cloudflare Stream → HLS → tg-live-game-web
                         ↑
                    tg-live-game-hono (API)
```

## 开发命令

### 后端 (tg-live-game-hono)
```bash
cd tg-live-game-hono
npm install       # 安装依赖
npm run dev       # 本地开发 (localhost:8787)
npm run deploy    # 部署到 Cloudflare
```

### 前端 (tg-live-game-web)
```bash
cd tg-live-game-web
npm install       # 安装依赖
npm run dev       # 本地开发 (localhost:3000)
npm run build     # 构建生产版本
```

## 核心文档

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