# oscat725/projetpirate_groupe2 architecture

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

- Interactive diagram: https://gitdiagram.com/oscat725/projetpirate_groupe2
- Repository: https://github.com/oscat725/projetpirate_groupe2

## Overview

1. This is a Java desktop game project, likely built with NetBeans and Swing. The source of truth is under `src/main/java`; the `build`, `dist`, and `bin` trees are generated artifacts and older copies that should not drive the architecture diagram.

2. The code is organized around a layered, MVC-like split with French naming:
   - `presentation` and `console` are user-facing entry points.
   - `controleur` contains application logic and orchestration.
   - `entity` contains the game model.
   - `interface_noyau_fonctionnel` and `noyau_fonctionnel` form an abstraction/adapter boundary between the UI layer and the core game logic.

3. The main runtime entry point appears to be `onepiece.projetpirate.ProjetPirate`. From there, the app can launch either the graphical UI or the console-oriented boundary classes.

4. The graphical frontend is in `presentation` and is Swing-based, as shown by the `.form` files (`MainFrame.form`, `PanelCase.form`). The visible UI is composed of `MainFrame`, `PanelPlateau`, `PanelCase`, and `PanelDe`, which together likely render the board, board cells, and dice.

5. There is also a console-facing path in `console` with `BoundaryCommencerPartie` and `BoundaryLancerDe`. This suggests the same game engine can be driven through a text-based interface, with the UI layer swapped without changing the core domain.

6. The controller layer coordinates game actions and state transitions. The main controllers are:
   - `ControlCommencerPartie` for game setup,
   - `ControlDeplacer` for moving the pirate token,
   - `ControleurDe` / `ControlCacherDe` for die handling,
   - `ControlActiverCaseCoco` for special board-case behavior,
   - `ControlPointDeVie` and `ControlVerifierFinPartie` for health/endgame logic,
   - `ControlJeuPirate` as the broader game coordinator.

7. The model is centered on board-game entities in `entity`:
   - `Jeu` is the aggregate root for a match,
   - `Plateau` represents the board,
   - `Joueur` and `Pion` represent players and pieces,
   - `De` is the die,
   - `Case` is the base board cell type,
   - `CaseBombe`, `CaseCoco`, and `CaseMystere` are specialized cell behaviors,
   - `Couleur` is likely an enum used for player identity or UI styling.

8. The architecture suggests state flows from UI to controller to entity model, then back to the UI. User actions such as starting a game, rolling dice, or moving a piece are handled by the controller layer, which mutates the model and then updates presentation components.

9. `interface_noyau_fonctionnel` defines the public contracts (`INoyauFonctionnel`, `IPirates`) that insulate the rest of the app from implementation details. `noyau_fonctionnel.AdaptateurNoyauFonctionel` likely implements that bridge, translating UI/controller requests into core game operations.

10. `boundary` and `frontiere` appear to be overlapping or legacy naming for boundary-layer classes/interfaces. For diagramming, the important distinction is not the package name but the role: these classes sit at the edge of the application and mediate between user interaction and the game engine.

11. There are no visible external services, databases, or network dependencies. The system appears self-contained: a local, stateful game application with in-memory domain objects and a Swing/console presentation layer.

12. A good architecture diagram should emphasize three major zones: presentation/boundary, controller/adapter, and domain model. The central data path is UI event -> controller -> `Jeu`/`Plateau`/`Joueur`/`Case` -> updated UI state, with the interface packages acting as the seam between layers.

Main entry points: [`ProjetPirate/src/main/java/noyau_fonctionnel/AdaptateurNoyauFonctionel.java`](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/noyau_fonctionnel/AdaptateurNoyauFonctionel.java) (Adapter), [`ProjetPirate/src/main/java/entity/Jeu.java`](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Jeu.java) (Jeu), [`ProjetPirate/src/main/java/controleur/ControlJeuPirate.java`](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlJeuPirate.java) (GameCtrl), [`ProjetPirate/src/main/java/presentation/MainFrame.java`](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/MainFrame.java) (MainFrame)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_onepiece_projetpirate_pli(("ProjetPirate<br/>main entry<br/>[ProjetPirate.java]"))
end

