suppresion ancienne class meteo + doc sur les Models

WF-WebAdmin/WF-WebAdmin/Data/WeatherForecast.cs

@@ -1,13 +0,0 @@
-namespace WF_WebAdmin.Data
-{
-    public class WeatherForecast
-    {
-        public DateTime Date { get; set; }
-
-        public int TemperatureC { get; set; }
-
-        public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
-
-        public string? Summary { get; set; }
-    }
-}

WF-WebAdmin/WF-WebAdmin/Data/WeatherForecastService.cs

@@ -1,20 +0,0 @@
-namespace WF_WebAdmin.Data
-{
-    public class WeatherForecastService
-    {
-        private static readonly string[] Summaries = new[]
-        {
-            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
-        };
-
-        public Task<WeatherForecast[]> GetForecastAsync(DateTime startDate)
-        {
-            return Task.FromResult(Enumerable.Range(1, 5).Select(index => new WeatherForecast
-            {
-                Date = startDate.AddDays(index),
-                TemperatureC = Random.Shared.Next(-20, 55),
-                Summary = Summaries[Random.Shared.Next(Summaries.Length)]
-            }).ToArray());
-        }
-    }
-}

WF-WebAdmin/WF-WebAdmin/Model/Character.cs

@@ -1,8 +1,18 @@
 namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Représente un personnage dans le système.
+    /// </summary>
     public class Character
     {
-        public int id_caracter {  get; set; }
-        public string caracter {  get; set; }
+        /// <summary>
+        /// Identifiant unique du personnage.
+        /// </summary>
+        public int id_caracter { get; set; }
+
+        /// <summary>
+        /// Nom ou description du personnage.
+        /// </summary>
+        public string caracter { get; set; }
     }
 }

WF-WebAdmin/WF-WebAdmin/Model/Commentary.cs

@@ -1,10 +1,21 @@
 namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Représente un commentaire dans le système.
+    /// </summary>
     public class Commentary
     {
         //public int Id { get; set; }
         //public int IdUser { get; set; }
-        public string Text {  get; set; }
+
+        /// <summary>
+        /// Le texte du commentaire.
+        /// </summary>
+        public string Text { get; set; }
+
+        /// <summary>
+        /// La date de création du commentaire.
+        /// </summary>
         public DateTime DateCreation { get; set; }
     }
 }

WF-WebAdmin/WF-WebAdmin/Model/DailyQuote.cs

@@ -1,9 +1,19 @@
 namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Représente une citation quotidienne dans le système.
