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 |
只读访问 |
部署信息
开发命令
pnpm install # 安装依赖
pnpm dev # 本地开发 (使用本地 D1)
pnpm dev:remote # 远程开发 (使用远程 D1)
pnpm typecheck # 类型检查
pnpm test # 运行测试
pnpm lint # 代码检查
pnpm deploy # 部署
D1 数据库操作
# 本地执行 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 |
系统架构图 |
