# vianneychaillou/java-battleship-project architecture

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

- Interactive diagram: https://gitdiagram.com/vianneychaillou/java-battleship-project
- Repository: https://github.com/vianneychaillou/java-battleship-project

## Overview

Java Battleship is a Swing desktop game organized around MVC. The player places ships, starts combat, and targets the opponent’s grid; the match model records shots, tracks turns and win conditions, and makes the computer retaliate after each player turn. The model also handles randomized fleet placement, hit/miss/sunk results, and five ship types; the view renders both grids and status feedback. Edges rely on sampled source or README evidence; unsampled implementation details are not inferred.

Main entry points: [`modele/Flotte.java`](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Flotte.java) (Fleet and shots), [`modele/Partie.java`](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Partie.java) (Match state), [`modele/Bateau.java`](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Bateau.java) (Ship behavior), [`vue/PanneauGrille.java`](https://github.com/vianneychaillou/java-battleship-project/blob/main/vue/PanneauGrille.java) (Battle grids)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Swing interface"]
  node_window["Game window<br/>[Fenetre.java]"]
  node_grid["Battle grids<br/>[PanneauGrille.java]"]
  node_information["Status panel"]
end

subgraph group_input["Input handling"]
  node_placement["Placement input"]
  node_mouse["Combat input<br/>[GestionSouris.java]"]
end

subgraph group_match["Match flow"]
  node_application["Application entry<br/>[Application.java]"]
  node_partie["Match state<br/>[Partie.java]"]
  node_ai["Computer targeting<br/>[Partie.java]"]
  node_game_state["Game phases<br/>[EtatJeu.java]"]
  node_constants["Game constants<br/>[Constantes.java]"]
end

subgraph group_domain["Fleet and ships"]
  node_fleet["Fleet and shots<br/>[Flotte.java]"]
  node_ship["Ship behavior<br/>[Bateau.java]"]
  node_position["Grid position<br/>[Position.java]"]
  node_torpedo["Torpedo boat<br/>[LanceTorpille.java]"]
  node_destroyer["Destroyer"]
  node_submarine["Submarine<br/>[SousMarin.java]"]
  node_battleship["Battleship<br/>[Cuirasse.java]"]
  node_carrier["Aircraft carrier<br/>[PorteAvions.java]"]
end

node_player(("Player"))

node_application -.->|"starts"| node_partie
node_application -.->|"opens"| node_window
node_player -->|"clicks"| node_grid
node_grid -->|"registers"| node_placement
node_grid -->|"registers"| node_mouse
node_placement -->|"checks phase"| node_partie
node_placement -->|"removes ship"| node_fleet
node_mouse -->|"registers shot"| node_partie
node_window -->|"owns match"| node_partie
node_window -->|"creates"| node_grid
node_window -->|"updates"| node_information
node_grid -->|"renders"| node_fleet
node_partie -->|"manages fleets"| node_fleet
node_partie -->|"tracks phase"| node_game_state
node_partie -->|"runs retaliation"| node_ai
node_ai -->|"fires shots"| node_fleet
node_fleet -->|"creates and tests"| node_ship
node_fleet -->|"records shots"| node_position
node_fleet -->|"places"| node_torpedo
node_fleet -->|"places"| node_destroyer
node_fleet -->|"places"| node_submarine
node_fleet -->|"places"| node_battleship
node_fleet -->|"places"| node_carrier
node_ship -->|"builds segments"| node_position
node_torpedo -->|"extends"| node_ship
node_destroyer -->|"extends"| node_ship
node_submarine -->|"extends"| node_ship
node_battleship -->|"extends"| node_ship
node_carrier -->|"extends"| node_ship

click node_application "https://github.com/vianneychaillou/java-battleship-project/blob/main/Application.java"
click node_window "https://github.com/vianneychaillou/java-battleship-project/blob/main/vue/Fenetre.java"
click node_grid "https://github.com/vianneychaillou/java-battleship-project/blob/main/vue/PanneauGrille.java"
click node_information "https://github.com/vianneychaillou/java-battleship-project/blob/main/vue/PanneauInformation.java"
click node_placement "https://github.com/vianneychaillou/java-battleship-project/blob/main/controleur/GestionPlacement.java"
click node_mouse "https://github.com/vianneychaillou/java-battleship-project/blob/main/controleur/GestionSouris.java"
click node_partie "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Partie.java"
click node_ai "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Partie.java"
click node_game_state "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/EtatJeu.java"
click node_constants "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Constantes.java"
click node_fleet "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Flotte.java"
click node_ship "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Bateau.java"
click node_position "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Position.java"
click node_torpedo "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/LanceTorpille.java"
click node_destroyer "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/ContreTorpilleur.java"
click node_submarine "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/SousMarin.java"
click node_battleship "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Cuirasse.java"
click node_carrier "https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/PorteAvions.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_window,node_grid,node_information toneBlue
class node_placement,node_mouse toneAmber
class node_application,node_partie,node_ai,node_game_state,node_constants toneMint
class node_fleet,node_ship,node_position,node_torpedo,node_destroyer,node_submarine,node_battleship,node_carrier toneRose
class node_player toneIndigo
```

## Components

### Swing interface

- [Game window](https://github.com/vianneychaillou/java-battleship-project/blob/main/vue/Fenetre.java): `vue/Fenetre.java`
- [Battle grids](https://github.com/vianneychaillou/java-battleship-project/blob/main/vue/PanneauGrille.java): `vue/PanneauGrille.java`
- [Status panel](https://github.com/vianneychaillou/java-battleship-project/blob/main/vue/PanneauInformation.java): `vue/PanneauInformation.java`

### Input handling

- [Placement input](https://github.com/vianneychaillou/java-battleship-project/blob/main/controleur/GestionPlacement.java): `controleur/GestionPlacement.java`
- [Combat input](https://github.com/vianneychaillou/java-battleship-project/blob/main/controleur/GestionSouris.java): `controleur/GestionSouris.java`

### Match flow

- [Application entry](https://github.com/vianneychaillou/java-battleship-project/blob/main/Application.java): `Application.java`
- [Match state](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Partie.java): `modele/Partie.java`
- [Computer targeting](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Partie.java): `modele/Partie.java`
- [Game phases](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/EtatJeu.java): `modele/EtatJeu.java`
- [Game constants](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Constantes.java): `modele/Constantes.java`

### Fleet and ships

- [Fleet and shots](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Flotte.java): `modele/Flotte.java`
- [Ship behavior](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Bateau.java): `modele/Bateau.java`
- [Grid position](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Position.java): `modele/Position.java`
- [Torpedo boat](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/LanceTorpille.java): `modele/LanceTorpille.java`
- [Destroyer](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/ContreTorpilleur.java): `modele/ContreTorpilleur.java`
- [Submarine](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/SousMarin.java): `modele/SousMarin.java`
- [Battleship](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/Cuirasse.java): `modele/Cuirasse.java`
- [Aircraft carrier](https://github.com/vianneychaillou/java-battleship-project/blob/main/modele/PorteAvions.java): `modele/PorteAvions.java`

### Other components

- **Player**

## Connections

- Application entry → Match state: starts (evidence: `Application.java`)
- Application entry → Game window: opens (evidence: `Application.java`)
- Player → Battle grids: clicks (evidence: `README.md`)
- Battle grids → Placement input: registers (evidence: `vue/PanneauGrille.java`)
- Battle grids → Combat input: registers (evidence: `vue/PanneauGrille.java`)
- Placement input → Match state: checks phase (evidence: `controleur/GestionPlacement.java`)
- Placement input → Fleet and shots: removes ship (evidence: `controleur/GestionPlacement.java`)
- Combat input → Match state: registers shot (evidence: `controleur/GestionSouris.java`)
- Game window → Match state: owns match (evidence: `vue/Fenetre.java`)
- Game window → Battle grids: creates (evidence: `vue/Fenetre.java`)
- Game window → Status panel: updates (evidence: `vue/Fenetre.java`)
- Battle grids → Fleet and shots: renders (evidence: `vue/PanneauGrille.java`)
- Match state → Fleet and shots: manages fleets (evidence: `modele/Partie.java`)
- Match state → Game phases: tracks phase (evidence: `modele/Partie.java`)
- Match state → Computer targeting: runs retaliation (evidence: `modele/Partie.java`)
- Computer targeting → Fleet and shots: fires shots (evidence: `modele/Partie.java`)
- Fleet and shots → Ship behavior: creates and tests (evidence: `modele/Flotte.java`)
- Fleet and shots → Grid position: records shots (evidence: `modele/Flotte.java`)
- Fleet and shots → Torpedo boat: places (evidence: `modele/Flotte.java`)
- Fleet and shots → Destroyer: places (evidence: `modele/Flotte.java`)
- Fleet and shots → Submarine: places (evidence: `modele/Flotte.java`)
- Fleet and shots → Battleship: places (evidence: `modele/Flotte.java`)
- Fleet and shots → Aircraft carrier: places (evidence: `modele/Flotte.java`)
- Ship behavior → Grid position: builds segments (evidence: `modele/Bateau.java`)
- Torpedo boat → Ship behavior: extends (evidence: `modele/LanceTorpille.java`)
- Destroyer → Ship behavior: extends (evidence: `modele/ContreTorpilleur.java`)
- Submarine → Ship behavior: extends (evidence: `modele/SousMarin.java`)
- Battleship → Ship behavior: extends (evidence: `modele/Cuirasse.java`)
- Aircraft carrier → Ship behavior: extends (evidence: `modele/PorteAvions.java`)