+    /// </summary>
     public class DailyQuote
     {
+        /// <summary>
+        /// Identifiant unique de la citation quotidienne.
+        /// </summary>
         public int Id { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="DailyQuote"/>.
+        /// </summary>
+        /// <param name="Id">L'identifiant de la citation quotidienne.</param>
         public DailyQuote(int Id)
         {
             this.Id = Id;

WF-WebAdmin/WF-WebAdmin/Model/Quiz.cs

@@ -1,17 +1,67 @@
 namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Représente un quiz avec une question et plusieurs réponses possibles.
+    /// </summary>
     public class Quiz
     {
+        /// <summary>
+        /// Identifiant unique du quiz.
+        /// </summary>
         public int Id { get; set; }
+
+        /// <summary>
+        /// La question posée dans le quiz.
+        /// </summary>
         public string Question { get; set; }
+
+        /// <summary>
+        /// Réponse A possible pour le quiz.
+        /// </summary>
         public string AnswerA { get; set; }
+
+        /// <summary>
+        /// Réponse B possible pour le quiz.
+        /// </summary>
         public string AnswerB { get; set; }
+
+        /// <summary>
+        /// Réponse C possible pour le quiz.
+        /// </summary>
         public string AnswerC { get; set; }
+
+        /// <summary>
+        /// Réponse D possible pour le quiz.
+        /// </summary>
         public string AnswerD { get; set; }
+
+        /// <summary>
+        /// Réponse correcte au quiz (A, B, C ou D).
+        /// </summary>
         public string CAnswer { get; set; }
+
+        /// <summary>
+        /// Indique si le quiz est valide.
+        /// </summary>
         public bool IsValid { get; set; }
+
+        /// <summary>
+        /// Proposition de l'utilisateur pour valider le quiz.
+        /// </summary>
         public string UserProposition { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Quiz"/>.
+        /// </summary>
+        /// <param name="id">L'identifiant du quiz.</param>
+        /// <param name="question">La question posée dans le quiz.</param>
+        /// <param name="answerA">Réponse A possible.</param>
+        /// <param name="answerB">Réponse B possible.</param>
+        /// <param name="answerC">Réponse C possible.</param>
+        /// <param name="answerD">Réponse D possible.</param>
+        /// <param name="cAnswer">Réponse correcte (A, B, C ou D).</param>
+        /// <param name="isValid">Indique si le quiz est valide.</param>
+        /// <param name="userProposition">Proposition de l'utilisateur.</param>
         public Quiz(int id, string question, string answerA, string answerB, string answerC, string answerD, string cAnswer, bool isValid, string userProposition)
         {
             Id = id;
@@ -25,8 +75,18 @@ namespace WF_WebAdmin.Model
             UserProposition = userProposition;
         }
 
-        public Quiz(int id, string question, string answerA, string answerB, string answerC, string answerD, string cAnswer)
-        {
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Quiz"/> avec une valeur par défaut pour la validité et la proposition de l'utilisateur.
+        /// </summary>
+        /// <param name="id">L'identifiant du quiz.</param>
+        /// <param name="question">La question posée dans le quiz.</param>
+        /// <param name="answerA">Réponse A possible.</param>
+        /// <param name="answerB">Réponse B possible.</param>
+        /// <param name="answerC">Réponse C possible.</param>
+        /// <param name="answerD">Réponse D possible.</param>
+        /// <param name="cAnswer">Réponse correcte (A, B, C ou D).</param>
+        public Quiz(int id, string question, string answerA, string answerB, string answerC, string answerD, string cAnswer)
+        {
             Id = id;
             Question = question;
             AnswerA = answerA;
@@ -35,10 +95,12 @@ namespace WF_WebAdmin.Model
             AnswerD = answerD;
             CAnswer = cAnswer;
             IsValid = true;
-            UserProposition = "Admin";
+            UserProposition = "Admin";
         }
 
+        /// <summary>
+        /// Constructeur par défaut pour la classe <see cref="Quiz"/>.
+        /// </summary>
         public Quiz() {}
-
     }
-}
+}

WF-WebAdmin/WF-WebAdmin/Model/QuizModel.cs

@@ -2,28 +2,55 @@
 
 namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Modèle représentant les données nécessaires à la création ou à la modification d'un quiz.
+    /// </summary>
     public class QuizModel
     {
+        /// <summary>
+        /// Question posée dans le quiz.
+        /// Cette propriété est obligatoire et doit être d'une longueur maximale de 200 caractères.
+        /// </summary>
         [Required]
         [StringLength(200, ErrorMessage = "La question ne peut pas depasser les 200 caractère.")]
         public string Question { get; set; }
 
+        /// <summary>
+        /// Première réponse possible pour le quiz.
+        /// Cette propriété est obligatoire et doit être d'une longueur maximale de 50 caractères.
+        /// </summary>
         [Required]
         [StringLength(50, ErrorMessage = "La réponse ne peut pas depasser les 50 caractère.")]
         public string AnswerA { get; set; }
 
+        /// <summary>
+        /// Deuxième réponse possible pour le quiz.
+        /// Cette propriété est obligatoire et doit être d'une longueur maximale de 50 caractères.
+        /// </summary>
         [Required]
         [StringLength(50, ErrorMessage = "La réponse ne peut pas depasser les 50 caractère.")]
         public string AnswerB { get; set; }
 
+        /// <summary>
+        /// Troisième réponse possible pour le quiz.
+        /// Cette propriété est obligatoire et doit être d'une longueur maximale de 50 caractères.
+        /// </summary>
         [Required]
         [StringLength(50, ErrorMessage = "La réponse ne peut pas depasser les 50 caractère.")]
         public string AnswerC { get; set; }
 
+        /// <summary>
+        /// Quatrième réponse possible pour le quiz.
+        /// Cette propriété est obligatoire et doit être d'une longueur maximale de 50 caractères.
+        /// </summary>
         [Required]
         [StringLength(50, ErrorMessage = "La réponse ne peut pas depasser les 50 caractère.")]
         public string AnswerD { get; set; }
 
+        /// <summary>
+        /// Réponse correcte au quiz, choisie parmi A, B, C ou D.
+        /// Cette propriété est obligatoire.
+        /// </summary>
         [Required]
         public string CAnswer { get; set; }
     }

WF-WebAdmin/WF-WebAdmin/Model/Quote.cs

@@ -1,20 +1,73 @@
-using Microsoft.AspNetCore.DataProtection.KeyManagement;
-
-namespace WF_WebAdmin.Model
+namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Représente une citation dans le système.
+    /// </summary>
     public class Quote
     {
+        /// <summary>
+        /// Identifiant unique de la citation.
+        /// </summary>
         public int Id { get; set; }
+
+        /// <summary>
+        /// Contenu de la citation.
+        /// </summary>
         public string Content { get; set; }
+
+        /// <summary>
+        /// Nombre de "likes" reçus pour cette citation.
+        /// </summary>
         public int Like { get; set; }
+
+        /// <summary>
+        /// Langue dans laquelle la citation est écrite.
+        /// </summary>
         public string Langue { get; set; }
+
+        /// <summary>
+        /// Caractère associé à la citation (ex : personnage, auteur, etc.).
+        /// </summary>
         public string Charac { get; set; }
+
+        /// <summary>
+        /// Chemin d'accès à l'image associée à la citation.
+        /// </summary>
         public string ImgPath { get; set; }
+
+        /// <summary>
+        /// Titre de la source de la citation (ex : livre, film, etc.).
+        /// </summary>
         public string TitleSrc { get; set; }
+
+        /// <summary>
+        /// Date de la source de la citation.
+        /// </summary>
         public DateTime DateSrc { get; set; }
+
+        /// <summary>
+        /// Nom de l'utilisateur ayant proposé la citation.
+        /// </summary>
         public string UserProposition { get; set; }
+
+        /// <summary>
+        /// Indique si la citation est valide.
+        /// </summary>
         public bool IsValid { get; set; }
 
+        /// <summary>
+        /// Constructeur pour créer une nouvelle citation avec tous ses attributs.
+        /// </summary>
+        /// <param name="id">Identifiant de la citation.</param>
+        /// <param name="content">Contenu de la citation.</param>
+        /// <param name="charac">Caractère associé à la citation.</param>
+        /// <param name="imgPath">Chemin de l'image associée.</param>
+        /// <param name="titleSrc">Titre de la source.</param>
+        /// <param name="dateSrc">Date de la source.</param>
+        /// <param name="like">Nombre de "likes" reçus.</param>
+        /// <param name="langue">Langue de la citation.</param>
+        /// <param name="userProposition">Nom de l'utilisateur ayant proposé la citation.</param>
+        /// <param name="isvalid">Indicateur de validité de la citation.</param>
         public Quote(int id, string content, string charac, string imgPath, string titleSrc, DateTime dateSrc, int like, string langue, string userProposition, bool isvalid)
         {
             Id = id;
@@ -28,6 +81,15 @@ namespace WF_WebAdmin.Model
             UserProposition = userProposition;
             IsValid = isvalid;
         }
+    }
+}
+
+
+
+
+
+
+
         /*
         public int Id { get; set; }
         public string Content { get; set; }
@@ -65,5 +127,5 @@ namespace WF_WebAdmin.Model
             IdUserVerif = idUserVerif;
         }
         */
-    }
-}
+    
+

