# abdielmartes/vertigo_the_game architecture

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

- Interactive diagram: https://gitdiagram.com/abdielmartes/vertigo_the_game
- Repository: https://github.com/abdielmartes/vertigo_the_game

## Overview

Vertigo is a client/server multiplayer game with account and social features, lobby matchmaking, and live matches. The principal workflow is player interaction in the desktop UI, service calls through client networking, server-side handling, and persistence or game/lobby behavior. The tree identifies distinct gameplay and social subsystems; most of their implementations were not sampled, so links to them are dashed where their calls could not be verified. The README is empty.

Main entry points: [`src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthService.cs`](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthService.cs) (Session authentication), [`src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/PlayerRepository.cs`](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/PlayerRepository.cs) (Player repository), [`src/Client/Vertigo.Client.UI/App.axaml.cs`](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.UI/App.axaml.cs) (UI application), [`src/Client/Vertigo.Client.Networking/Proxies/ServiceCaller.cs`](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.Networking/Proxies/ServiceCaller.cs) (Service clients)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_ui["UI application<br/>[App.axaml.cs]"]
  node_navigation["Navigation<br/>[Navigator.cs]"]
  node_client_network["Service clients<br/>[ServiceCaller.cs]"]
  node_callbacks["Live callbacks"]
end

subgraph group_contracts["Service contracts"]
  node_contracts["Service contracts<br/>[ILobbyService.cs]"]
end

subgraph group_identity["Identity and social"]
  node_server["Server host<br/>[Program.cs]"]
  node_auth_api["Authentication API"]
  node_auth["Session authentication<br/>[AuthService.cs]"]
  node_registration["Account registration<br/>[AccountService.cs]"]
  node_session_identity["Session identity"]
  node_friendship["Friendships"]
  node_blocking["Player blocking"]
  node_token_security["Token generation<br/>[TokenGenerator.cs]"]
end

subgraph group_game["Lobbies and matches"]
  node_lobby["Lobby service<br/>[LobbyService.cs]"]
  node_invitations["Lobby invitations"]
  node_chat["Lobby chat<br/>[ChatService.cs]"]
  node_match["Match lifecycle"]
end

subgraph group_persistence["Persistence"]
  node_player_repo["Player repository"]
  node_session_repo["Session token repository"]
  node_database[("Game database")]
end

node_player(("Player"))

node_player -.->|"uses"| node_ui
node_ui -.->|"navigates"| node_navigation
node_ui -.->|"calls services"| node_client_network
node_client_network -.->|"calls services"| node_server
node_server -->|"hosts endpoints"| node_contracts
node_client_network -->|"uses contracts"| node_contracts
node_server -->|"registers services"| node_auth_api
node_auth_api -->|"delegates"| node_auth
node_auth -->|"loads player"| node_player_repo
node_auth -->|"manages tokens"| node_session_repo
node_auth -->|"generates tokens"| node_token_security
node_session_identity -.->|"resolves sessions"| node_auth
node_friendship -.->|"uses player data"| node_player_repo
node_blocking -.->|"uses player data"| node_player_repo
node_invitations -.->|"invites players"| node_lobby
node_chat -.->|"uses lobby state"| node_lobby
node_lobby -.->|"starts match"| node_match
node_callbacks -->|"handles callbacks"| node_contracts
node_player_repo -.->|"reads and writes"| node_database
node_session_repo -->|"reads and writes"| node_database
node_database -.->|"maps player data"| node_player_repo

