WebSockets & Real-time Events

LearnWay uses Socket.IO with Redis-backed state replication to power synchronous multiplayer experiences and real-time alerts.

Active Gateways

Gateway	Namespace / Path	Functionality
`QuizBattleGateway`	`/quiz-battle`	1v1 matchmaking, question delivery timer, live answer submission, winner determination.
`ContestLeaderboardGateway`	`/contests`	Real-time leaderboard score broadcasts during live timed competitions.
`NotificationGateway`	`/notifications`	Live push notifications to active web and mobile user sessions.

join_queue: Client emits matchmaking ticket specifying preferred topic or random matchmaking.
match_found: Server pairs two players (or spins up a bot if matchmaking timeout triggers).
round_start: Server distributes question payload without answer keys and starts countdown.
submit_answer: Both clients submit selected option IDs with timestamp milliseconds.
round_result: Gateway broadcasts score deltas and immediate correctness feedback.
battle_complete: Final scores tallied, gems deducted/awarded, and XP distributed.