From fb4f4798ddaa617547f502eb4d82241994645a40 Mon Sep 17 00:00:00 2001
From: mirage <119869686+ClementBobin@users.noreply.github.com>
Date: Wed, 4 Mar 2026 13:05:41 +0100
Subject: [PATCH] =?UTF-8?q?feat:=20Ajout=20de=20la=20documentation=20XML?=
 =?UTF-8?q?=20pour=20les=20m=C3=A9thodes=20de=20g=C3=A9n=C3=A9ration=20dan?=
 =?UTF-8?q?s=20SeedDataLocal?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Webzine.Entity/Fixtures/SeedDataLocal.cs | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/Webzine.Entity/Fixtures/SeedDataLocal.cs b/Webzine.Entity/Fixtures/SeedDataLocal.cs
index 15ef444..27204c4 100644
--- a/Webzine.Entity/Fixtures/SeedDataLocal.cs
+++ b/Webzine.Entity/Fixtures/SeedDataLocal.cs
@@ -1,6 +1,6 @@
 namespace Webzine.Entity.Fixtures;
 
-using Webzine.Entity;
+using Entity;
 using Faker;
 using System;
 using System.Collections.Generic;
@@ -8,6 +8,9 @@ using System.Linq;
 
 public class SeedDataLocal
 {
+    /// <summary>
+    /// Dictionnaire contenant des données de musique réelles pour les titres générés.
+    /// </summary>
     public Dictionary<string, (string TrackUrl, string ImageUrl)> RealMusicData { get; set; }
         = new Dictionary<string, (string TrackUrl, string ImageUrl)>
     {
@@ -66,6 +69,11 @@ public class SeedDataLocal
 
     }
 
+    /// <summary>
+    /// Génère une liste de styles de musique à partir d'une liste prédéfinie de noms de styles.
+    /// </summary>
+    /// <param name="count">Nombre de styles à générer (maximum 15, car il y a 15 styles prédéfinis)</param>
+    /// <returns>Liste de styles de musique générés</returns>
     public List<Style> GenerateStyles(int count)
     {
         var styleNames = new[] { "Rock", "Pop", "Rap", "Électro", "Jazz", "Classique", "Reggae", "Blues", "Metal", "Folk", "Chanson française", "Hip-Hop", "R&B", "Soul", "Punk" };
@@ -83,6 +91,12 @@ public class SeedDataLocal
         return styles;
     }
 
+    /// <summary>
+    /// Génère une liste de titres de musique en utilisant des données de musique réelles pour les URL d'écoute et les jaquettes.
+    /// </summary>
+    /// <param name="count">Nombre de titres à générer</param>
+    /// <param name="artists">Liste des artistes à associer aux titres générés</param>
+    /// <returns>Liste de titres de musique générés</returns>
     public List<Titre> GenerateTitres(int count, List<Artiste> artists)
     {
         var titres = new List<Titre>();
@@ -118,6 +132,12 @@ public class SeedDataLocal
         return titres;
     }
 
+    /// <summary>
+    /// Génère une liste de commentaires pour les titres de musique générés, en associant chaque commentaire à un titre aléatoire.
+    /// </summary>
+    /// <param name="count">Nombre de commentaires à générer</param>
+    /// <param name="titres">Liste des titres de musique à associer aux commentaires générés</param>
+    /// <returns>Liste de commentaires générés</returns>
     public List<Commentaire> GenerateCommentaires(int count, List<Titre> titres)
     {
         var commentaires = new List<Commentaire>();