# twenty20twenty/mafia-manager architecture

> Architecture diagram of the GitHub repository twenty20twenty/mafia-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/twenty20twenty/mafia-manager
- Repository: https://github.com/twenty20twenty/mafia-manager

## Overview

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: [`frontend/src/api/axios.js`](https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/api/axios.js) (HTTP client), [`frontend/src/App.jsx`](https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/App.jsx) (Route application), [`backend/src/main/java/com/mafia/manager/service/AuthService.java`](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/AuthService.java) (Authentication service), [`backend/src/main/java/com/mafia/manager/controller/TournamentController.java`](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/TournamentController.java) (Tournament API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Route application<br/>[App.jsx]"]
  node_authui["Sign-in and registration<br/>[AuthContext.jsx]"]
  node_tourneyui["Tournament screens"]
  node_protocolui["Game protocol<br/>[useGameProtocol.js]"]
  node_manageui["Tournament management"]
  node_http["HTTP client<br/>[axios.js]"]
end

subgraph group_identity["Accounts and access"]
  node_authapi["Authentication API"]
  node_authsvc["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT security<br/>[JwtService.java]"]
  node_verify["Email verification"]
end

subgraph group_tourney["Tournament operations"]
  node_tourneyapi["Tournament API"]
  node_tourneysvc["Tournament rules"]
  node_seeding["Seating generation"]
  node_gameapi["Game API"]
  node_gamesvc["Game and results<br/>[GameService.java]"]
end

subgraph group_domain["Community and records"]
  node_community["Clubs and players"]
  node_clubs["Club management<br/>[ClubService.java]"]
  node_teams["Tournament teams<br/>[TeamService.java]"]
  node_judges["Judge management<br/>[JudgeService.java]"]
  node_stats["Player statistics"]
end

subgraph group_infra["Persistence and integrations"]
  node_tourneyrepo[("Tournament queries")]
  node_userrepo[("Account records")]
  node_storagesvc["Avatar storage"]
end

node_browser(("User"))
node_objectstore[("S3-compatible storage")]

node_browser -->|"opens"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_tourneyui
node_app -->|"routes to"| node_protocolui
node_authui -->|"uses"| node_http
node_tourneyui -.->|"requests through"| node_http
node_manageui -->|"requests through"| node_http
node_protocolui -->|"requests through"| node_http
node_http -.->|"calls"| node_authapi
node_http -.->|"calls"| node_tourneyapi
node_http -.->|"calls"| node_gameapi
node_authapi -.->|"delegates to"| node_authsvc
node_authsvc -->|"reads and saves"| node_userrepo
node_authsvc -->|"creates tokens"| node_jwt
node_authsvc -->|"delegates verification"| node_verify
node_tourneyapi -->|"delegates to"| node_tourneysvc
node_tourneyapi -->|"requests seating"| node_seeding
node_tourneysvc -->|"queries and updates"| node_tourneyrepo
node_seeding -->|"updates seeding status"| node_tourneyrepo
node_gameapi -.->|"delegates to"| node_gamesvc
node_community -.->|"delegates to"| node_clubs
node_tourneysvc -->|"uses statistics"| node_stats
node_storagesvc -->|"uploads and deletes"| node_objectstore

click node_app "https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/context/AuthContext.jsx"
click node_tourneyui "https://github.com/twenty20twenty/mafia-manager/tree/main/frontend/src/pages/tournaments"
click node_protocolui "https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/pages/tournaments/hooks/useGameProtocol.js"
click node_manageui "https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/pages/tournaments/hooks/useTournamentManagement.js"
click node_http "https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/api/axios.js"
click node_authapi "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/AuthController.java"
click node_authsvc "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/AuthService.java"
click node_jwt "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/security/JwtService.java"
click node_verify "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/EmailVerificationService.java"
click node_tourneyapi "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/TournamentController.java"
click node_tourneysvc "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/TournamentService.java"
click node_seeding "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/SeedingService.java"
click node_gameapi "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/GameController.java"
click node_gamesvc "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/GameService.java"
click node_community "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/ClubController.java"
click node_clubs "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/ClubService.java"
click node_teams "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/TeamService.java"
click node_judges "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/JudgeService.java"
click node_stats "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/PlayerStatsService.java"
click node_tourneyrepo "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/repository/TournamentRepository.java"
click node_userrepo "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/repository/UserRepository.java"
click node_storagesvc "https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/storage/MinioStorageService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_authui,node_tourneyui,node_protocolui,node_manageui,node_http,node_browser toneBlue
class node_authapi,node_authsvc,node_jwt,node_verify,node_objectstore toneAmber
class node_tourneyapi,node_tourneysvc,node_seeding,node_gameapi,node_gamesvc toneMint
class node_community,node_clubs,node_teams,node_judges,node_stats toneRose
class node_tourneyrepo,node_userrepo,node_storagesvc toneIndigo
```

## Components

### Web client

- [Route application](https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in and registration](https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Tournament screens](https://github.com/twenty20twenty/mafia-manager/tree/main/frontend/src/pages/tournaments): `frontend/src/pages/tournaments`
- [Game protocol](https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/pages/tournaments/hooks/useGameProtocol.js): `frontend/src/pages/tournaments/hooks/useGameProtocol.js`
- [Tournament management](https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/pages/tournaments/hooks/useTournamentManagement.js): `frontend/src/pages/tournaments/hooks/useTournamentManagement.js`
- [HTTP client](https://github.com/twenty20twenty/mafia-manager/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### Accounts and access

- [Authentication API](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/AuthController.java): `backend/src/main/java/com/mafia/manager/controller/AuthController.java`
- [Authentication service](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/AuthService.java): `backend/src/main/java/com/mafia/manager/service/AuthService.java`
- [JWT security](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/security/JwtService.java): `backend/src/main/java/com/mafia/manager/security/JwtService.java`
- [Email verification](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/EmailVerificationService.java): `backend/src/main/java/com/mafia/manager/service/EmailVerificationService.java`

### Tournament operations

- [Tournament API](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/TournamentController.java): `backend/src/main/java/com/mafia/manager/controller/TournamentController.java`
- [Tournament rules](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/TournamentService.java): `backend/src/main/java/com/mafia/manager/service/TournamentService.java`
- [Seating generation](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/SeedingService.java): `backend/src/main/java/com/mafia/manager/service/SeedingService.java`
- [Game API](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/GameController.java): `backend/src/main/java/com/mafia/manager/controller/GameController.java`
- [Game and results](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/GameService.java): `backend/src/main/java/com/mafia/manager/service/GameService.java`

### Community and records

- [Clubs and players](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/controller/ClubController.java): `backend/src/main/java/com/mafia/manager/controller/ClubController.java`
- [Club management](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/ClubService.java): `backend/src/main/java/com/mafia/manager/service/ClubService.java`
- [Tournament teams](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/TeamService.java): `backend/src/main/java/com/mafia/manager/service/TeamService.java`
- [Judge management](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/JudgeService.java): `backend/src/main/java/com/mafia/manager/service/JudgeService.java`
- [Player statistics](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/PlayerStatsService.java): `backend/src/main/java/com/mafia/manager/service/PlayerStatsService.java`

### Persistence and integrations

- [Tournament queries](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/repository/TournamentRepository.java): `backend/src/main/java/com/mafia/manager/repository/TournamentRepository.java`
- [Account records](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/repository/UserRepository.java): `backend/src/main/java/com/mafia/manager/repository/UserRepository.java`
- [Avatar storage](https://github.com/twenty20twenty/mafia-manager/blob/main/backend/src/main/java/com/mafia/manager/service/storage/MinioStorageService.java): `backend/src/main/java/com/mafia/manager/service/storage/MinioStorageService.java`

### Other components

- **User**
- **S3-compatible storage**

## Connections

- User → Route application: opens (evidence: `frontend/src/App.jsx`)
- Route application → Sign-in and registration: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Tournament screens: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Game protocol: routes to (evidence: `frontend/src/App.jsx`)
- Sign-in and registration → HTTP client: uses (evidence: `frontend/src/context/AuthContext.jsx`)
- Tournament screens → HTTP client: requests through (evidence: `frontend/src/pages/tournaments/hooks/useTournamentManagement.js`)
- Tournament management → HTTP client: requests through (evidence: `frontend/src/pages/tournaments/hooks/useTournamentManagement.js`)
- Game protocol → HTTP client: requests through (evidence: `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 (evidence: `backend/src/main/java/com/mafia/manager/controller/AuthController.java`)
- Authentication service → Account records: reads and saves (evidence: `backend/src/main/java/com/mafia/manager/service/AuthService.java`)
- Authentication service → JWT security: creates tokens (evidence: `backend/src/main/java/com/mafia/manager/service/AuthService.java`)
- Authentication service → Email verification: delegates verification (evidence: `backend/src/main/java/com/mafia/manager/service/AuthService.java`)
- Tournament API → Tournament rules: delegates to (evidence: `backend/src/main/java/com/mafia/manager/controller/TournamentController.java`)
- Tournament API → Seating generation: requests seating (evidence: `backend/src/main/java/com/mafia/manager/controller/TournamentController.java`)
- Tournament rules → Tournament queries: queries and updates (evidence: `backend/src/main/java/com/mafia/manager/service/TournamentService.java`)
- Seating generation → Tournament queries: updates seeding status (evidence: `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 (evidence: `backend/src/main/java/com/mafia/manager/service/TournamentService.java`)
- Avatar storage → S3-compatible storage: uploads and deletes (evidence: `backend/src/main/java/com/mafia/manager/service/storage/MinioStorageService.java`)
