跳到主要内容
版本：Current

本地部署

# 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

本地验证流程​

  1. http://localhost:3000/staff-login — Admin 登录
  2. http://localhost:3000/staff-login — Display（另一浏览器）
  3. Admin 发布登录码 → Show 显示码
  4. http://localhost:3000/login — 玩家输入码
  5. 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。