How hafn-g/chess works
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: BoardPanel.java Board interaction · BoardNetworkClientController.java Online client controller · BoardController.java Local game controller · CheckRule.java Check validation
Components 32
Swing interface
- Start menu
src/main/java/com/hafn/chess/ui/swing/StartFrame.java - Board interaction
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board renderer
src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java - Game statistics
src/main/java/com/hafn/chess/ui/swing/panel/StatsPanel.java - Board metrics
src/main/java/com/hafn/chess/ui/swing/model/BoardMetrics.java - Piece image cache
src/main/java/com/hafn/chess/ui/swing/renderer/ImageCache.java
Application control
- Local game controller
src/main/java/com/hafn/chess/application/usecase/BoardController.java - Online client controller
src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java - Server game controller
src/main/java/com/hafn/chess/application/usecase/BoardNetworkServerController.java - Board input port
src/main/java/com/hafn/chess/application/port/in/BoardInputPort.java - Render port
src/main/java/com/hafn/chess/application/port/out/BoardRenderPort.java - State port
src/main/java/com/hafn/chess/application/port/out/BoardStatePort.java - Selection port
src/main/java/com/hafn/chess/application/port/out/SelectionPort.java
Chess domain
- Board and clock state
src/main/java/com/hafn/chess/domain/state/BoardState.java - Board operations contract
src/main/java/com/hafn/chess/domain/port/BoardPort.java - Chess piece rules
src/main/java/com/hafn/chess/domain/piece/Piece.java - Checker rules
src/main/java/com/hafn/chess/domain/piece/Checker.java - Check validation
src/main/java/com/hafn/chess/domain/service/CheckRule.java - Legal move generation
src/main/java/com/hafn/chess/domain/service/MoveHelperGenerator.java - Game and move models
src/main/java/com/hafn/chess/domain/model/Cell.java
Network play
- Online mode screens
src/main/java/com/hafn/chess/ui/swing/OnlineModeFrame.java - Client connection screen
src/main/java/com/hafn/chess/ui/swing/ClientFrame.java - Multiplayer board
src/main/java/com/hafn/chess/ui/swing/ChessMultiplayerFrame.java - Network client
src/main/java/com/hafn/chess/network/MyClient.java - Network server
src/main/java/com/hafn/chess/network/MyServer.java - Client handler
src/main/java/com/hafn/chess/network/ClientHandler.java - Game room
src/main/java/com/hafn/chess/network/GameRoom.java - Network game state
src/main/java/com/hafn/chess/network/NetworkGame.java
Startup
- Application entry
src/main/java/com/hafn/chess/bootstrap/Main.java - Board setup
src/main/java/com/hafn/chess/bootstrap/BoardInitializer.java
Other components
- Player
- Remote player
Connections 39
- Application entry → Start menu: launches
src/main/java/com/hafn/chess/bootstrap/Main.java - Player → Board interaction: clicks cells
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → Board setup: creates state
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → Board renderer: creates renderer
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → Online client controller: creates controller
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → Local game controller: uses controller
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → Board metrics: sizes board
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → Piece image cache: loads promotion icons
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → Board input port: implements input
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → Render port: implements render
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Board interaction → State port: implements state
src/main/java/com/hafn/chess/ui/swing/panel/BoardPanel.java - Local game controller → Board and clock state: reads and updates
src/main/java/com/hafn/chess/application/usecase/BoardController.java - Local game controller → Check validation: checks positions
src/main/java/com/hafn/chess/application/usecase/BoardController.java - Local game controller → Selection port: clears selection
src/main/java/com/hafn/chess/application/usecase/BoardController.java - Online client controller → Board and clock state: updates moves
src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java - Online client controller → Check validation: checks positions
src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java - Online client controller → Selection port: clears selection
src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java - Board renderer → Render port: implements rendering
src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java - Board renderer → Selection port: implements selection
src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java - Board renderer → Piece image cache: gets images
src/main/java/com/hafn/chess/ui/swing/renderer/BoardRenderer.java - Game statistics → Board interaction: reads displayed state
src/main/java/com/hafn/chess/ui/swing/panel/StatsPanel.java - Board and clock state → Board operations contract: implements operations
src/main/java/com/hafn/chess/domain/state/BoardState.java - Check validation → Board operations contract: reads board
src/main/java/com/hafn/chess/domain/service/CheckRule.java - Check validation → Chess piece rules: generates moves
src/main/java/com/hafn/chess/domain/service/CheckRule.java - Chess piece rules → Board operations contract: executes moves
src/main/java/com/hafn/chess/domain/piece/Piece.java - Checker rules → Board operations contract: executes captures
src/main/java/com/hafn/chess/domain/piece/Checker.java - Local game controller → Chess piece rules: executes moves
src/main/java/com/hafn/chess/application/usecase/BoardController.java - Online client controller → Chess piece rules: executes moves
src/main/java/com/hafn/chess/application/usecase/BoardNetworkClientController.java - Online mode screens → Client connection screen: opens connection
src/main/java/com/hafn/chess/ui/swing/ClientFrame.java - Client connection screen → Network client: creates client
src/main/java/com/hafn/chess/ui/swing/ClientFrame.java - Network client → Multiplayer board: opens multiplayer view
src/main/java/com/hafn/chess/network/MyClient.java - Network client → Online client controller: uses game controller
- Network server → Client handler: accepts clients
src/main/java/com/hafn/chess/network/ClientHandler.java - Client handler → Network server: uses server
src/main/java/com/hafn/chess/network/ClientHandler.java - Client handler → Game room: uses room
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
src/main/java/com/hafn/chess/application/usecase/BoardNetworkServerController.java - Server game controller → Check validation: checks positions
src/main/java/com/hafn/chess/application/usecase/BoardNetworkServerController.java - Remote player → Network client: sends moves