# jona-walpert/casono architecture

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

- Interactive diagram: https://gitdiagram.com/jona-walpert/casono
- Repository: https://github.com/jona-walpert/casono

## Overview

Casono is a networked multiplayer poker game with a JavaFX client and a server built around a custom client-server protocol. A player launches the client, connects and logs in, selects or creates a lobby, then plays poker and uses lobby/global chat; the server routes requests to application handlers and maintains game and lobby state. The README also documents private messaging, multiple lobbies, rule enforcement, and persistent highscores. Some server routing and handler connections are inferred only from documented capabilities, so those links are marked unverified.

Main entry points: [`src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/app/commands`](https://github.com/jona-walpert/casono/tree/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/app/commands) (Request Handlers), [`src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/gameui/CasinoGameController.java`](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/gameui/CasinoGameController.java) (Game And Lobby UI), [`src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/engine/GameEngine.java`](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/engine/GameEngine.java) (Game Engine), [`src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ClientService.java`](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ClientService.java) (Client Connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client Experience"]
  node_clientapp["Client Startup<br/>[ClientApp.java]"]
  node_ui["Game And Lobby UI"]
  node_chatui["Chat UI"]
  node_chatlogic["Chat Coordination"]
  node_sound["Sound Effects<br/>[SoundManager.java]"]
  node_lobbyui["Lobby Selection"]
end

subgraph group_clientnet["Client Networking"]
  node_clientservice["Client Connection<br/>[ClientService.java]"]
  node_lobbyclient["Lobby Requests<br/>[LobbyClient.java]"]
  node_gameservice["Game Actions<br/>[GameService.java]"]
  node_chatclient["Chat Requests<br/>[ChatClient.java]"]
end

subgraph group_servernet["Server Protocol"]
  node_server["Game Server<br/>[ServerApp.java]"]
  node_networkmanager["Network Manager"]
  node_transport["TCP Transport<br/>[TcpTransport.java]"]
  node_protocol["Protocol Parsing"]
  node_dispatch["Command Dispatch<br/>[CommandRouter.java]"]
end

subgraph group_services["Server Services"]
  node_handlers["Request Handlers"]
  node_lobbies["Lobby Management<br/>[LobbyManager.java]"]
  node_users["User Registry<br/>[UserRegistry.java]"]
  node_chat["Message Service<br/>[Message.java]"]
  node_highscores["Highscore Service"]
end

subgraph group_game["Poker Domain"]
  node_gamecontroller["Game Controller"]
  node_engine["Game Engine<br/>[GameEngine.java]"]
  node_rules["Rule Engine<br/>[RuleEngine.java]"]
  node_gamestate[("Game State<br/>[GameState.java]")]
  node_evaluator["Hand Evaluation<br/>[HandEvaluator.java]"]
end

node_player(("Player"))

node_player -->|"launches"| node_clientapp
node_clientapp -->|"starts UI"| node_ui
node_clientapp -->|"logs in"| node_lobbyclient
node_ui -->|"requests game actions"| node_gameservice
node_ui -->|"manages lobbies"| node_lobbyclient
node_lobbyui -->|"requests lobby data"| node_lobbyclient
node_ui -->|"uses chat"| node_chatlogic
node_chatui -->|"updates models"| node_chatlogic
node_chatlogic -->|"sends chat requests"| node_chatclient
node_chatui -->|"plays effects"| node_sound
node_gameservice -.->|"fetches game state"| node_clientservice
node_lobbyclient -.->|"sends commands"| node_clientservice
node_chatclient -.->|"sends commands"| node_clientservice
node_clientservice -->|"reads and writes packets"| node_transport
node_server -.->|"starts networking"| node_networkmanager
node_networkmanager -->|"configures transport"| node_transport
node_networkmanager -->|"configures router"| node_dispatch
node_transport -.->|"supplies packets"| node_protocol
node_protocol -.->|"parses commands"| node_dispatch
node_dispatch -.->|"routes requests"| node_handlers
node_handlers -.->|"manages lobby requests"| node_lobbies
node_handlers -.->|"manages accounts"| node_users
node_handlers -.->|"handles messages"| node_chat
node_handlers -.->|"serves scores"| node_highscores
node_handlers -.->|"dispatches player actions"| node_gamecontroller
node_lobbies -.->|"hosts poker games"| node_gamecontroller
node_gamecontroller -.->|"coordinates game"| node_engine
node_engine -->|"validates actions"| node_rules
node_engine -.->|"updates state"| node_gamestate
node_engine -.->|"evaluates hands"| node_evaluator
node_player -.->|"plays remotely"| node_server

click node_clientapp "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ClientApp.java"
click node_ui "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/gameui/CasinoGameController.java"
click node_chatui "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/chatui/ChatBoxController.java"
click node_chatlogic "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/chat/ChatController.java"
click node_sound "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/ui/sound/SoundManager.java"
click node_lobbyui "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/lobbyui/LobbyButtonGridManager.java"
click node_clientservice "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ClientService.java"
click node_lobbyclient "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/LobbyClient.java"
click node_gameservice "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/game/GameService.java"
click node_chatclient "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ChatClient.java"
click node_server "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/ServerApp.java"
click node_networkmanager "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/NetworkManager.java"
click node_transport "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/transport/TcpTransport.java"
click node_protocol "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/protocol/parser/ProtocolParser.java"
click node_dispatch "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/command/execution/CommandRouter.java"
click node_handlers "https://github.com/jona-walpert/casono/tree/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/app/commands"
click node_lobbies "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/lobby/LobbyManager.java"
click node_users "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/user/UserRegistry.java"
click node_chat "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/message/Message.java"
click node_highscores "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/highscore/HighscoreService.java"
click node_gamecontroller "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/GameController.java"
click node_engine "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/engine/GameEngine.java"
click node_rules "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/rules/RuleEngine.java"
click node_gamestate "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/state/GameState.java"
click node_evaluator "https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/evaluator/HandEvaluator.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_clientapp,node_ui,node_chatui,node_chatlogic,node_sound,node_lobbyui toneBlue
class node_clientservice,node_lobbyclient,node_gameservice,node_chatclient toneAmber
class node_server,node_networkmanager,node_transport,node_protocol,node_dispatch toneMint
class node_handlers,node_lobbies,node_users,node_chat,node_highscores toneRose
class node_gamecontroller,node_engine,node_rules,node_gamestate,node_evaluator,node_player toneIndigo
```

## Components

### Client Experience

- [Client Startup](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ClientApp.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ClientApp.java`
- [Game And Lobby UI](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/gameui/CasinoGameController.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/gameui/CasinoGameController.java`
- [Chat UI](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/chatui/ChatBoxController.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/chatui/ChatBoxController.java`
- [Chat Coordination](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/chat/ChatController.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/chat/ChatController.java`
- [Sound Effects](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/ui/sound/SoundManager.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/ui/sound/SoundManager.java`
- [Lobby Selection](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/lobbyui/LobbyButtonGridManager.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/lobbyui/LobbyButtonGridManager.java`

### Client Networking

- [Client Connection](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ClientService.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ClientService.java`
- [Lobby Requests](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/LobbyClient.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/LobbyClient.java`
- [Game Actions](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/game/GameService.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/game/GameService.java`
- [Chat Requests](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ChatClient.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ChatClient.java`

### Server Protocol

- [Game Server](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/ServerApp.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/ServerApp.java`
- [Network Manager](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/NetworkManager.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/NetworkManager.java`
- [TCP Transport](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/transport/TcpTransport.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/transport/TcpTransport.java`
- [Protocol Parsing](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/protocol/parser/ProtocolParser.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/protocol/parser/ProtocolParser.java`
- [Command Dispatch](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/command/execution/CommandRouter.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/command/execution/CommandRouter.java`

### Server Services

- [Request Handlers](https://github.com/jona-walpert/casono/tree/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/app/commands): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/app/commands`
- [Lobby Management](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/lobby/LobbyManager.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/lobby/LobbyManager.java`
- [User Registry](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/user/UserRegistry.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/user/UserRegistry.java`
- [Message Service](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/message/Message.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/message/Message.java`
- [Highscore Service](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/highscore/HighscoreService.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/highscore/HighscoreService.java`

### Poker Domain

- [Game Controller](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/GameController.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/GameController.java`
- [Game Engine](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/engine/GameEngine.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/engine/GameEngine.java`
- [Rule Engine](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/rules/RuleEngine.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/rules/RuleEngine.java`
- [Game State](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/state/GameState.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/state/GameState.java`
- [Hand Evaluation](https://github.com/jona-walpert/casono/blob/main/src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/evaluator/HandEvaluator.java): `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/evaluator/HandEvaluator.java`

### Other components

- **Player**

## Connections

- Player → Client Startup: launches (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ClientApp.java`)
- Client Startup → Game And Lobby UI: starts UI (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ClientApp.java`)
- Client Startup → Lobby Requests: logs in (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ClientApp.java`)
- Game And Lobby UI → Game Actions: requests game actions (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/gameui/CasinoGameController.java`)
- Game And Lobby UI → Lobby Requests: manages lobbies (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/gameui/CasinoGameController.java`)
- Lobby Selection → Lobby Requests: requests lobby data (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/lobbyui/LobbyButtonGridManager.java`)
- Game And Lobby UI → Chat Coordination: uses chat (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/gameui/CasinoGameController.java`)
- Chat UI → Chat Coordination: updates models (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/chatui/ChatBoxController.java`)
- Chat Coordination → Chat Requests: sends chat requests (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/chat/ChatController.java`)
- Chat UI → Sound Effects: plays effects (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/ui/chatui/ChatBoxController.java`)
- Game Actions → Client Connection: fetches game state
- Lobby Requests → Client Connection: sends commands (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/LobbyClient.java`)
- Chat Requests → Client Connection: sends commands
- Client Connection → TCP Transport: reads and writes packets (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/client/network/ClientService.java`)
- Game Server → Network Manager: starts networking
- Network Manager → TCP Transport: configures transport (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/NetworkManager.java`)
- Network Manager → Command Dispatch: configures router (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/network/NetworkManager.java`)
- TCP Transport → Protocol Parsing: supplies packets
- Protocol Parsing → Command Dispatch: parses commands
- Command Dispatch → Request Handlers: routes requests
- Request Handlers → Lobby Management: manages lobby requests
- Request Handlers → User Registry: manages accounts
- Request Handlers → Message Service: handles messages
- Request Handlers → Highscore Service: serves scores
- Request Handlers → Game Controller: dispatches player actions
- Lobby Management → Game Controller: hosts poker games
- Game Controller → Game Engine: coordinates game (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/GameController.java`)
- Game Engine → Rule Engine: validates actions (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/engine/GameEngine.java`)
- Game Engine → Game State: updates state (evidence: `src/main/java/ch/unibas/dmi/dbis/cs108/casono/server/domain/game/engine/GameEngine.java`)
- Game Engine → Hand Evaluation: evaluates hands
- Player → Game Server: plays remotely (evidence: `README.md`)