WF-WebAdmin/WF-WebAdmin/Model/QuoteModel.cs

@@ -1,27 +1,65 @@
-using System.ComponentModel.DataAnnotations;
-
-namespace WF_WebAdmin.Model
+namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Modèle représentant une citation dans le système.
+    /// Ce modèle est utilisé pour la validation des données avant leur persistance.
+    /// </summary>
     public class QuoteModel
     {
+        /// <summary>
+        /// Identifiant unique de la citation.
+        /// </summary>
         public int Id { get; set; }
 
+        /// <summary>
+        /// Contenu de la citation.
+        /// La citation ne peut pas dépasser 300 caractères.
+        /// </summary>
         [Required]
-        [StringLength(300, ErrorMessage = "La citation ne peut pas dépasser les 300 caractère.")]
+        [StringLength(300, ErrorMessage = "La citation ne peut pas dépasser les 300 caractères.")]
         public string Content { get; set; }
 
+        /// <summary>
+        /// Nombre de "likes" que la citation a reçus.
+        /// </summary>
         public int Like { get; set; }
 
+        /// <summary>
+        /// Langue dans laquelle la citation est écrite.
+        /// La langue est limitée à 2 caractères.
+        /// </summary>
         [Required]
-        [StringLength(2, ErrorMessage = "La langue ne peut pas dépasser 2 caractère.")]
+        [StringLength(2, ErrorMessage = "La langue ne peut pas dépasser 2 caractères.")]
         public string Langue { get; set; }
 
-
+        /// <summary>
+        /// Caractère associé à la citation (ex : auteur ou personnage).
+        /// </summary>
         public string Charac { get; set; }
+
+        /// <summary>
+        /// Chemin d'accès à l'image associée à la citation.
+        /// </summary>
         public string ImgPath { get; set; }
+
+        /// <summary>
+        /// Titre de la source de la citation (ex : livre, film, etc.).
+        /// </summary>
         public string TitleSrc { get; set; }
+
+        /// <summary>
+        /// Date de la source de la citation.
+        /// </summary>
         public DateTime DateSrc { get; set; }
+
+        /// <summary>
+        /// Nom de l'utilisateur ayant proposé la citation.
+        /// </summary>
         public string UserProposition { get; set; }
+
+        /// <summary>
+        /// Indique si la citation est validée par le système.
+        /// </summary>
         public bool IsValid { get; set; }
     }
 }

