少数派抽奖系统文档
实时少数派游戏平台 — 面向 BUCSSA 等大型线下活动的多人互动抽奖系统。
双认证场景：国内 — Player 6 位登录码，Admin/Display 邮箱+密码；美国 — 三端 OAuth（Google / Azure AD）。另支持玩家编号显示名、Spring / Mario 双主题。
本站点按 Diátaxis 框架组织，便于快速上手、查阅 API 与理解架构。
文档导航
| 分类 | 说明 | 入口 |
|---|---|---|
| 概览 | 项目介绍、功能、架构 | Introduction |
| 入门指南 | 安装与快速上手 | Quick Start |
| 用户指南 | 认证场景、登录码、三端操作 | 认证场景 · 登录码流程 |
| API 参考 | REST + WebSocket | REST API |
| 配置 | 环境变量与运行时选项 | Environment Variables |
| 部署指南 | 本地 / 生产部署 | Production Deployment |
| 开发者指南 | 代码架构与扩展 | Project Structure |
| 故障排查 | 排错与调试 | Common Errors |
| 常见问题 | FAQ | FAQ |
| 参与贡献 | 贡献指南 | Development Setup |
快速链接
| 页面 | 路径 | 用户 |
|---|---|---|
| 首页 | / | 公开 |
| 玩家登录 | /login | 国内：6 位码 · 美国：OAuth |
| 工作人员登录 | /staff-login | 国内：邮箱+密码 · 美国：一般用 /login OAuth |
| 玩家端 | /play | Player |
| 管理端 | /admin | Admin |
| 展示端 | /show | Display |
| 健康检查 | GET /health | 运维 |
本地开发：Backend :4000 + Frontend :3000 + Redis
技术栈
Next.js 15 · React 19 · Express 5 · Socket.IO 4.8 · Redis 5.6 · PostgreSQL · NextAuth
完整列表见 Tech Stack。
上游与参考
本文档描述部内部署与业务逻辑；框架 API、环境变量与排错细节请查上游官方文档。
| 项目 | 官方文档 | 源码 |
|---|---|---|
| Next.js | nextjs.org/docs | vercel/next.js |
| Socket.IO | socket.io/docs/v4 | socketio/socket.io |
| Redis | redis.io/docs | redis/redis |
| Prisma | prisma.io/docs | prisma/prisma |
| NextAuth.js | next-auth.js.org | nextauthjs/next-auth |