# flavioasp77/chess-system-java architecture

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

- Interactive diagram: https://gitdiagram.com/flavioasp77/chess-system-java
- Repository: https://github.com/flavioasp77/chess-system-java

## Overview

Console Chess is a Java terminal chess game. A player enters a source square, sees legal moves, enters a target square, and the match applies the move until checkmate; the console also displays captures and handles promotion. The implementation separates the console loop and rendering, chess-match rules, piece movement, and a reusable board model. The README is brief, and several source excerpts are partial, so the graph limits links to calls or references supported by the shown code and source index.

Main entry points: [`src/chess/ChessMatch.java`](https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessMatch.java) (Match engine), [`src/boardgame/Board.java`](https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/Board.java) (Board state), [`src/chess/pieces`](https://github.com/flavioasp77/chess-system-java/tree/main/src/chess/pieces) (Piece movement rules), [`src/chess/ChessPiece.java`](https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessPiece.java) (Chess piece base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Console interface"]
  node_program["Game loop<br/>[Program.java]"]
  node_ui["Console UI<br/>[UI.java]"]
end

subgraph group_rules["Chess rules"]
  node_match["Match engine<br/>[ChessMatch.java]"]
  node_chess_position["Chess coordinates<br/>[ChessPosition.java]"]
  node_chess_exception["Chess errors"]
  node_color["Piece colors<br/>[Color.java]"]
end

subgraph group_pieces["Piece movement"]
  node_chess_piece["Chess piece base<br/>[ChessPiece.java]"]
  node_movement["Piece movement rules"]
end

subgraph group_board["Board model"]
  node_board[("Board state<br/>[Board.java]")]
  node_piece["Board piece base<br/>[Piece.java]"]
  node_position["Board coordinates<br/>[Position.java]"]
  node_board_exception["Board errors"]
end

node_player(("Player"))

node_player -->|"plays via"| node_program
node_program -->|"creates and moves"| node_match
node_program -->|"renders and reads"| node_ui
node_match -->|"updates and queries"| node_board
node_match -->|"creates pieces"| node_movement
node_match -->|"converts squares"| node_chess_position
node_match -->|"tracks pieces"| node_chess_piece
node_match -->|"sets turn sides"| node_color
node_match -->|"raises rule errors"| node_chess_exception
node_chess_position -->|"converts coordinates"| node_position
node_chess_position -->|"rejects invalid squares"| node_chess_exception
node_chess_piece -->|"extends"| node_piece
node_chess_piece -->|"checks occupancy"| node_board
node_chess_piece -->|"formats position"| node_chess_position
node_piece -->|"stores on"| node_board
node_piece -->|"uses coordinates"| node_position
node_board -->|"places and removes"| node_piece
node_board -->|"indexes by"| node_position
node_board -->|"raises bounds errors"| node_board_exception
node_movement -->|"queries legal moves"| node_board
node_movement -->|"extends and checks"| node_chess_piece
node_movement -->|"calculates squares"| node_position
node_movement -->|"checks sides"| node_color
node_chess_exception -->|"extends"| node_board_exception

click node_program "https://github.com/flavioasp77/chess-system-java/blob/main/src/application/Program.java"
click node_ui "https://github.com/flavioasp77/chess-system-java/blob/main/src/application/UI.java"
click node_match "https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessMatch.java"
click node_chess_position "https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessPosition.java"
click node_chess_exception "https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessException.java"
click node_color "https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/Color.java"
click node_chess_piece "https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessPiece.java"
click node_movement "https://github.com/flavioasp77/chess-system-java/tree/main/src/chess/pieces"
click node_board "https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/Board.java"
click node_piece "https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/Piece.java"
click node_position "https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/Position.java"
click node_board_exception "https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/BoardException.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_program,node_ui toneBlue
class node_match,node_chess_position,node_chess_exception,node_color toneAmber
class node_chess_piece,node_movement toneMint
class node_board,node_piece,node_position,node_board_exception toneRose
class node_player toneIndigo
```

## Components

### Console interface

- [Game loop](https://github.com/flavioasp77/chess-system-java/blob/main/src/application/Program.java): `src/application/Program.java`
- [Console UI](https://github.com/flavioasp77/chess-system-java/blob/main/src/application/UI.java): `src/application/UI.java`

### Chess rules

- [Match engine](https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessMatch.java): `src/chess/ChessMatch.java`
- [Chess coordinates](https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessPosition.java): `src/chess/ChessPosition.java`
- [Chess errors](https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessException.java): `src/chess/ChessException.java`
- [Piece colors](https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/Color.java): `src/chess/Color.java`

### Piece movement

- [Chess piece base](https://github.com/flavioasp77/chess-system-java/blob/main/src/chess/ChessPiece.java): `src/chess/ChessPiece.java`
- [Piece movement rules](https://github.com/flavioasp77/chess-system-java/tree/main/src/chess/pieces): `src/chess/pieces`

### Board model

- [Board state](https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/Board.java): `src/boardgame/Board.java`
- [Board piece base](https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/Piece.java): `src/boardgame/Piece.java`
- [Board coordinates](https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/Position.java): `src/boardgame/Position.java`
- [Board errors](https://github.com/flavioasp77/chess-system-java/blob/main/src/boardgame/BoardException.java): `src/boardgame/BoardException.java`

### Other components

- **Player**

## Connections

- Player → Game loop: plays via (evidence: `README.md`)
- Game loop → Match engine: creates and moves (evidence: `src/application/Program.java`)
- Game loop → Console UI: renders and reads (evidence: `src/application/Program.java`)
- Match engine → Board state: updates and queries (evidence: `src/chess/ChessMatch.java`)
- Match engine → Piece movement rules: creates pieces (evidence: `src/chess/ChessMatch.java`)
- Match engine → Chess coordinates: converts squares (evidence: `src/chess/ChessMatch.java`)
- Match engine → Chess piece base: tracks pieces (evidence: `src/chess/ChessMatch.java`)
- Match engine → Piece colors: sets turn sides (evidence: `src/chess/ChessMatch.java`)
- Match engine → Chess errors: raises rule errors (evidence: `src/chess/ChessMatch.java`)
- Chess coordinates → Board coordinates: converts coordinates (evidence: `src/chess/ChessPosition.java`)
- Chess coordinates → Chess errors: rejects invalid squares (evidence: `src/chess/ChessPosition.java`)
- Chess piece base → Board piece base: extends (evidence: `src/chess/ChessPiece.java`)
- Chess piece base → Board state: checks occupancy (evidence: `src/chess/ChessPiece.java`)
- Chess piece base → Chess coordinates: formats position (evidence: `src/chess/ChessPiece.java`)
- Board piece base → Board state: stores on (evidence: `src/boardgame/Piece.java`)
- Board piece base → Board coordinates: uses coordinates (evidence: `src/boardgame/Piece.java`)
- Board state → Board piece base: places and removes (evidence: `src/boardgame/Board.java`)
- Board state → Board coordinates: indexes by (evidence: `src/boardgame/Board.java`)
- Board state → Board errors: raises bounds errors (evidence: `src/boardgame/Board.java`)
- Piece movement rules → Board state: queries legal moves (evidence: `src/chess/pieces/Rook.java`)
- Piece movement rules → Chess piece base: extends and checks (evidence: `src/chess/pieces/Rook.java`)
- Piece movement rules → Board coordinates: calculates squares (evidence: `src/chess/pieces/Rook.java`)
- Piece movement rules → Piece colors: checks sides (evidence: `src/chess/pieces/Rook.java`)
- Chess errors → Board errors: extends (evidence: `src/chess/ChessException.java`)
