How twenty20twenty/mafia-manager works
Mafia Manager is a tournament-management application for players, clubs, judges, and organizers. Users browse tournaments and player/club profiles; authenticated organizers configure tournaments, manage participants and judges, generate seating, record games, and review results. The frontend routes these workflows to a Spring backend, where services apply domain rules and repositories persist tournament, account, and game data. The source excerpts establish several tournament, authentication, and frontend relationships; other listed capabilities are represented from the repository tree, with uncertain links omitted or marked unverified.
Main entry points: axios.js HTTP client · App.jsx Route application · AuthService.java Authentication service · TournamentController.java Tournament API
Components 25
Web client
- Route application
frontend/src/App.jsx - Sign-in and registration
frontend/src/context/AuthContext.jsx - Tournament screens
frontend/src/pages/tournaments - Game protocol
frontend/src/pages/tournaments/hooks/useGameProtocol.js - Tournament management
frontend/src/pages/tournaments/hooks/useTournamentManagement.js - HTTP client
frontend/src/api/axios.js
Accounts and access
- Authentication API
backend/src/main/java/com/mafia/manager/controller/AuthController.java - Authentication service
backend/src/main/java/com/mafia/manager/service/AuthService.java - JWT security
backend/src/main/java/com/mafia/manager/security/JwtService.java - Email verification
backend/src/main/java/com/mafia/manager/service/EmailVerificationService.java
Tournament operations
- Tournament API
backend/src/main/java/com/mafia/manager/controller/TournamentController.java - Tournament rules
backend/src/main/java/com/mafia/manager/service/TournamentService.java - Seating generation
backend/src/main/java/com/mafia/manager/service/SeedingService.java - Game API
backend/src/main/java/com/mafia/manager/controller/GameController.java - Game and results
backend/src/main/java/com/mafia/manager/service/GameService.java
Community and records
- Clubs and players
backend/src/main/java/com/mafia/manager/controller/ClubController.java - Club management
backend/src/main/java/com/mafia/manager/service/ClubService.java - Tournament teams
backend/src/main/java/com/mafia/manager/service/TeamService.java - Judge management
backend/src/main/java/com/mafia/manager/service/JudgeService.java - Player statistics
backend/src/main/java/com/mafia/manager/service/PlayerStatsService.java
Persistence and integrations
- Tournament queries
backend/src/main/java/com/mafia/manager/repository/TournamentRepository.java - Account records
backend/src/main/java/com/mafia/manager/repository/UserRepository.java - Avatar storage
backend/src/main/java/com/mafia/manager/service/storage/MinioStorageService.java
Other components
- User
- S3-compatible storage
Connections 23
- User → Route application: opens
frontend/src/App.jsx - Route application → Sign-in and registration: routes to
frontend/src/App.jsx - Route application → Tournament screens: routes to
frontend/src/App.jsx - Route application → Game protocol: routes to
frontend/src/App.jsx - Sign-in and registration → HTTP client: uses
frontend/src/context/AuthContext.jsx - Tournament screens → HTTP client: requests through
frontend/src/pages/tournaments/hooks/useTournamentManagement.js - Tournament management → HTTP client: requests through
frontend/src/pages/tournaments/hooks/useTournamentManagement.js - Game protocol → HTTP client: requests through
frontend/src/pages/tournaments/hooks/useGameProtocol.js - HTTP client → Authentication API: calls
- HTTP client → Tournament API: calls
- HTTP client → Game API: calls
- Authentication API → Authentication service: delegates to
backend/src/main/java/com/mafia/manager/controller/AuthController.java - Authentication service → Account records: reads and saves
backend/src/main/java/com/mafia/manager/service/AuthService.java - Authentication service → JWT security: creates tokens
backend/src/main/java/com/mafia/manager/service/AuthService.java - Authentication service → Email verification: delegates verification
backend/src/main/java/com/mafia/manager/service/AuthService.java - Tournament API → Tournament rules: delegates to
backend/src/main/java/com/mafia/manager/controller/TournamentController.java - Tournament API → Seating generation: requests seating
backend/src/main/java/com/mafia/manager/controller/TournamentController.java - Tournament rules → Tournament queries: queries and updates
backend/src/main/java/com/mafia/manager/service/TournamentService.java - Seating generation → Tournament queries: updates seeding status
backend/src/main/java/com/mafia/manager/service/SeedingService.java - Game API → Game and results: delegates to
- Clubs and players → Club management: delegates to
- Tournament rules → Player statistics: uses statistics
backend/src/main/java/com/mafia/manager/service/TournamentService.java - Avatar storage → S3-compatible storage: uploads and deletes
backend/src/main/java/com/mafia/manager/service/storage/MinioStorageService.java