# hafn-g/chess architecture

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

- Interactive diagram: https://gitdiagram.com/hafn-g/chess
- Repository: https://github.com/hafn-g/chess

## Overview

Chess Blitz is a Java Swing chess game with timed turns, legal-move and check enforcement, promotion, statistics, and network-play entry points represented in the tree. The usual local workflow is to click a piece and destination, let the controller validate and apply the move to board state, then render the updated position and clocks. Separate UI, application, domain, and networking components are shown. Edges are limited to calls or dependencies visible in excerpts, the source index, or README; unsampled subsystems are included where documented by the tree, with uncertain wiring omitted.

Main entry points: [`src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java) (Board interaction), [`src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java`](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java) (Online client controller), [`src/main/java/com/hafn/chess/application/usecase/BoardController.java`](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/usecase/BoardController.java) (Local game controller), [`src/main/java/com/hafn/chess/domain/service/CheckRule.java`](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/service/CheckRule.java) (Check validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Swing interface"]
  node_startframe["Start menu<br/>[StartFrame.java]"]
  node_boardpanel["Board interaction<br/>[BoardPanel.java]"]
  node_renderer["Board renderer<br/>[BoardRenderer.java]"]
  node_stats["Game statistics<br/>[StatsPanel.java]"]
  node_metrics["Board metrics<br/>[BoardMetrics.java]"]
  node_cache["Piece image cache<br/>[ImageCache.java]"]
end

subgraph group_app["Application control"]
  node_controller["Local game controller"]
  node_netclientcontroller["Online client controller"]
  node_servercontroller["Server game controller"]
  node_inputport["Board input port"]
  node_renderport["Render port"]
  node_stateport["State port"]
  node_selectionport["Selection port<br/>[SelectionPort.java]"]
end

subgraph group_domain["Chess domain"]
  node_boardstate[("Board and clock state<br/>[BoardState.java]")]
  node_boardport["Board operations contract<br/>[BoardPort.java]"]
  node_pieces["Chess piece rules<br/>[Piece.java]"]
  node_checker["Checker rules<br/>[Checker.java]"]
  node_checkrule["Check validation<br/>[CheckRule.java]"]
  node_movehelpers["Legal move generation"]
  node_models["Game and move models<br/>[Cell.java]"]
end

subgraph group_network["Network play"]
  node_networkui["Online mode screens"]
  node_clientframe["Client connection screen<br/>[ClientFrame.java]"]
  node_multiframe["Multiplayer board"]
  node_myclient["Network client<br/>[MyClient.java]"]
  node_myserver["Network server<br/>[MyServer.java]"]
  node_handler["Client handler<br/>[ClientHandler.java]"]
  node_room["Game room<br/>[GameRoom.java]"]
  node_networkgame["Network game state<br/>[NetworkGame.java]"]
end

subgraph group_startup["Startup"]
  node_main["Application entry<br/>[Main.java]"]
  node_initializer["Board setup"]
end

node_player(("Player"))
node_remoteplayer(("Remote player"))

node_main -->|"launches"| node_startframe
node_player -->|"clicks cells"| node_boardpanel
node_boardpanel -->|"creates state"| node_initializer
node_boardpanel -->|"creates renderer"| node_renderer
node_boardpanel -->|"creates controller"| node_netclientcontroller
node_boardpanel -->|"uses controller"| node_controller
node_boardpanel -->|"sizes board"| node_metrics
node_boardpanel -->|"loads promotion icons"| node_cache
node_boardpanel -->|"implements input"| node_inputport
node_boardpanel -->|"implements render"| node_renderport
node_boardpanel -->|"implements state"| node_stateport
node_controller -->|"reads and updates"| node_boardstate
node_controller -->|"checks positions"| node_checkrule
node_controller -->|"clears selection"| node_selectionport
node_netclientcontroller -->|"updates moves"| node_boardstate
node_netclientcontroller -->|"checks positions"| node_checkrule
node_netclientcontroller -->|"clears selection"| node_selectionport
node_renderer -->|"implements rendering"| node_renderport
node_renderer -->|"implements selection"| node_selectionport
node_renderer -->|"gets images"| node_cache
node_stats -->|"reads displayed state"| node_boardpanel
node_boardstate -->|"implements operations"| node_boardport
node_checkrule -->|"reads board"| node_boardport
node_checkrule -->|"generates moves"| node_pieces
node_pieces -->|"executes moves"| node_boardport
node_checker -->|"executes captures"| node_boardport
node_controller -->|"executes moves"| node_pieces
node_netclientcontroller -->|"executes moves"| node_pieces
node_networkui -->|"opens connection"| node_clientframe
node_clientframe -->|"creates client"| node_myclient
node_myclient -->|"opens multiplayer view"| node_multiframe
node_myclient -.->|"uses game controller"| node_netclientcontroller
node_myserver -->|"accepts clients"| node_handler
node_handler -->|"uses server"| node_myserver
node_handler -->|"uses room"| node_room
node_room -.->|"manages game"| node_networkgame
node_servercontroller -->|"uses board contract"| node_boardport
node_servercontroller -->|"checks positions"| node_checkrule
node_remoteplayer -.->|"sends moves"| node_myclient

click node_main "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/bootstrap/Main.java"
click node_initializer "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/bootstrap/BoardInitializer.java"
click node_startframe "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/StartFrame.java"
click node_boardpanel "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java"
click node_renderer "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java"
click node_stats "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/panel/StatsPanel.java"
click node_metrics "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/model/BoardMetrics.java"
click node_cache "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/renderer/ImageCache.java"
click node_controller "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/usecase/BoardController.java"
click node_netclientcontroller "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java"
click node_servercontroller "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/usecase/BoardNetworkServerController.java"
click node_inputport "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/port/in/BoardInputPort.java"
click node_renderport "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/port/out/BoardRenderPort.java"
click node_stateport "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/port/out/BoardStatePort.java"
click node_selectionport "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/port/out/SelectionPort.java"
click node_boardstate "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/state/BoardState.java"
click node_boardport "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/port/BoardPort.java"
click node_pieces "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/piece/Piece.java"
click node_checker "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/piece/Checker.java"
click node_checkrule "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/service/CheckRule.java"
click node_movehelpers "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/service/MoveHelperGenerator.java"
click node_models "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/model/Cell.java"
click node_networkui "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/OnlineModeFrame.java"
click node_clientframe "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/ClientFrame.java"
click node_multiframe "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/ChessMultiplayerFrame.java"
click node_myclient "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/MyClient.java"
click node_myserver "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/MyServer.java"
click node_handler "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/ClientHandler.java"
click node_room "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/GameRoom.java"
click node_networkgame "https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/NetworkGame.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_startframe,node_boardpanel,node_renderer,node_stats,node_metrics,node_cache toneBlue
class node_controller,node_netclientcontroller,node_servercontroller,node_inputport,node_renderport,node_stateport,node_selectionport toneAmber
class node_boardstate,node_boardport,node_pieces,node_checker,node_checkrule,node_movehelpers,node_models toneMint
class node_networkui,node_clientframe,node_multiframe,node_myclient,node_myserver,node_handler,node_room,node_networkgame toneRose
class node_main,node_initializer,node_player,node_remoteplayer toneIndigo
```

## Components

### Swing interface

- [Start menu](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/StartFrame.java): `src/main/java/com/hafn/chess/ui/swing/StartFrame.java`
- [Board interaction](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java): `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`
- [Board renderer](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java): `src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java`
- [Game statistics](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/panel/StatsPanel.java): `src/main/java/com/hafn/chess/ui/swing/panel/StatsPanel.java`
- [Board metrics](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/model/BoardMetrics.java): `src/main/java/com/hafn/chess/ui/swing/model/BoardMetrics.java`
- [Piece image cache](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/renderer/ImageCache.java): `src/main/java/com/hafn/chess/ui/swing/renderer/ImageCache.java`

### Application control

- [Local game controller](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/usecase/BoardController.java): `src/main/java/com/hafn/chess/application/usecase/BoardController.java`
- [Online client controller](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java): `src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java`
- [Server game controller](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/usecase/BoardNetworkServerController.java): `src/main/java/com/hafn/chess/application/usecase/BoardNetworkServerController.java`
- [Board input port](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/port/in/BoardInputPort.java): `src/main/java/com/hafn/chess/application/port/in/BoardInputPort.java`
- [Render port](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/port/out/BoardRenderPort.java): `src/main/java/com/hafn/chess/application/port/out/BoardRenderPort.java`
- [State port](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/port/out/BoardStatePort.java): `src/main/java/com/hafn/chess/application/port/out/BoardStatePort.java`
- [Selection port](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/application/port/out/SelectionPort.java): `src/main/java/com/hafn/chess/application/port/out/SelectionPort.java`

### Chess domain

- [Board and clock state](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/state/BoardState.java): `src/main/java/com/hafn/chess/domain/state/BoardState.java`
- [Board operations contract](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/port/BoardPort.java): `src/main/java/com/hafn/chess/domain/port/BoardPort.java`
- [Chess piece rules](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/piece/Piece.java): `src/main/java/com/hafn/chess/domain/piece/Piece.java`
- [Checker rules](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/piece/Checker.java): `src/main/java/com/hafn/chess/domain/piece/Checker.java`
- [Check validation](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/service/CheckRule.java): `src/main/java/com/hafn/chess/domain/service/CheckRule.java`
- [Legal move generation](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/service/MoveHelperGenerator.java): `src/main/java/com/hafn/chess/domain/service/MoveHelperGenerator.java`
- [Game and move models](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/domain/model/Cell.java): `src/main/java/com/hafn/chess/domain/model/Cell.java`

### Network play

- [Online mode screens](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/OnlineModeFrame.java): `src/main/java/com/hafn/chess/ui/swing/OnlineModeFrame.java`
- [Client connection screen](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/ClientFrame.java): `src/main/java/com/hafn/chess/ui/swing/ClientFrame.java`
- [Multiplayer board](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/ui/swing/ChessMultiplayerFrame.java): `src/main/java/com/hafn/chess/ui/swing/ChessMultiplayerFrame.java`
- [Network client](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/MyClient.java): `src/main/java/com/hafn/chess/network/MyClient.java`
- [Network server](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/MyServer.java): `src/main/java/com/hafn/chess/network/MyServer.java`
- [Client handler](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/ClientHandler.java): `src/main/java/com/hafn/chess/network/ClientHandler.java`
- [Game room](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/GameRoom.java): `src/main/java/com/hafn/chess/network/GameRoom.java`
- [Network game state](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/network/NetworkGame.java): `src/main/java/com/hafn/chess/network/NetworkGame.java`

### Startup

- [Application entry](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/bootstrap/Main.java): `src/main/java/com/hafn/chess/bootstrap/Main.java`
- [Board setup](https://github.com/hafn-g/chess/blob/main/src/main/java/com/hafn/chess/bootstrap/BoardInitializer.java): `src/main/java/com/hafn/chess/bootstrap/BoardInitializer.java`

### Other components

- **Player**
- **Remote player**

## Connections

- Application entry → Start menu: launches (evidence: `src/main/java/com/hafn/chess/bootstrap/Main.java`)
- Player → Board interaction: clicks cells (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → Board setup: creates state (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → Board renderer: creates renderer (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → Online client controller: creates controller (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → Local game controller: uses controller (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → Board metrics: sizes board (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → Piece image cache: loads promotion icons (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → Board input port: implements input (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → Render port: implements render (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Board interaction → State port: implements state (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java`)
- Local game controller → Board and clock state: reads and updates (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardController.java`)
- Local game controller → Check validation: checks positions (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardController.java`)
- Local game controller → Selection port: clears selection (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardController.java`)
- Online client controller → Board and clock state: updates moves (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java`)
- Online client controller → Check validation: checks positions (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java`)
- Online client controller → Selection port: clears selection (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java`)
- Board renderer → Render port: implements rendering (evidence: `src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java`)
- Board renderer → Selection port: implements selection (evidence: `src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java`)
- Board renderer → Piece image cache: gets images (evidence: `src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java`)
- Game statistics → Board interaction: reads displayed state (evidence: `src/main/java/com/hafn/chess/ui/swing/panel/StatsPanel.java`)
- Board and clock state → Board operations contract: implements operations (evidence: `src/main/java/com/hafn/chess/domain/state/BoardState.java`)
- Check validation → Board operations contract: reads board (evidence: `src/main/java/com/hafn/chess/domain/service/CheckRule.java`)
- Check validation → Chess piece rules: generates moves (evidence: `src/main/java/com/hafn/chess/domain/service/CheckRule.java`)
- Chess piece rules → Board operations contract: executes moves (evidence: `src/main/java/com/hafn/chess/domain/piece/Piece.java`)
- Checker rules → Board operations contract: executes captures (evidence: `src/main/java/com/hafn/chess/domain/piece/Checker.java`)
- Local game controller → Chess piece rules: executes moves (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardController.java`)
- Online client controller → Chess piece rules: executes moves (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java`)
- Online mode screens → Client connection screen: opens connection (evidence: `src/main/java/com/hafn/chess/ui/swing/ClientFrame.java`)
- Client connection screen → Network client: creates client (evidence: `src/main/java/com/hafn/chess/ui/swing/ClientFrame.java`)
- Network client → Multiplayer board: opens multiplayer view (evidence: `src/main/java/com/hafn/chess/network/MyClient.java`)
- Network client → Online client controller: uses game controller
- Network server → Client handler: accepts clients (evidence: `src/main/java/com/hafn/chess/network/ClientHandler.java`)
- Client handler → Network server: uses server (evidence: `src/main/java/com/hafn/chess/network/ClientHandler.java`)
- Client handler → Game room: uses room (evidence: `src/main/java/com/hafn/chess/network/ClientHandler.java`)
- Game room → Network game state: manages game
- Server game controller → Board operations contract: uses board contract (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardNetworkServerController.java`)
- Server game controller → Check validation: checks positions (evidence: `src/main/java/com/hafn/chess/application/usecase/BoardNetworkServerController.java`)
- Remote player → Network client: sends moves
