快速开始
1. 配置 Staff 账号
frontend/src/lib/auth.ts:
const ADMIN_EMAILS = ['your-admin@gmail.com'];
const DISPLAY_EMAILS = ['your-display@gmail.com'];
frontend/.env.local:
STAFF_ADMIN_PASSWORD=your-admin-password
STAFF_DISPLAY_PASSWORD=your-display-password
2. 启动服务
# 终端 1
cd backend && npm run dev
# 终端 2
cd frontend && npm run dev
3. 工作人员登录
- 打开 http://localhost:3000/staff-login
- Admin 邮箱 +
STAFF_ADMIN_PASSWORD→ 自动进入/admin - 另开浏览器,Display 邮箱 +
STAFF_DISPLAY_PASSWORD→/show
4. 发布登录码
- Admin 面板点击 发布登录码
- Display 大屏出现 6 位数字
- 玩家打开 http://localhost:3000/login,输入登录码
- 成功后显示「欢迎,玩家 #001」并进入
/play
5. 开始游戏
- Admin 选择预设题目 → 发布
- 玩家端出现 A/B 选项
- 倒计时结束自动结算
- 重复发题直至产生 winner 或 tie
6. 验证
curl http://localhost:4000/health
# {"status":"ok","timestamp":"..."}
访问地址
| URL | 说明 |
|---|---|
| http://localhost:3000 | 首页 |
| http://localhost:3000/login | 玩家登录码 |
| http://localhost:3000/staff-login | 工作人员 |
| http://localhost:3000/admin | 管理端 |
| http://localhost:3000/show | 大屏 |
| http://localhost:3000/play | 玩家端 |
下一步
- Example Workflow — 完整活动现场流程
- Basic Usage — 三端操作说明