How sriharshanadahalli/badminton-platform works
Badminton Tournament Management System supports tournament setup and scheduling, court assignment, live scoring, and public score displays. The main workflow runs from tournament administration and match assignment through a court’s match setup and scoring, with results and updates handled by the backend. Round-robin and knockout-bracket features are represented as distinct tournament stages. The excerpts show the court-scoring API/socket path and backend model imports; scheduler-to-backend interactions are not shown, so those links are omitted. README-described capabilities are retained without claiming their unsampled implementation details were inspected.
Main entry points: MatchContext.jsx Match state and sync · server.js API and socket server · CourtView.jsx Court view · App.jsx App routing
Components 31
Frontend views
- App routing
frontend/src/App.jsx - Tournament landing
frontend/src/pages/LandingView.jsx - Court view
frontend/src/pages/CourtView.jsx - Signage display
frontend/src/pages/SignageView.jsx - Mobile scores
frontend/src/pages/MobileLiveScore.jsx
Live scoring
- Match state and sync
frontend/src/context/MatchContext.jsx - Match timers
frontend/src/hooks/useTimer.js - Court controls
frontend/src/components/CourtArea.jsx - Scoreboard
frontend/src/components/Scoreboard.jsx - Match setup
frontend/src/components/MatchSetupModal.jsx - Game completion
frontend/src/components/GameOverModal.jsx - Win confirmation
frontend/src/components/WinConfirmationModal.jsx - Live score displays
frontend/src/components/LiveScoreDisplay.jsx - Mobile court card
frontend/src/components/MobileCourtCard.jsx - Next match display
frontend/src/components/NextMatchDisplay.jsx
Tournament operations
- Scheduler dashboard
frontend/src/pages/SchedulerView.jsx - Round-robin setup
frontend/src/components/RoundRobinSetupModal.jsx - Round-robin standings
frontend/src/components/RoundRobinTableView.jsx - Knockout brackets
frontend/src/components/BracketCard.jsx - Tournament dialogs
frontend/src/components/TournamentModals.jsx
Backend and persistence
- API and socket server
backend/server.js - Live match records
backend/models/Match.js - Tournament matches
backend/models/TournamentMatch.js - Court records
backend/models/Court.js - Categories
backend/models/Category.js - Players
backend/models/Player.js - Participation records
backend/models/Participation.js - Round-robin standings
backend/models/RoundRobinStanding.js - Tournament results
backend/models/TournamentResult.js
Other components
- Tournament staff
- Score viewers
Connections 38
- App routing → Tournament landing: routes to
frontend/src/App.jsx - App routing → Court view: routes to
frontend/src/App.jsx - App routing → Signage display: routes to
frontend/src/App.jsx - App routing → Mobile scores: routes to
frontend/src/App.jsx - App routing → Scheduler dashboard: routes to
frontend/src/App.jsx - App routing → Match state and sync: provides state
frontend/src/App.jsx - Court view → Match state and sync: fetches match
frontend/src/pages/CourtView.jsx - Court view → Match setup: renders
frontend/src/pages/CourtView.jsx - Court view → Court controls: renders
frontend/src/pages/CourtView.jsx - Court view → Scoreboard: renders
frontend/src/pages/CourtView.jsx - Court view → Game completion: renders
frontend/src/pages/CourtView.jsx - Court view → Win confirmation: renders
frontend/src/pages/CourtView.jsx - Match state and sync → Match timers: uses
frontend/src/context/MatchContext.jsx - Match state and sync → API and socket server: fetches court status
frontend/src/context/MatchContext.jsx - Match state and sync → API and socket server: emits match events
frontend/src/context/MatchContext.jsx - Match state and sync → Court controls: supplies match state
frontend/src/components/CourtArea.jsx - Match state and sync → Scoreboard: supplies match state
frontend/src/components/Scoreboard.jsx - Match state and sync → Match setup: supplies match state
frontend/src/components/MatchSetupModal.jsx - Match state and sync → Game completion: supplies match state
frontend/src/components/GameOverModal.jsx - Match state and sync → Win confirmation: supplies match state
frontend/src/components/WinConfirmationModal.jsx - Scheduler dashboard → Round-robin setup: renders
frontend/src/pages/SchedulerView.jsx - Scheduler dashboard → Round-robin standings: renders
frontend/src/pages/SchedulerView.jsx - Scheduler dashboard → Knockout brackets: renders
frontend/src/pages/SchedulerView.jsx - Scheduler dashboard → Tournament dialogs: uses
frontend/src/pages/SchedulerView.jsx - Round-robin setup → Tournament dialogs: uses alert modal
frontend/src/components/RoundRobinSetupModal.jsx - Mobile scores → Mobile court card: renders
frontend/src/pages/MobileLiveScore.jsx - Mobile court card → Live score displays: renders mobile score
frontend/src/components/MobileCourtCard.jsx - Mobile court card → Next match display: renders next match
frontend/src/components/MobileCourtCard.jsx - Signage display → Live score displays: renders score
frontend/src/pages/SignageView.jsx - Signage display → Next match display: renders next match
frontend/src/pages/SignageView.jsx - API and socket server → Live match records: reads and writes
backend/server.js - API and socket server → Tournament matches: reads and writes
backend/server.js - API and socket server → Court records: reads and writes
backend/server.js - API and socket server → Categories: uses
backend/server.js - API and socket server → Players: uses
backend/server.js - API and socket server → Participation records: uses
backend/server.js - API and socket server → Round-robin standings: uses
backend/server.js - API and socket server → Tournament results: uses
backend/server.js