feat(Dashboard.java): ajout commentaire

src/Dashboard.java

@@ -1,25 +1,46 @@
 import java.awt.BorderLayout;
 import java.awt.event.MouseAdapter;
 import java.awt.event.MouseEvent;
-
 import java.util.function.Supplier;
-
 import javax.swing.JButton;
 import javax.swing.JLabel;
 
-
 /**
- * bouton en bas, couleur choisi de la fenetre
+ * Dashboard représente une vue graphique pour une voiture spécifique.
- * affiche: carburant restant et tour de piste
+ * <p>
+ * Il affiche :
+ * <ul>
+ *   <li>Le carburant restant</li>
+ *   <li>Le nombre de tours complétés</li>
+ * </ul>
+ * et fournit un bouton pour mettre en pause ou reprendre le jeu.
+ * </p>
  */
 public class Dashboard extends GameView  
 {
+    /** Label affichant le carburant et les tours */
     private final JLabel label;
+
+    /** Bouton pause/reprise */
     private final JButton button;
+
+    /** Voiture associée à ce dashboard */
     private final Car car;
 
+    /** État de pause global partagé par tous les dashboards */
     private static boolean isPaused = false;
 
+    /**
+     * Construit un dashboard pour une voiture donnée.
+     *
+     * @param car  la voiture suivie par ce dashboard
+     * @param title titre du dashboard
+     * @param fn  fonction appelée pour activer/désactiver la pause
+     * @param width largeur de la fenêtre
+     * @param height hauteur de la fenêtre
+     * @param x position horizontale de la fenêtre
+     * @param y position verticale de la fenêtre
+     */
     public Dashboard(Car car, String title, Supplier<Boolean> fn, int width, int height, int x, int y)
     {
         super("Dashboard: " + title, width, height, x, y);
@@ -28,7 +49,6 @@ public class Dashboard extends GameView
         this.label = new JLabel();
         this.button = new JButton();
 
-		// ajout background
         frame.setBackground(car.getColor());
 
         init(fn);
@@ -37,17 +57,24 @@ public class Dashboard extends GameView
         this.add(button, BorderLayout.SOUTH);
     }
 
-	// fonction uniquement pour l'affichage dynamique
+    /**
+     * Met à jour le texte du bouton en fonction de l'état de pause.
+     */
     private void updateButtonText()
     {
         button.setText(isPaused ? "En Pause" : "En Cours");
     }
 
+    /**
+     * Initialise le listener du bouton pour gérer la pause.
+     *
+     * @param fn fonction appelée lorsque l'on clique sur le bouton pour inverser l'état de pause
+     */
     private void init(Supplier<Boolean> fn)
     {
         updateButtonText();
 
-		// classe pour le bouton
+		// classe anonyme pour le bouton
         MouseAdapter ma = new MouseAdapter() {
             @Override
             public void mouseClicked(MouseEvent e)
@@ -61,6 +88,11 @@ public class Dashboard extends GameView
         this.button.addMouseListener(ma);
     }
 
+    /**
+     * Met à jour l'affichage du dashboard pour refléter
+     * le carburant et le nombre de tours de la voiture.
+     * Cette méthode est appelée périodiquement par le moteur de jeu.
+     */
     @Override
     public void run()
     {