How siddharth-bhairy/quizarena_v2 works
QuizArena is a browser-based quiz and multiplayer game with a FastAPI backend. Players sign up or log in, enter the Arena, play a classic quiz, a timed solo mode, or a live room duel, and submit scores for leaderboard ranking. Profiles and following support player discovery. The graph separates client flows, API domains, and persistence. Relationships are based on shown imports, API calls, backend registrations, or README statements; some backend route internals are represented at their exact module paths but were not excerpted.
Main entry points: App.jsx Routes and Arena · api.js API client · main.py FastAPI application · models.py Data models
Components 22
Web client
- Routes and Arena
frontend/src/App.jsx - Session client
frontend/src/auth/AuthContext.jsx - API client
frontend/src/api.js - Classic quiz
frontend/src/pages/ClassicQuiz.jsx - Flash Anzan
frontend/src/pages/FlashAnzan.jsx - Flag Guess
frontend/src/pages/FlagGuess.jsx - Duel room
frontend/src/pages/DuelRoom.jsx - Leaderboard view
frontend/src/pages/Leaderboard.jsx - Player profiles
frontend/src/pages/Profile.jsx - Shared components
frontend/src/components
Game services
- FastAPI application
backend/main.py - Token and password auth
backend/auth.py - Auth endpoints
backend/routers/auth_router.py - Quiz and score API
backend/routers/game.py - Live room API
backend/routers/multiplayer.py - Question seeding
backend/seed_data.py
Player community
- Leaderboard API
backend/routers/leaderboard.py - Social API
backend/routers/social.py
Persistence
- Data models
backend/models.py - Relational database
backend/database.py - API schemas
backend/schemas.py
Other components
- Player
Connections 44
- Player → Routes and Arena: uses
frontend/src/App.jsx - Routes and Arena → Session client: checks session
frontend/src/App.jsx - Routes and Arena → Classic quiz: routes to
frontend/src/App.jsx - Routes and Arena → Flash Anzan: routes to
frontend/src/App.jsx - Routes and Arena → Flag Guess: routes to
frontend/src/App.jsx - Routes and Arena → Duel room: routes to
frontend/src/App.jsx - Routes and Arena → Leaderboard view: routes to
frontend/src/App.jsx - Routes and Arena → Player profiles: routes to
frontend/src/App.jsx - Session client → API client: validates session
frontend/src/auth/AuthContext.jsx - Session client → Auth endpoints: checks identity
- Classic quiz → API client: starts and submits
frontend/src/api.js - Flash Anzan → API client: submits score
frontend/src/api.js - Flag Guess → API client: submits score
frontend/src/api.js - Duel room → API client: builds socket URL
frontend/src/pages/DuelRoom.jsx - Leaderboard view → API client: requests ranks
frontend/src/api.js - Player profiles → API client: requests profile
frontend/src/api.js - Classic quiz → Shared components: uses controls
frontend/src/pages/ClassicQuiz.jsx - Duel room → Shared components: uses controls
frontend/src/pages/DuelRoom.jsx - Leaderboard view → Shared components: uses follow control
frontend/src/pages/Leaderboard.jsx - FastAPI application → Auth endpoints: registers routes
backend/main.py - FastAPI application → Quiz and score API: registers routes
backend/main.py - FastAPI application → Leaderboard API: registers routes
backend/main.py - FastAPI application → Live room API: registers routes
backend/main.py - FastAPI application → Social API: registers routes
backend/main.py - FastAPI application → Question seeding: seeds on startup
backend/main.py - Auth endpoints → Token and password auth: uses auth helpers
backend/routers/auth_router.py - Auth endpoints → Relational database: gets database session
backend/routers/auth_router.py - Quiz and score API → Relational database: gets database session
backend/routers/game.py - Live room API → Relational database: gets database session
backend/routers/multiplayer.py - Leaderboard API → Relational database: gets database session
backend/routers/leaderboard.py - Social API → Relational database: gets database session
backend/routers/social.py - Auth endpoints → Data models: queries users
backend/routers/auth_router.py - Quiz and score API → Data models: uses game records
backend/routers/game.py - Live room API → Data models: uses game records
backend/routers/multiplayer.py - Leaderboard API → Data models: queries scores
backend/routers/leaderboard.py - Social API → Data models: queries follows
backend/routers/social.py - Question seeding → Relational database: loads questions
backend/seed_data.py - Question seeding → Data models: creates questions
backend/seed_data.py - Data models → Relational database: uses ORM base
backend/models.py - Auth endpoints → API schemas: validates responses
backend/routers/auth_router.py - Quiz and score API → API schemas: validates game data
backend/routers/game.py - Social API → API schemas: validates social data
backend/routers/social.py - API client → FastAPI application: sends HTTP requests
frontend/src/api.js - Duel room → Live room API: opens room socket
frontend/src/pages/DuelRoom.jsx