本地部署
# 1. Redis
redis-server
# 2. 环境变量 — 见 Configuration/Environment-Variables.md
# 3. DB
cd frontend && npx prisma migrate dev
cd ../backend && npx prisma generate
# 4. 启动
cd backend && npm run dev # :4000
cd frontend && npm run dev # :3000
本地验证流程
- http://localhost:3000/staff-login — Admin 登录
- http://localhost:3000/staff-login — Display(另一浏览器)
- Admin 发布登录码 → Show 显示码
- http://localhost:3000/login — 玩家输入码
- Admin 发题 → 玩家答题
一键脚本
./start.sh
常见问题
| 问题 | 解决 |
|---|---|
| Staff 登录失败 | 检查邮箱在白名单 + 密码 env |
| 登录码无效 | Admin 是否 publish;Redis key 是否存在 |
| verify-code 网络错误 | Backend 是否运行;API_BASE 是否正确 |
| 端口占用 | lsof -ti:4000 | xargs kill -9 |
Mario 主题本地预览
NEXT_PUBLIC_THEME=mario
重启 npm run dev。