# cihanaslan12/scratch-javafx architecture

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

- Interactive diagram: https://gitdiagram.com/cihanaslan12/scratch-javafx
- Repository: https://github.com/cihanaslan12/scratch-javafx

## Overview

Scratch-JavaFX est une application de programmation visuelle : l’utilisateur compose un programme avec des actions, puis le charge et l’exécute pas à pas ou automatiquement dans un monde graphique. Le modèle gère les instructions, variables, boucles et l’état du personnage; les vues JavaFX affichent l’éditeur et le résultat. Le README documente aussi la sauvegarde et le chargement de fichiers texte, mais leur implémentation n’est pas identifiable dans les extraits. Les liens non documentés par les sources consultées sont omis.

Main entry points: [`src/main/java/scratch/model/Monde.java`](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Monde.java) (État du monde), [`src/main/java/scratch/view/MainView.java`](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/MainView.java) (Vue principale), [`src/main/java/scratch/viewmodel/MainViewModel.java`](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/MainViewModel.java) (Coordination UI), [`src/main/java/scratch/viewmodel/WorldViewModel.java`](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/WorldViewModel.java) (Contrôle exécution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Interface JavaFX"]
  node_app["Démarrage<br/>[App.java]"]
  node_mainview["Vue principale<br/>[MainView.java]"]
  node_actionsview["Palette d’actions<br/>[ActionsView.java]"]
  node_programview["Éditeur de programme<br/>[ProgramView.java]"]
  node_worldview["Vue du monde<br/>[WorldView.java]"]
end

subgraph group_editing["Composition du programme"]
  node_mainvm["Coordination UI<br/>[MainViewModel.java]"]
  node_actionsvm["Modèle palette"]
  node_programvm["Modèle programme"]
  node_persistence["Fichiers texte"]
end

subgraph group_runtime["Exécution et monde"]
  node_worldvm["Contrôle exécution"]
  node_monde["État du monde<br/>[Monde.java]"]
end

subgraph group_domain["Instructions et état"]
  node_programme["Programme ordonné<br/>[Programme.java]"]
  node_action["Actions exécutables<br/>[Action.java]"]
  node_drawpoly["Dessin polygonal<br/>[DrawPolygon.java]"]
  node_teleport["Téléportation<br/>[Teleportation.java]"]
  node_personnage["Personnage mobile<br/>[Personnage.java]"]
  node_segments["Tracés géométriques<br/>[Segment.java]"]
end

node_user(("Utilisateur"))

node_user -->|"choisit actions"| node_actionsview
node_app -->|"affiche"| node_mainview
node_mainview -->|"compose avec"| node_actionsview
node_mainview -->|"affiche"| node_programview
node_mainview -->|"affiche"| node_worldview
node_mainview -->|"utilise modèle"| node_mainvm
node_actionsview -->|"utilise modèle"| node_actionsvm
node_programview -->|"utilise modèle"| node_programvm
node_worldview -->|"utilise modèle"| node_worldvm
node_mainvm -->|"coordonne"| node_actionsvm
node_mainvm -->|"coordonne"| node_programvm
node_mainvm -->|"coordonne"| node_worldvm
node_actionsvm -->|"crée copies"| node_action
node_programvm -->|"manipule"| node_programme
node_worldvm -->|"exécute instruction"| node_programme
node_programme -->|"exécute"| node_action
node_action -->|"modifie état"| node_monde
node_drawpoly -->|"ajoute tracés"| node_monde
node_teleport -->|"déplace et trace"| node_monde
node_monde -->|"maintient position"| node_personnage
node_worldvm -->|"lit le monde"| node_monde
node_worldview -->|"rend les segments"| node_monde
node_monde -->|"stocke tracés"| node_segments
node_user -.->|"sauvegarde charge"| node_persistence

click node_app "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/App.java"
click node_mainview "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/MainView.java"
click node_actionsview "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/ActionsView.java"
click node_programview "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/ProgramView.java"
click node_worldview "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/WorldView.java"
click node_mainvm "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/MainViewModel.java"
click node_actionsvm "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/ActionsViewModel.java"
click node_programvm "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/ProgramViewModel.java"
click node_persistence "https://github.com/cihanaslan12/scratch-javafx/tree/main/src/main/java/scratch/viewmodel"
click node_worldvm "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/WorldViewModel.java"
click node_programme "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Programme.java"
click node_action "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Action.java"
click node_drawpoly "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/DrawPolygon.java"
click node_teleport "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Teleportation.java"
click node_monde "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Monde.java"
click node_personnage "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Personnage.java"
click node_segments "https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Segment.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_app,node_mainview,node_actionsview,node_programview,node_worldview toneBlue
class node_mainvm,node_actionsvm,node_programvm,node_persistence toneAmber
class node_worldvm,node_monde toneMint
class node_programme,node_action,node_drawpoly,node_teleport,node_personnage,node_segments toneRose
class node_user toneIndigo
```

## Components

### Interface JavaFX

- [Démarrage](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/App.java): `src/main/java/scratch/App.java`
- [Vue principale](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/MainView.java): `src/main/java/scratch/view/MainView.java`
- [Palette d’actions](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/ActionsView.java): `src/main/java/scratch/view/ActionsView.java`
- [Éditeur de programme](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/ProgramView.java): `src/main/java/scratch/view/ProgramView.java`
- [Vue du monde](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/view/WorldView.java): `src/main/java/scratch/view/WorldView.java`

### Composition du programme

- [Coordination UI](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/MainViewModel.java): `src/main/java/scratch/viewmodel/MainViewModel.java`
- [Modèle palette](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/ActionsViewModel.java): `src/main/java/scratch/viewmodel/ActionsViewModel.java`
- [Modèle programme](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/ProgramViewModel.java): `src/main/java/scratch/viewmodel/ProgramViewModel.java`
- [Fichiers texte](https://github.com/cihanaslan12/scratch-javafx/tree/main/src/main/java/scratch/viewmodel): `src/main/java/scratch/viewmodel`

### Exécution et monde

- [Contrôle exécution](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/viewmodel/WorldViewModel.java): `src/main/java/scratch/viewmodel/WorldViewModel.java`
- [État du monde](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Monde.java): `src/main/java/scratch/model/Monde.java`

### Instructions et état

- [Programme ordonné](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Programme.java): `src/main/java/scratch/model/Programme.java`
- [Actions exécutables](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Action.java): `src/main/java/scratch/model/Action.java`
- [Dessin polygonal](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/DrawPolygon.java): `src/main/java/scratch/model/DrawPolygon.java`
- [Téléportation](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Teleportation.java): `src/main/java/scratch/model/Teleportation.java`
- [Personnage mobile](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Personnage.java): `src/main/java/scratch/model/Personnage.java`
- [Tracés géométriques](https://github.com/cihanaslan12/scratch-javafx/blob/main/src/main/java/scratch/model/Segment.java): `src/main/java/scratch/model/Segment.java`

### Other components

- **Utilisateur**

## Connections

- Utilisateur → Palette d’actions: choisit actions (evidence: `README.md`)
- Démarrage → Vue principale: affiche (evidence: `src/main/java/scratch/App.java`)
- Vue principale → Palette d’actions: compose avec (evidence: `src/main/java/scratch/view/MainView.java`)
- Vue principale → Éditeur de programme: affiche (evidence: `src/main/java/scratch/view/MainView.java`)
- Vue principale → Vue du monde: affiche (evidence: `src/main/java/scratch/view/MainView.java`)
- Vue principale → Coordination UI: utilise modèle (evidence: `src/main/java/scratch/view/MainView.java`)
- Palette d’actions → Modèle palette: utilise modèle (evidence: `src/main/java/scratch/view/ActionsView.java`)
- Éditeur de programme → Modèle programme: utilise modèle (evidence: `src/main/java/scratch/view/ProgramView.java`)
- Vue du monde → Contrôle exécution: utilise modèle (evidence: `src/main/java/scratch/view/WorldView.java`)
- Coordination UI → Modèle palette: coordonne (evidence: `src/main/java/scratch/viewmodel/MainViewModel.java`)
- Coordination UI → Modèle programme: coordonne (evidence: `src/main/java/scratch/viewmodel/MainViewModel.java`)
- Coordination UI → Contrôle exécution: coordonne (evidence: `src/main/java/scratch/viewmodel/MainViewModel.java`)
- Modèle palette → Actions exécutables: crée copies (evidence: `src/main/java/scratch/viewmodel/ActionsViewModel.java`)
- Modèle programme → Programme ordonné: manipule (evidence: `src/main/java/scratch/viewmodel/ProgramViewModel.java`)
- Contrôle exécution → Programme ordonné: exécute instruction (evidence: `src/main/java/scratch/viewmodel/WorldViewModel.java`)
- Programme ordonné → Actions exécutables: exécute (evidence: `src/main/java/scratch/model/Programme.java`)
- Actions exécutables → État du monde: modifie état (evidence: `src/main/java/scratch/model/DrawPolygon.java`)
- Dessin polygonal → État du monde: ajoute tracés (evidence: `src/main/java/scratch/model/DrawPolygon.java`)
- Téléportation → État du monde: déplace et trace (evidence: `src/main/java/scratch/model/Teleportation.java`)
- État du monde → Personnage mobile: maintient position (evidence: `src/main/java/scratch/model/Monde.java`)
- Contrôle exécution → État du monde: lit le monde (evidence: `src/main/java/scratch/viewmodel/WorldViewModel.java`)
- Vue du monde → État du monde: rend les segments (evidence: `src/main/java/scratch/view/WorldView.java`)
- État du monde → Tracés géométriques: stocke tracés (evidence: `src/main/java/scratch/model/Monde.java`)
- Utilisateur → Fichiers texte: sauvegarde charge (evidence: `README.md`)
