How lllnightlll/math-jackbox works
math-jackbox is a real-time, multiplayer math quiz. Players register or join as guests, enter a lobby, ready up, answer timed questions, and receive match results and a global leaderboard. The sampled Java backend shows WebSocket message handling, game-state orchestration, and JPA repositories. The README contains only the project name, so frontend behavior and the Python tree’s role cannot be confirmed; those are omitted. Edges reflect sampled calls and references, with database persistence marked unverified.
Main entry points: QuizService.java Quiz Service · QuizController.java Quiz Controller · QuestionRepository.java Question Repository · PlayerRepository.java Player Repository
Components 9
Realtime Interface
- Quiz Controller
src/main/java/com/quiz/backend/controller/QuizController.java - Message DTOs
src/main/java/com/quiz/backend/dto
Quiz Gameplay
- Quiz Service
src/main/java/com/quiz/backend/service/QuizService.java
Player and Question Data
- Question Data
src/main/java/com/quiz/backend/model/Question.java - Player Data
src/main/java/com/quiz/backend/model/Player.java - Question Repository
src/main/java/com/quiz/backend/repository/QuestionRepository.java - Player Repository
src/main/java/com/quiz/backend/repository/PlayerRepository.java - Relational Database
Other components
- Players
Connections 10
- Players → Quiz Controller: send messages
src/main/java/com/quiz/backend/controller/QuizController.java - Quiz Controller → Quiz Service: dispatches actions
src/main/java/com/quiz/backend/controller/QuizController.java - Quiz Controller → Message DTOs: accepts payloads
src/main/java/com/quiz/backend/controller/QuizController.java - Quiz Service → Message DTOs: sends updates
src/main/java/com/quiz/backend/service/QuizService.java - Quiz Service → Question Repository: loads questions
src/main/java/com/quiz/backend/service/QuizService.java - Quiz Service → Player Repository: reads and saves players
src/main/java/com/quiz/backend/service/QuizService.java - Question Repository → Question Data: queries
src/main/java/com/quiz/backend/repository/QuestionRepository.java - Player Repository → Player Data: queries
src/main/java/com/quiz/backend/repository/PlayerRepository.java - Question Repository → Relational Database: persists via JPA
- Player Repository → Relational Database: persists via JPA