WF-WebAdmin/WF-WebAdmin/Model/Source.cs

@@ -1,11 +1,25 @@
 namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Représente une source d'une citation dans le système.
+    /// Cette classe contient des informations sur la source d'une citation, telles que son titre et sa date de publication.
+    /// </summary>
     public class Source
     {
-        public int id_source {  get; set; }
+        /// <summary>
+        /// Identifiant unique de la source.
+        /// </summary>
+        public int id_source { get; set; }
 
+        /// <summary>
+        /// Titre de la source, tel qu'un livre, un article ou une œuvre.
+        /// </summary>
         public string title { get; set; }
 
-        public int date {  get; set; }
+        /// <summary>
+        /// Date de publication de la source.
+        /// Il s'agit d'une représentation de l'année sous forme d'entier.
+        /// </summary>
+        public int date { get; set; }
     }
 }

WF-WebAdmin/WF-WebAdmin/Model/User.cs

@@ -1,17 +1,55 @@
 namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Représente un utilisateur dans le système.
+    /// Cette classe contient des informations sur l'utilisateur, telles que son image, son nom, son email, la date de création de son compte,
+    /// son statut d'administrateur et les commentaires qu'il a publiés.
+    /// </summary>
     public class User
     {
+        /// <summary>
+        /// Identifiant unique de l'utilisateur.
+        /// </summary>
         public int Id { get; set; }
-        public string Image {  get; set; }
+
+        /// <summary>
+        /// URL de l'image de profil de l'utilisateur.
+        /// </summary>
+        public string Image { get; set; }
+
+        /// <summary>
+        /// Nom de l'utilisateur.
+        /// </summary>
         public string Name { get; set; }
+
+        /// <summary>
+        /// Adresse email de l'utilisateur.
+        /// </summary>
         public string Email { get; set; }
+
+        /// <summary>
+        /// Date de création du compte utilisateur.
+        /// </summary>
         public DateTime DateCreation { get; set; }
 
-        public Boolean IsAdmin { get; set; }
+        /// <summary>
+        /// Indique si l'utilisateur a des privilèges d'administrateur.
+        /// </summary>
+        public bool IsAdmin { get; set; }
 
+        /// <summary>
+        /// Liste des commentaires publiés par l'utilisateur.
+        /// </summary>
         public List<Commentary> Comments { get; set; }
 
+        /// <summary>
+        /// Constructeur pour créer un nouvel utilisateur avec des informations spécifiques.
+        /// </summary>
+        /// <param name="image">URL de l'image de profil de l'utilisateur.</param>
+        /// <param name="name">Nom de l'utilisateur.</param>
+        /// <param name="email">Adresse email de l'utilisateur.</param>
+        /// <param name="dateCreation">Date de création du compte de l'utilisateur.</param>
+        /// <param name="isAdmin">Indicateur si l'utilisateur est un administrateur.</param>
         public User(string image, string name, string email, DateTime dateCreation, bool isAdmin)
         {
             this.Image = image;
@@ -21,6 +59,9 @@
             IsAdmin = isAdmin;
         }
 
+        /// <summary>
+        /// Constructeur par défaut pour créer un utilisateur sans initialiser ses propriétés.
+        /// </summary>
         public User() { }
     }
 }