click node_ui "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.UI/App.axaml.cs"
click node_navigation "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.Core/Navigation/Navigator.cs"
click node_client_network "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.Networking/Proxies/ServiceCaller.cs"
click node_callbacks "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.Networking/Callbacks/LobbyCallbackHandler.cs"
click node_contracts "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Shared/Vertigo.Contracts/Interfaces/ILobbyService.cs"
click node_server "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Host/Program.cs"
click node_auth_api "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthenticationService.cs"
click node_auth "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthService.cs"
click node_registration "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Registration/Services/AccountService.cs"
click node_session_identity "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/SessionIdentityResolver.cs"
click node_friendship "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Friendships/Services/FriendshipService.cs"
click node_blocking "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Blocking/Services/BlockedPlayerService.cs"
click node_lobby "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Matchmaking/Lobbies/Services/LobbyService.cs"
click node_invitations "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Matchmaking/Invitations/Services/LobbyInvitationService.cs"
click node_chat "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Matchmaking/Chat/Services/ChatService.cs"
click node_match "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Game/Matches/Implementations/InMemoryMatchSessionStarter.cs"
click node_player_repo "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/PlayerRepository.cs"
click node_session_repo "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/SessionTokenRepository.cs"
click node_database "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.DataAccess/Contexts/VertigoDatabaseContext.cs"
click node_token_security "https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.CrossCutting/Security/Implementations/TokenGenerator.cs"

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_ui,node_navigation,node_client_network,node_callbacks toneBlue
class node_contracts toneAmber
class node_server,node_auth_api,node_auth,node_registration,node_session_identity,node_friendship,node_blocking,node_token_security toneMint
class node_lobby,node_invitations,node_chat,node_match toneRose
class node_player_repo,node_session_repo,node_database,node_player toneIndigo
```

## Components

### Desktop client

- [UI application](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.UI/App.axaml.cs): `src/Client/Vertigo.Client.UI/App.axaml.cs`
- [Navigation](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.Core/Navigation/Navigator.cs): `src/Client/Vertigo.Client.Core/Navigation/Navigator.cs`
- [Service clients](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.Networking/Proxies/ServiceCaller.cs): `src/Client/Vertigo.Client.Networking/Proxies/ServiceCaller.cs`
- [Live callbacks](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Client/Vertigo.Client.Networking/Callbacks/LobbyCallbackHandler.cs): `src/Client/Vertigo.Client.Networking/Callbacks/LobbyCallbackHandler.cs`

### Service contracts

- [Service contracts](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Shared/Vertigo.Contracts/Interfaces/ILobbyService.cs): `src/Shared/Vertigo.Contracts/Interfaces/ILobbyService.cs`

### Identity and social

- [Server host](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Host/Program.cs): `src/Server/Vertigo.Server.Host/Program.cs`
- [Authentication API](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthenticationService.cs): `src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthenticationService.cs`
- [Session authentication](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthService.cs): `src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthService.cs`
- [Account registration](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Registration/Services/AccountService.cs): `src/Server/Vertigo.Server.PlayerManagement/Registration/Services/AccountService.cs`
- [Session identity](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/SessionIdentityResolver.cs): `src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/SessionIdentityResolver.cs`
- [Friendships](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Friendships/Services/FriendshipService.cs): `src/Server/Vertigo.Server.PlayerManagement/Friendships/Services/FriendshipService.cs`
- [Player blocking](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.PlayerManagement/Blocking/Services/BlockedPlayerService.cs): `src/Server/Vertigo.Server.PlayerManagement/Blocking/Services/BlockedPlayerService.cs`
- [Token generation](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.CrossCutting/Security/Implementations/TokenGenerator.cs): `src/Server/Vertigo.Server.CrossCutting/Security/Implementations/TokenGenerator.cs`

### Lobbies and matches

- [Lobby service](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Matchmaking/Lobbies/Services/LobbyService.cs): `src/Server/Vertigo.Server.Matchmaking/Lobbies/Services/LobbyService.cs`
- [Lobby invitations](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Matchmaking/Invitations/Services/LobbyInvitationService.cs): `src/Server/Vertigo.Server.Matchmaking/Invitations/Services/LobbyInvitationService.cs`
- [Lobby chat](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Matchmaking/Chat/Services/ChatService.cs): `src/Server/Vertigo.Server.Matchmaking/Chat/Services/ChatService.cs`
- [Match lifecycle](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.Game/Matches/Implementations/InMemoryMatchSessionStarter.cs): `src/Server/Vertigo.Server.Game/Matches/Implementations/InMemoryMatchSessionStarter.cs`

### Persistence

- [Player repository](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/PlayerRepository.cs): `src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/PlayerRepository.cs`
- [Session token repository](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/SessionTokenRepository.cs): `src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/SessionTokenRepository.cs`
- [Game database](https://github.com/abdielmartes/vertigo_the_game/blob/main/src/Server/Vertigo.Server.DataAccess/Contexts/VertigoDatabaseContext.cs): `src/Server/Vertigo.Server.DataAccess/Contexts/VertigoDatabaseContext.cs`

### Other components

- **Player**

## Connections

- Player → UI application: uses
- UI application → Navigation: navigates
- UI application → Service clients: calls services
- Service clients → Server host: calls services
- Server host → Service contracts: hosts endpoints (evidence: `src/Server/Vertigo.Server.Host/Program.cs`)
- Service clients → Service contracts: uses contracts
- Server host → Authentication API: registers services (evidence: `src/Server/Vertigo.Server.Host/Program.cs`)
- Authentication API → Session authentication: delegates (evidence: `src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthenticationService.cs`)
- Session authentication → Player repository: loads player (evidence: `src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthService.cs`)
- Session authentication → Session token repository: manages tokens (evidence: `src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthService.cs`)
- Session authentication → Token generation: generates tokens (evidence: `src/Server/Vertigo.Server.PlayerManagement/Authentication/Services/AuthService.cs`)
- Session identity → Session authentication: resolves sessions
- Friendships → Player repository: uses player data (evidence: `src/Server/Vertigo.Server.PlayerManagement/Friendships/Services/FriendshipService.cs`)
- Player blocking → Player repository: uses player data
- Lobby invitations → Lobby service: invites players
- Lobby chat → Lobby service: uses lobby state
- Lobby service → Match lifecycle: starts match
- Live callbacks → Service contracts: handles callbacks (evidence: `src/Client/Vertigo.Client.Networking/Callbacks/LobbyCallbackHandler.cs`)
- Player repository → Game database: reads and writes (evidence: `src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/PlayerRepository.cs`)
- Session token repository → Game database: reads and writes (evidence: `src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/SessionTokenRepository.cs`)
- Game database → Player repository: maps player data (evidence: `src/Server/Vertigo.Server.DataAccess/Repositories/Implementations/PlayerRepository.cs`)
