vibe-coding-cn/tg-live-game/CLAUDE.md

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

多项目协作开发规范

启动方式

# 在父目录启动 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	依赖任务（需先完成）	可选

代码提交

分别在各子项目目录提交：

# 后端
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)

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

前端 (tg-live-game-web)

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