WF-WebAdmin/WF-WebAdmin/Model/UserLogin.cs

@@ -1,14 +1,45 @@
-using System;
-namespace WF_WebAdmin.Model
+namespace WF_WebAdmin.Model
 {
+    /// <summary>
+    /// Représente un utilisateur dans le système de connexion.
+    /// Cette classe contient des informations nécessaires pour l'authentification et la gestion du profil utilisateur.
+    /// </summary>
     public class UserLogin
     {
+        /// <summary>
+        /// Identifiant unique de l'utilisateur.
+        /// </summary>
         public int Id { get; set; }
+
+        /// <summary>
+        /// URL de l'image de profil de l'utilisateur.
+        /// </summary>
         public string Image { get; set; }
-        public string Name { get; set;}
-        public Boolean IsAdmin { get; set; }
+
+        /// <summary>
+        /// Nom de l'utilisateur.
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        /// Indique si l'utilisateur possède des privilèges d'administrateur.
+        /// </summary>
+        public bool IsAdmin { get; set; }
+
+        /// <summary>
+        /// Mot de passe de l'utilisateur.
+        /// </summary>
         public string Mdp { get; set; }
-        public UserLogin(int id,string image, string name, bool isAdmin, string mdp)
+
+        /// <summary>
+        /// Constructeur pour créer un objet <see cref="UserLogin"/> avec des informations d'authentification et de profil.
+        /// </summary>
+        /// <param name="id">Identifiant de l'utilisateur.</param>
+        /// <param name="image">URL de l'image de profil de l'utilisateur.</param>
+        /// <param name="name">Nom de l'utilisateur.</param>
+        /// <param name="isAdmin">Indicateur si l'utilisateur est un administrateur.</param>
+        /// <param name="mdp">Mot de passe de l'utilisateur.</param>
+        public UserLogin(int id, string image, string name, bool isAdmin, string mdp)
         {
             Id = id;
             this.Image = image;
@@ -17,6 +48,9 @@ namespace WF_WebAdmin.Model
             this.Mdp = mdp;
         }
 
+        /// <summary>
+        /// Constructeur par défaut pour créer un objet <see cref="UserLogin"/> sans initialiser les propriétés.
+        /// </summary>
         public UserLogin() { }
     }
 }