doc sur les converter

WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteDTO.cs

@@ -1,9 +1,19 @@
 namespace WF_WebAdmin.Converter
 {
+    /// <summary>
+    /// Représente un objet de transfert de données (DTO) pour une citation quotidienne.
+    /// </summary>
     public class DailyQuoteDTO
     {
+        /// <summary>
+        /// Identifiant unique de la citation quotidienne.
+        /// </summary>
         private int Id { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="DailyQuoteDTO"/> avec un identifiant.
+        /// </summary>
+        /// <param name="id">L'identifiant unique de la citation quotidienne.</param>
         public DailyQuoteDTO(int id)
         {
             this.Id = id;

WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteExtension.cs

@@ -2,10 +2,19 @@
 
 namespace WF_WebAdmin.Converter
 {
+    /// <summary>
+    /// Fournit des extensions pour convertir des objets de type <see cref="DailyQuote"/> en objets de type <see cref="DailyQuoteDTO"/>.
+    /// </summary>
     public class DailyQuoteExtension
     {
+        /// <summary>
+        /// Convertit une instance de <see cref="DailyQuote"/> en une instance de <see cref="DailyQuoteDTO"/>.
+        /// </summary>
+        /// <param name="dq">L'objet <see cref="DailyQuote"/> à convertir.</param>
+        /// <returns>Une instance de <see cref="DailyQuoteDTO"/> contenant l'identifiant de la citation quotidienne.</returns>
         public DailyQuoteDTO DailyQuoteToDTO(DailyQuote dq)
         {
+            // Création de l'objet DTO à partir de l'objet DailyQuote
             DailyQuoteDTO dailyQuote = new DailyQuoteDTO(dq.Id);
             return dailyQuote;
         }

WF-WebAdmin/WF-WebAdmin/Converter/QuoteDTO.cs

@@ -3,25 +3,105 @@ using System;
 
 namespace WF_WebAdmin.Converter
 {
+    /// <summary>
+    /// Représente un objet Data Transfer Object (DTO) pour une citation.
+    /// </summary>
     public class QuoteDTO
     {
+        /// <summary>
+        /// Identifiant de la citation.
+        /// </summary>
         public int Id { get; set; }
+
+        /// <summary>
+        /// Contenu de la citation.
+        /// </summary>
         public string Content { get; set; }
+
+        /// <summary>
+        /// Nombre de "likes" de la citation.
+        /// </summary>
         public int Likes { get; set; }
+
+        /// <summary>
+        /// Langue de la citation.
+        /// </summary>
         public string Langue { get; set; }
+
+        /// <summary>
+        /// Indique si la citation est valide.
+        /// </summary>
         public bool IsValide { get; set; }
+
+        /// <summary>
+        /// Raison pour laquelle la citation pourrait être invalide.
+        /// </summary>
         public string? Reason { get; set; }
+
+        /// <summary>
+        /// Identifiant du caractère associé à la citation (si applicable).
+        /// </summary>
         public int? IdCaracter { get; set; }
+
+        /// <summary>
+        /// Nom du caractère associé à la citation (si applicable).
+        /// </summary>
         public string NameCharac { get; set; }
+
+        /// <summary>
+        /// Identifiant de la source de la citation.
+        /// </summary>
         public int? IdSource { get; set; }
+
+        /// <summary>
+        /// Titre de la source de la citation.
+        /// </summary>
         public string TitleSrc { get; set; }
+
+        /// <summary>
+        /// Date de la source de la citation.
+        /// </summary>
         public DateTime DateSrc { get; set; }
+
+        /// <summary>
+        /// Identifiant de l'utilisateur qui a vérifié la citation (si applicable).
+        /// </summary>
         public int? IdUserVerif { get; set; }
+
+        /// <summary>
+        /// Nom de l'utilisateur qui a vérifié la citation.
+        /// </summary>
         public string NameUser { get; set; }
+
+        /// <summary>
+        /// Identifiant de l'image associée à la citation (si applicable).
+        /// </summary>
         public int? IdImg { get; set; }
+
+        /// <summary>
+        /// Chemin de l'image associée à la citation.
+        /// </summary>
         public string ImgPath { get; set; }
 
-        public QuoteDTO(int id_quote,string content,int likes,string langue,bool isValide,string? reason,int? id_caracter,string name_charac,int? id_source,string title,DateTime date,int? id_user_verif,string name_user ,int? id_img,string img_path)
+        /// <summary>
+        /// Initialise une nouvelle instance de <see cref="QuoteDTO"/>.
+        /// </summary>
+        /// <param name="id_quote">L'identifiant de la citation.</param>
+        /// <param name="content">Le contenu de la citation.</param>
+        /// <param name="likes">Le nombre de likes de la citation.</param>
+        /// <param name="langue">La langue de la citation.</param>
+        /// <param name="isValide">Indique si la citation est valide.</param>
+        /// <param name="reason">La raison pour laquelle la citation peut être invalide.</param>
+        /// <param name="id_caracter">L'identifiant du caractère associé à la citation.</param>
+        /// <param name="name_charac">Le nom du caractère associé à la citation.</param>
+        /// <param name="id_source">L'identifiant de la source de la citation.</param>
+        /// <param name="title">Le titre de la source de la citation.</param>
+        /// <param name="date">La date de la source de la citation.</param>
+        /// <param name="id_user_verif">L'identifiant de l'utilisateur ayant vérifié la citation.</param>
+        /// <param name="name_user">Le nom de l'utilisateur ayant vérifié la citation.</param>
+        /// <param name="id_img">L'identifiant de l'image associée à la citation.</param>
+        /// <param name="img_path">Le chemin de l'image associée à la citation.</param>
+        public QuoteDTO(int id_quote, string content, int likes, string langue, bool isValide, string? reason, int? id_caracter, string name_charac, int? id_source, string title, DateTime date, int? id_user_verif, string name_user, int? id_img, string img_path)
         {
             this.Id = id_quote;
             this.Content = content;
@@ -37,7 +117,7 @@ namespace WF_WebAdmin.Converter
             this.IdUserVerif = id_user_verif;
             this.NameUser = name_user;
             this.IdImg = id_img;
-            this.ImgPath =img_path;
+            this.ImgPath = img_path;
         }
     }
 }

WF-WebAdmin/WF-WebAdmin/Converter/QuoteExtension.cs

@@ -2,17 +2,59 @@
 
 namespace WF_WebAdmin.Converter
 {
+    /// <summary>
+    /// Classe d'extension pour la conversion entre les objets <see cref="Quote"/> et <see cref="QuoteDTO"/>.
+    /// </summary>
     public class QuoteExtension
     {
+        /// <summary>
+        /// Convertit un objet <see cref="Quote"/> en un objet <see cref="QuoteDTO"/>.
+        /// </summary>
+        /// <param name="q">L'objet <see cref="Quote"/> à convertir.</param>
+        /// <returns>Un objet <see cref="QuoteDTO"/> contenant les données de l'objet <see cref="Quote"/>.</returns>
         public QuoteDTO QuoteToDTO(Quote q)
         {
-            QuoteDTO quote = new QuoteDTO(q.Id, q.Content, q.Like, q.Langue, q.IsValid,null, null,q.Charac,null,q.TitleSrc,q.DateSrc,null,q.UserProposition,null,q.ImgPath);
+            // Conversion des propriétés de Quote en QuoteDTO
+            QuoteDTO quote = new QuoteDTO(
+                q.Id, 
+                q.Content, 
+                q.Like, 
+                q.Langue, 
+                q.IsValid, 
+                null, // Reason non défini ici
+                null, // IdCaracter non défini ici
+                q.Charac, 
+                null, // IdSource non défini ici
+                q.TitleSrc, 
+                q.DateSrc, 
+                null, // IdUserVerif non défini ici
+                q.UserProposition, 
+                null, // IdImg non défini ici
+                q.ImgPath
+            );
             return quote;
         }
 
+        /// <summary>
+        /// Convertit un objet <see cref="QuoteDTO"/> en un objet <see cref="Quote"/>.
+        /// </summary>
+        /// <param name="q">L'objet <see cref="QuoteDTO"/> à convertir.</param>
+        /// <returns>Un objet <see cref="Quote"/> contenant les données de l'objet <see cref="QuoteDTO"/>.</returns>
         public Quote DTOToQuote(QuoteDTO q)
         {
-            Quote quote = new Quote(q.Id, q.Content,q.NameCharac,q.ImgPath,q.TitleSrc,q.DateSrc,q.Likes,q.Langue,q.NameUser,q.IsValide);
+            // Conversion des propriétés de QuoteDTO en Quote
+            Quote quote = new Quote(
+                q.Id, 
+                q.Content, 
+                q.NameCharac, 
+                q.ImgPath, 
+                q.TitleSrc, 
+                q.DateSrc, 
+                q.Likes, 
+                q.Langue, 
+                q.NameUser, 
+                q.IsValide
+            );
             return quote;
         }
     }

WF-WebAdmin/WF-WebAdmin/Converter/UserDTO.cs

@@ -2,19 +2,51 @@
 
 namespace WF_WebAdmin.Converter
 {
+    /// <summary>
+    /// Représente un objet Data Transfer Object (DTO) pour un utilisateur.
+    /// Utilisé pour transmettre les informations d'un utilisateur entre différentes couches de l'application.
+    /// </summary>
     public class UserDTO
     {
+        /// <summary>
+        /// Obtient ou définit l'image de l'utilisateur.
+        /// </summary>
         public string Image { get; set; }
+
+        /// <summary>
+        /// Obtient ou définit le nom de l'utilisateur.
+        /// </summary>
         public string Name { get; set; }
+
+        /// <summary>
+        /// Obtient ou définit l'adresse email de l'utilisateur.
+        /// </summary>
         public string Email { get; set; }
+
+        /// <summary>
+        /// Obtient ou définit la date de création de l'utilisateur.
+        /// </summary>
         public DateTime DateCreation { get; set; }
 
+        /// <summary>
+        /// Obtient ou définit une valeur indiquant si l'utilisateur est un administrateur.
+        /// </summary>
         public Boolean IsAdmin { get; set; }
+
+        /// <summary>
+        /// Obtient ou définit la liste des commentaires associés à l'utilisateur.
+        /// </summary>
         public List<Commentary> Comments { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="UserDTO"/> avec les informations de base d'un utilisateur.
+        /// </summary>
+        /// <param name="image">L'image de l'utilisateur.</param>
+        /// <param name="name">Le nom de l'utilisateur.</param>
+        /// <param name="email">L'email de l'utilisateur.</param>
+        /// <param name="dateCreation">La date de création du compte utilisateur.</param>
         public UserDTO(string image, string name, string email, DateTime dateCreation)
         {
-
             this.Image = image;
             this.Name = name;
             this.Email = email;

WF-WebAdmin/WF-WebAdmin/Converter/UserExtension.cs

@@ -2,16 +2,31 @@
 
 namespace WF_WebAdmin.Converter
 {
+    /// <summary>
+    /// Classe d'extension permettant la conversion entre un utilisateur et son Data Transfer Object (DTO).
+    /// </summary>
     public class UserExtension
     {
+        /// <summary>
+        /// Convertit un objet <see cref="UserDTO"/> en un objet <see cref="User"/>.
+        /// </summary>
+        /// <param name="u">L'objet <see cref="UserDTO"/> à convertir.</param>
+        /// <returns>Retourne un nouvel objet <see cref="User"/> avec les données du DTO.</returns>
         public User UserToDTO(UserDTO u)
         {
-            User user = new User(u.Image, u.Name, u.Email, u.DateCreation,u.IsAdmin);
+            // Création d'un objet User à partir des données du DTO
+            User user = new User(u.Image, u.Name, u.Email, u.DateCreation, u.IsAdmin);
             return user;
         }
 
+        /// <summary>
+        /// Convertit un objet <see cref="User"/> en un objet <see cref="UserDTO"/>.
+        /// </summary>
+        /// <param name="u">L'objet <see cref="User"/> à convertir.</param>
+        /// <returns>Retourne un nouvel objet <see cref="UserDTO"/> avec les données de l'utilisateur.</returns>
         public UserDTO DTOToUser(User u)
         {
+            // Création d'un objet UserDTO à partir des données de l'utilisateur
             UserDTO user = new UserDTO(u.Image, u.Name, u.Email, u.DateCreation);
             return user;
         }