subgraph group_ui["Presentation"]
  node_presentation_mainframe["MainFrame<br/>swing window<br/>[MainFrame.java]"]
  node_presentation_panelplateau["PanelPlateau<br/>swing board<br/>[PanelPlateau.java]"]
  node_presentation_panelcase["PanelCase<br/>swing cell<br/>[PanelCase.java]"]
  node_presentation_panelde["PanelDe<br/>swing dice<br/>[PanelDe.java]"]
  node_console_commencer["BoundaryStart<br/>console boundary"]
  node_console_lancerde["BoundaryDice<br/>console boundary"]
end

subgraph group_control["Controller"]
  node_controleur_commencer["StartGame<br/>controller"]
  node_controleur_deplacer["MovePirate<br/>controller"]
  node_controleur_de["DiceCtrl<br/>controller<br/>[ControleurDe.java]"]
  node_controleur_cacherde["HideDice<br/>controller"]
  node_controleur_casecoco["CocoCase<br/>controller"]
  node_controleur_vie["Health<br/>controller"]
  node_controleur_fin["EndCheck<br/>controller"]
  node_controleur_jeu["GameCtrl<br/>controller"]
end

subgraph group_seam["Core seam"]
  node_seam_iface["INoyau<br/>core port"]
  node_seam_pirates["IPirates<br/>core port<br/>[IPirates.java]"]
  node_seam_adapter["Adapter"]
end

subgraph group_domain["Domain"]
  node_domain_jeu[("Jeu<br/>aggregate<br/>[Jeu.java]")]
  node_domain_plateau["Plateau<br/>board model<br/>[Plateau.java]"]
  node_domain_joueur["Joueur<br/>player model<br/>[Joueur.java]"]
  node_domain_pion["Pion<br/>piece model<br/>[Pion.java]"]
  node_domain_case["Case<br/>cell model<br/>[Case.java]"]
  node_domain_specials["Special cases<br/>cell variants<br/>[CaseBombe.java]"]
  node_domain_de["De<br/>[De.java]"]
end

node_onepiece_projetpirate_pli -->|"launches UI"| node_presentation_mainframe
node_onepiece_projetpirate_pli -->|"launches console"| node_console_commencer
node_presentation_mainframe -->|"contains"| node_presentation_panelplateau
node_presentation_mainframe -->|"contains"| node_presentation_panelde
node_presentation_panelplateau -->|"renders"| node_presentation_panelcase
node_console_commencer -->|"calls core"| node_seam_adapter
node_console_lancerde -->|"calls core"| node_seam_adapter
node_presentation_mainframe -->|"uses"| node_seam_adapter
node_controleur_jeu -->|"orchestrates"| node_controleur_commencer
node_controleur_jeu -->|"orchestrates"| node_controleur_deplacer
node_controleur_jeu -->|"orchestrates"| node_controleur_de
node_controleur_jeu -->|"orchestrates"| node_controleur_fin
node_controleur_deplacer -->|"mutates"| node_domain_jeu
node_controleur_de -->|"updates"| node_domain_de
node_controleur_casecoco -->|"evaluates"| node_domain_case
node_controleur_vie -->|"updates"| node_domain_joueur
node_controleur_fin -->|"checks"| node_domain_jeu
node_seam_adapter -->|"implements"| node_seam_iface
node_seam_adapter -->|"implements"| node_seam_pirates
node_seam_adapter -->|"delegates"| node_controleur_jeu
node_seam_adapter -->|"drives"| node_domain_jeu
node_domain_jeu -->|"owns"| node_domain_plateau
node_domain_jeu -->|"tracks"| node_domain_joueur
node_domain_jeu -->|"uses"| node_domain_de
node_domain_jeu -->|"tracks"| node_domain_pion
node_domain_plateau -->|"contains"| node_domain_case
node_domain_case -->|"specializes"| node_domain_specials
node_domain_pion -->|"moves on"| node_domain_case

