feat: Ajout de la documentation XML pour les méthodes de génération dans SeedDataLocal

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>();