click node_onepiece_projetpirate_pli "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/onepiece/projetpirate/ProjetPirate.java"
click node_presentation_mainframe "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/MainFrame.java"
click node_presentation_panelplateau "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/PanelPlateau.java"
click node_presentation_panelcase "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/PanelCase.java"
click node_presentation_panelde "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/PanelDe.java"
click node_console_commencer "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/console/BoundaryCommencerPartie.java"
click node_console_lancerde "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/console/BoundaryLancerDe.java"
click node_controleur_commencer "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlCommencerPartie.java"
click node_controleur_deplacer "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlDeplacer.java"
click node_controleur_de "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControleurDe.java"
click node_controleur_cacherde "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlCacherDe.java"
click node_controleur_casecoco "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlActiverCaseCoco.java"
click node_controleur_vie "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlPointDeVie.java"
click node_controleur_fin "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlVerifierFinPartie.java"
click node_controleur_jeu "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlJeuPirate.java"
click node_seam_iface "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/interface_noyau_fonctionnel/INoyauFonctionnel.java"
click node_seam_pirates "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/interface_noyau_fonctionnel/IPirates.java"
click node_seam_adapter "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/noyau_fonctionnel/AdaptateurNoyauFonctionel.java"
click node_domain_jeu "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Jeu.java"
click node_domain_plateau "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Plateau.java"
click node_domain_joueur "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Joueur.java"
click node_domain_pion "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Pion.java"
click node_domain_case "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Case.java"
click node_domain_specials "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/CaseBombe.java"
click node_domain_de "https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/De.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_onepiece_projetpirate_pli toneBlue
class node_presentation_mainframe,node_presentation_panelplateau,node_presentation_panelcase,node_presentation_panelde,node_console_commencer,node_console_lancerde toneAmber
class node_controleur_commencer,node_controleur_deplacer,node_controleur_de,node_controleur_cacherde,node_controleur_casecoco,node_controleur_vie,node_controleur_fin,node_controleur_jeu toneMint
class node_seam_iface,node_seam_pirates,node_seam_adapter toneRose
class node_domain_jeu,node_domain_plateau,node_domain_joueur,node_domain_pion,node_domain_case,node_domain_specials,node_domain_de toneIndigo
```

## Components

### Runtime

Application entry point and launch path

- [ProjetPirate](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/onepiece/projetpirate/ProjetPirate.java): main entry · Application bootstrap and launch selection · `ProjetPirate/src/main/java/onepiece/projetpirate/ProjetPirate.java`

### Presentation

Swing and console user-facing boundaries

- [MainFrame](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/MainFrame.java): swing window · Main graphical window · `ProjetPirate/src/main/java/presentation/MainFrame.java`
- [PanelPlateau](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/PanelPlateau.java): swing board · Board rendering and layout · `ProjetPirate/src/main/java/presentation/PanelPlateau.java`
- [PanelCase](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/PanelCase.java): swing cell · Single board-cell view · `ProjetPirate/src/main/java/presentation/PanelCase.java`
- [PanelDe](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/presentation/PanelDe.java): swing dice · Dice display and interaction · `ProjetPirate/src/main/java/presentation/PanelDe.java`
- [BoundaryStart](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/console/BoundaryCommencerPartie.java): console boundary · Text-mode game start boundary · `ProjetPirate/src/main/java/console/BoundaryCommencerPartie.java`
- [BoundaryDice](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/console/BoundaryLancerDe.java): console boundary · Text-mode dice boundary · `ProjetPirate/src/main/java/console/BoundaryLancerDe.java`

### Controller

Application coordination and game actions

- [StartGame](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlCommencerPartie.java): controller · Initial game setup orchestration · `ProjetPirate/src/main/java/controleur/ControlCommencerPartie.java`
- [MovePirate](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlDeplacer.java): controller · Piece movement and turn action · `ProjetPirate/src/main/java/controleur/ControlDeplacer.java`
- [DiceCtrl](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControleurDe.java): controller · Dice roll coordination · `ProjetPirate/src/main/java/controleur/ControleurDe.java`
- [HideDice](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlCacherDe.java): controller · Dice visibility/state handling · `ProjetPirate/src/main/java/controleur/ControlCacherDe.java`
- [CocoCase](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlActiverCaseCoco.java): controller · Special coconut-case behavior · `ProjetPirate/src/main/java/controleur/ControlActiverCaseCoco.java`
- [Health](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlPointDeVie.java): controller · Life-point management · `ProjetPirate/src/main/java/controleur/ControlPointDeVie.java`
- [EndCheck](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlVerifierFinPartie.java): controller · End-of-game verification · `ProjetPirate/src/main/java/controleur/ControlVerifierFinPartie.java`
- [GameCtrl](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/controleur/ControlJeuPirate.java): controller · Top-level game coordinator · `ProjetPirate/src/main/java/controleur/ControlJeuPirate.java`

### Core seam

Interface contracts and adapter between UI and game logic

- [INoyau](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/interface_noyau_fonctionnel/INoyauFonctionnel.java): core port · Functional-core contract · `ProjetPirate/src/main/java/interface_noyau_fonctionnel/INoyauFonctionnel.java`
- [IPirates](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/interface_noyau_fonctionnel/IPirates.java): core port · Game-facing interface contract · `ProjetPirate/src/main/java/interface_noyau_fonctionnel/IPirates.java`
- [Adapter](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/noyau_fonctionnel/AdaptateurNoyauFonctionel.java): core adapter · Bridges UI/controller calls into core game operations · `ProjetPirate/src/main/java/noyau_fonctionnel/AdaptateurNoyauFonctionel.java`

### Domain

Game state and board entities

- [Jeu](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Jeu.java): aggregate · Match state and orchestration root · `ProjetPirate/src/main/java/entity/Jeu.java`
- [Plateau](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Plateau.java): board model · Board and board-state model · `ProjetPirate/src/main/java/entity/Plateau.java`
- [Joueur](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Joueur.java): player model · Player state · `ProjetPirate/src/main/java/entity/Joueur.java`
- [Pion](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Pion.java): piece model · Movable pirate token · `ProjetPirate/src/main/java/entity/Pion.java`
- [Case](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/Case.java): cell model · Base board-cell type · `ProjetPirate/src/main/java/entity/Case.java`
- [Special cases](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/CaseBombe.java): cell variants · Bomb, coconut, and mystery cell behavior · `ProjetPirate/src/main/java/entity/CaseBombe.java`
- [De](https://github.com/oscat725/projetpirate_groupe2/blob/main/ProjetPirate/src/main/java/entity/De.java): dice model · Dice state and value · `ProjetPirate/src/main/java/entity/De.java`

## Connections

- ProjetPirate → MainFrame: launches UI · Starts the graphical application path
- ProjetPirate → BoundaryStart: launches console · Starts the text boundary path
- MainFrame → PanelPlateau: contains · Main window embeds the board view
- MainFrame → PanelDe: contains · Main window embeds dice UI
- PanelPlateau → PanelCase: renders · Board view is composed of cell panels
- BoundaryStart → Adapter: calls core · Console boundary delegates into the adapter
- BoundaryDice → Adapter: calls core · Dice boundary delegates into the adapter
- MainFrame → Adapter: uses · Graphical UI talks to the core through the adapter
- GameCtrl → StartGame: orchestrates · Top-level controller coordinates setup
- GameCtrl → MovePirate: orchestrates · Top-level controller coordinates movement
- GameCtrl → DiceCtrl: orchestrates · Top-level controller coordinates dice flow
- GameCtrl → EndCheck: orchestrates · Top-level controller coordinates end checks
- MovePirate → Jeu: mutates · Movement updates match state
- DiceCtrl → De: updates · Dice controller changes die state
- CocoCase → Case: evaluates · Special-case logic acts on board cells
- Health → Joueur: updates · Health logic adjusts player state
- EndCheck → Jeu: checks · End-game logic inspects match state
- Adapter → INoyau: implements · Adapter fulfills the core contract
- Adapter → IPirates: implements · Adapter exposes the game-facing contract
- Adapter → GameCtrl: delegates · Adapter routes requests to the game controller
- Adapter → Jeu: drives · Adapter ultimately operates on the match model
- Jeu → Plateau: owns · Match contains the board
- Jeu → Joueur: tracks · Match tracks players
- Jeu → De: uses · Match includes dice state
- Jeu → Pion: tracks · Match tracks the pirate token
- Plateau → Case: contains · Board is made of cells
- Case → Special cases: specializes · Specialized cell behaviors extend the base cell model
- Pion → Case: moves on · Piece advances across board cells
