Commentaires de code

MediaTekDocuments/controller/FrmAuthController.cs

@@ -5,15 +5,30 @@ using System;
 
 namespace MediaTekDocuments.controller
 {
+    /// <summary>
+    /// Contrôleur pour la fenêtre d'authentification
+    /// </summary>
     class FrmAuthController
     {
+        /// <summary>
+        /// Objet d'accès aux données
+        /// </summary>
         private readonly Access access;
 
+        /// <summary>
+        /// Constructeur : récupère l'instance unique d'accès aux données
+        /// </summary>
         public FrmAuthController()
         {
             access = Access.GetInstance();
         }
 
+        /// <summary>
+        /// Vérifie les identifiants de connexion
+        /// </summary>
+        /// <param name="login">Identifiant de l'utilisateur</param>
+        /// <param name="pwd">Mot de passe de l'utilisateur</param>
+        /// <returns>Objet Utilisateur si connexion réussie, null sinon</returns>
         public Utilisateur GetConnection(string login, string pwd)
         {
             return access.GetConnection(login, pwd);

MediaTekDocuments/controller/FrmMediatekController.cs

@@ -98,46 +98,90 @@ namespace MediaTekDocuments.controller
             return access.CreerExemplaire(exemplaire);
         }
 
+        /// <summary>
+        /// Récupère les commandes d'un document
+        /// </summary>
+        /// <param name="idDocument">Identifiant du document</param>
+        /// <returns>Liste des commandes du document</returns>
         public List<CommandeDocument> GetCommandesDocument(string idDocument)
         {
             return Access.GetInstance().GetCommandesDocument(idDocument);
         }
 
+        /// <summary>
+        /// Supprime une commande de document
+        /// </summary>
+        /// <param name="commande">Objet CommandeDocument à supprimer</param>
+        /// <returns>True si la suppression a pu se faire</returns>
         public bool SupprimerCommandeDocument(CommandeDocument commande)
         {
             return Access.GetInstance().DeleteCommande(commande.Id);
         }
 
+        /// <summary>
+        /// Récupère la liste des suivis
+        /// </summary>
+        /// <returns>Liste d'objets Categorie (suivi)</returns>
         public List<Categorie> GetAllSuivis()
         {
             return Access.GetInstance().GetAllSuivis();
         }
 
+        /// <summary>
+        /// Crée une nouvelle commande de document
+        /// </summary>
+        /// <param name="commande">Objet CommandeDocument à créer</param>
+        /// <returns>True si la création a pu se faire</returns>
         public bool createCommande(CommandeDocument commande)
         {
             return access.CreerCommande(commande);
         }
 
+        /// <summary>
+        /// Récupère le prochain identifiant de commande
+        /// </summary>
+        /// <returns>Identifiant de commande formaté</returns>
         public string GetNextCommandeId()
         {
             return access.GetNextCommandeId();
         }
 
+        /// <summary>
+        /// Met à jour l'état de suivi d'une commande
+        /// </summary>
+        /// <param name="idCommande">Identifiant de la commande</param>
+        /// <param name="idSuivi">Identifiant du nouvel état de suivi</param>
+        /// <returns>True si la mise à jour a pu se faire</returns>
         public bool UpdateSuiviCommande(string idCommande, string idSuivi)
         {
             return access.UpdateSuiviCommande(idCommande, idSuivi);
         }
 
+        /// <summary>
+        /// Récupère les abonnements d'une revue
+        /// </summary>
+        /// <param name="idRevue">Identifiant de la revue</param>
+        /// <returns>Liste des abonnements de la revue</returns>
         public List<Abonnement> GetAbonnements(string idRevue)
         {
             return access.GetAbonnements(idRevue);
         }
 
+        /// <summary>
+        /// Crée un nouvel abonnement
+        /// </summary>
+        /// <param name="abonnement">Objet Abonnement à créer</param>
+        /// <returns>True si la création a pu se faire</returns>
         public bool CreerAbonnement(Abonnement abonnement)
         {
             return access.CreerAbonnement(abonnement);
         }
 
+        /// <summary>
+        /// Supprime un abonnement
+        /// </summary>
+        /// <param name="abonnement">Objet Abonnement à supprimer</param>
+        /// <returns>True si la suppression a pu se faire</returns>
         public bool SupprimerAbonnement(Abonnement abonnement)
         {
             return access.SupprimerAbonnement(abonnement.Id);

MediaTekDocuments/dal/Access.cs

@@ -34,7 +34,8 @@ namespace MediaTekDocuments.dal
         private const string POST = "POST";
         /// <summary>
         /// méthode HTTP pour update
-        /// 
+        /// </summary>
+        private const string PUT = "PUT";
 
         /// <summary>
         /// méthode HTTP pour delete
@@ -68,6 +69,10 @@ namespace MediaTekDocuments.dal
             }
         }
 
+        /// <summary>
+        /// Création et retour de l'instance unique de la classe
+        /// </summary>
+        /// <returns>instance unique de la classe</returns>
         public static Access GetInstance()
         {
             if (instance == null)
@@ -266,6 +271,11 @@ namespace MediaTekDocuments.dal
             return lesCommandes;
         }
 
+        /// <summary>
+        /// Supprime une commande
+        /// </summary>
+        /// <param name="idCommande">ID de la commande à supprimer</param>
+        /// <returns>True si la suppression a pu se faire</returns>
         public bool DeleteCommande(string idCommande)
         {
 
@@ -282,12 +292,21 @@ namespace MediaTekDocuments.dal
             }
         }
 
+        /// <summary>
+        /// Récupère la liste des suivis
+        /// </summary>
+        /// <returns>Liste des suivis</returns>
         public List<Categorie> GetAllSuivis()
         {
             IEnumerable<Categorie> lesSuivis = TraitementRecup<Categorie>(GET, "suivi", null);
             return new List<Categorie>(lesSuivis);
         }
 
+        /// <summary>
+        /// Crée une commande de document
+        /// </summary>
+        /// <param name="commande">Objet CommandeDocument à créer</param>
+        /// <returns>True si la création a pu se faire</returns>
         public bool CreerCommande(CommandeDocument commande)
         {
             String jsonExemplaire = JsonConvert.SerializeObject(commande, new CustomDateTimeConverter());
@@ -303,6 +322,10 @@ namespace MediaTekDocuments.dal
             return false;
         }
 
+        /// <summary>
+        /// Récupère le prochain identifiant de commande
+        /// </summary>
+        /// <returns>Prochain ID de commande au format string</returns>
         public string GetNextCommandeId()
         {
             List<dynamic> result = TraitementRecup<dynamic>(GET, "maxcommande", null);
@@ -321,6 +344,13 @@ namespace MediaTekDocuments.dal
             }
             return "0001";
         }
+
+        /// <summary>
+        /// Met à jour le suivi d'une commande
+        /// </summary>
+        /// <param name="idCommande">ID de la commande</param>
+        /// <param name="idSuivi">Nouvel ID de suivi</param>
+        /// <returns>True si la mise à jour a pu se faire</returns>
         public bool UpdateSuiviCommande(string idCommande, string idSuivi)
         {
             String jsonSuivi = convertToJson("idSuivi", idSuivi);
@@ -337,12 +367,22 @@ namespace MediaTekDocuments.dal
             }
         }
 
+        /// <summary>
+        /// Récupère les abonnements d'une revue
+        /// </summary>
+        /// <param name="idRevue">ID de la revue</param>
+        /// <returns>Liste des abonnements</returns>
         public List<Abonnement> GetAbonnements(string idRevue)
         {
             string jsonIdRevue = convertToJson("id", idRevue);
             return TraitementRecup<Abonnement>(GET, "commanderevue/" + jsonIdRevue, null);
         }
 
+        /// <summary>
+        /// Crée un abonnement
+        /// </summary>
+        /// <param name="abonnement">Objet Abonnement à créer</param>
+        /// <returns>True si la création a pu se faire</returns>
         public bool CreerAbonnement(Abonnement abonnement)
         {
             string jsonAbonnement = JsonConvert.SerializeObject(abonnement, new CustomDateTimeConverter());
@@ -359,6 +399,11 @@ namespace MediaTekDocuments.dal
             }
         }
 
+        /// <summary>
+        /// Supprime un abonnement
+        /// </summary>
+        /// <param name="idAbonnement">ID de l'abonnement à supprimer</param>
+        /// <returns>True si la suppression a pu se faire</returns>
         public bool SupprimerAbonnement(string idAbonnement)
         {
             string jsonId = convertToJson("id", idAbonnement);
@@ -373,6 +418,12 @@ namespace MediaTekDocuments.dal
             }
         }
 
+        /// <summary>
+        /// Tente de connecter un utilisateur
+        /// </summary>
+        /// <param name="login">Login de l'utilisateur</param>
+        /// <param name="pwd">Mot de passe de l'utilisateur</param>
+        /// <returns>Objet Utilisateur si connecté, null sinon</returns>
         public Utilisateur GetConnection(string login, string pwd)
         {
             Dictionary<string, string> loginInfo = new Dictionary<string, string>

MediaTekDocuments/manager/ApiRest.cs

@@ -43,7 +43,7 @@ namespace MediaTekDocuments.manager
         /// </summary>
         /// <param name="uriApi">adresse de l'api</param>
         /// <param name="authenticationString">chaîne d'authentificatio (login:pwd)</param>
-        /// <returns></returns>
+        /// <returns>Instance unique de la classe ApiRest</returns>
         public static ApiRest GetInstance(String uriApi, String authenticationString)
         {
             if(instance == null)

MediaTekDocuments/model/Abonnement.cs

@@ -1,15 +1,41 @@
-using System;
+using System;
 
 namespace MediaTekDocuments.model
 {
+    /// <summary>
+    /// Classe métier Abonnement (contient les informations sur un abonnement à une revue)
+    /// </summary>
     public class Abonnement
     {
+        /// <summary>
+        /// Obtient ou définit l'identifiant de l'abonnement
+        /// </summary>
         public string Id { get; set; }
+        /// <summary>
+        /// Obtient ou définit la date de la commande
+        /// </summary>
         public DateTime DateCommande { get; set; }
+        /// <summary>
+        /// Obtient ou définit le montant de l'abonnement
+        /// </summary>
         public double Montant { get; set; }
+        /// <summary>
+        /// Obtient ou définit la date de fin de l'abonnement
+        /// </summary>
         public DateTime DateFinAbonnement { get; set; }
+        /// <summary>
+        /// Obtient ou définit l'identifiant de la revue associée
+        /// </summary>
         public string IdRevue { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Abonnement"/>
+        /// </summary>
+        /// <param name="id">Identifiant de l'abonnement</param>
+        /// <param name="dateCommande">Date de la commande</param>
+        /// <param name="montant">Montant de l'abonnement</param>
+        /// <param name="dateFinAbonnement">Date de fin de l'abonnement</param>
+        /// <param name="idRevue">Identifiant de la revue associée</param>
         public Abonnement(string id, DateTime dateCommande, double montant, DateTime dateFinAbonnement, string idRevue)
         {
             this.Id = id;

MediaTekDocuments/model/Categorie.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,9 +6,20 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Categorie
     {
+        /// <summary>
+        /// Obtient l'identifiant de la catégorie
+        /// </summary>
         public string Id { get; }
+        /// <summary>
+        /// Obtient le libellé de la catégorie
+        /// </summary>
         public string Libelle { get; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Categorie"/>
+        /// </summary>
+        /// <param name="id">Identifiant de la catégorie</param>
+        /// <param name="libelle">Libellé de la catégorie</param>
         public Categorie(string id, string libelle)
         {
             this.Id = id;
@@ -18,7 +29,7 @@ namespace MediaTekDocuments.model
         /// <summary>
         /// Récupération du libellé pour l'affichage dans les combos
         /// </summary>
-        /// <returns>Libelle</returns>
+        /// <returns>Le libellé de la catégorie</returns>
         public override string ToString()
         {
             return this.Libelle;

MediaTekDocuments/model/CommandeDocument.cs

@@ -1,17 +1,51 @@
-using System;
+using System;
 
 namespace MediaTekDocuments.model
 {
+    /// <summary>
+    /// Classe métier CommandeDocument (contient les informations sur une commande de livres ou de DVD)
+    /// </summary>
     public class CommandeDocument
     {
+        /// <summary>
+        /// Obtient ou définit l'identifiant de la commande
+        /// </summary>
         public string Id { get; set; }
+        /// <summary>
+        /// Obtient ou définit la date de la commande
+        /// </summary>
         public DateTime DateCommande { get; set; }
+        /// <summary>
+        /// Obtient ou définit le montant de la commande
+        /// </summary>
         public double Montant { get; set; }
+        /// <summary>
+        /// Obtient ou définit le nombre d'exemplaires commandés
+        /// </summary>
         public int NbExemplaire { get; set; }
+        /// <summary>
+        /// Obtient ou définit l'identifiant du livre ou DVD associé
+        /// </summary>
         public string IdLivreDvd { get; set; }
+        /// <summary>
+        /// Obtient ou définit l'identifiant de l'état de suivi de la commande
+        /// </summary>
         public int IdSuivi { get; set; }
+        /// <summary>
+        /// Obtient ou définit le libellé de l'état de suivi
+        /// </summary>
         public string LibelleSuivi { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="CommandeDocument"/>
+        /// </summary>
+        /// <param name="id">Identifiant de la commande</param>
+        /// <param name="dateCommande">Date de la commande</param>
+        /// <param name="montant">Montant de la commande</param>
+        /// <param name="nbExemplaire">Nombre d'exemplaires</param>
+        /// <param name="idLivreDvd">Identifiant du document (livre ou dvd)</param>
+        /// <param name="idSuivi">Identifiant du suivi</param>
+        /// <param name="libelleSuivi">Libellé du suivi</param>
         public CommandeDocument(string id, DateTime dateCommande, double montant, int nbExemplaire, string idLivreDvd, int idSuivi, string libelleSuivi)
         {
             this.Id = id;

MediaTekDocuments/model/Document.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,16 +6,55 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Document
     {
+        /// <summary>
+        /// Obtient l'identifiant du document
+        /// </summary>
         public string Id { get; }
+        /// <summary>
+        /// Obtient le titre du document
+        /// </summary>
         public string Titre { get; }
+        /// <summary>
+        /// Obtient l'URL de l'image du document
+        /// </summary>
         public string Image { get; }
+        /// <summary>
+        /// Obtient l'identifiant du genre du document
+        /// </summary>
         public string IdGenre { get; }
+        /// <summary>
+        /// Obtient le libellé du genre du document
+        /// </summary>
         public string Genre { get; }
+        /// <summary>
+        /// Obtient l'identifiant du public du document
+        /// </summary>
         public string IdPublic { get; }
+        /// <summary>
+        /// Obtient le libellé du public du document
+        /// </summary>
         public string Public { get; }
+        /// <summary>
+        /// Obtient l'identifiant du rayon du document
+        /// </summary>
         public string IdRayon { get; }
+        /// <summary>
+        /// Obtient le libellé du rayon du document
+        /// </summary>
         public string Rayon { get; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Document"/>
+        /// </summary>
+        /// <param name="id">Identifiant du document</param>
+        /// <param name="titre">Titre du document</param>
+        /// <param name="image">URL de l'image du document</param>
+        /// <param name="idGenre">Identifiant du genre</param>
+        /// <param name="genre">Libellé du genre</param>
+        /// <param name="idPublic">Identifiant du public</param>
+        /// <param name="lePublic">Libellé du public</param>
+        /// <param name="idRayon">Identifiant du rayon</param>
+        /// <param name="rayon">Libellé du rayon</param>
         public Document(string id, string titre, string image, string idGenre, string genre, string idPublic, string lePublic, string idRayon, string rayon)
         {
             Id = id;

MediaTekDocuments/model/Dvd.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,10 +6,34 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Dvd : LivreDvd
     {
+        /// <summary>
+        /// Obtient la durée du DVD
+        /// </summary>
         public int Duree { get; }
+        /// <summary>
+        /// Obtient le réalisateur du DVD
+        /// </summary>
         public string Realisateur { get; }
+        /// <summary>
+        /// Obtient le synopsis du DVD
+        /// </summary>
         public string Synopsis { get; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Dvd"/>
+        /// </summary>
+        /// <param name="id">Identifiant du DVD</param>
+        /// <param name="titre">Titre du DVD</param>
+        /// <param name="image">URL de l'image du DVD</param>
+        /// <param name="duree">Durée du DVD</param>
+        /// <param name="realisateur">Réalisateur du DVD</param>
+        /// <param name="synopsis">Synopsis du DVD</param>
+        /// <param name="idGenre">Identifiant du genre</param>
+        /// <param name="genre">Libellé du genre</param>
+        /// <param name="idPublic">Identifiant du public</param>
+        /// <param name="lePublic">Libellé du public</param>
+        /// <param name="idRayon">Identifiant du rayon</param>
+        /// <param name="rayon">Libellé du rayon</param>
         public Dvd(string id, string titre, string image, int duree, string realisateur, string synopsis,
             string idGenre, string genre, string idPublic, string lePublic, string idRayon, string rayon)
             : base(id, titre, image, idGenre, genre, idPublic, lePublic, idRayon, rayon)

MediaTekDocuments/model/Etat.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,9 +6,20 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Etat
     {
+        /// <summary>
+        /// Obtient ou définit l'identifiant de l'état
+        /// </summary>
         public string Id { get; set; }
+        /// <summary>
+        /// Obtient ou définit le libellé de l'état
+        /// </summary>
         public string Libelle { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Etat"/>
+        /// </summary>
+        /// <param name="id">Identifiant de l'état</param>
+        /// <param name="libelle">Libellé de l'état</param>
         public Etat(string id, string libelle)
         {
             this.Id = id;

MediaTekDocuments/model/Exemplaire.cs

@@ -1,4 +1,4 @@
-using System;
+using System;
 
 namespace MediaTekDocuments.model
 {
@@ -7,12 +7,35 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Exemplaire
     {
+        /// <summary>
+        /// Obtient ou définit le numéro de l'exemplaire
+        /// </summary>
         public int Numero { get; set; }
+        /// <summary>
+        /// Obtient ou définit l'URL de la photo de l'exemplaire
+        /// </summary>
         public string Photo { get; set; }
+        /// <summary>
+        /// Obtient ou définit la date d'achat de l'exemplaire
+        /// </summary>
         public DateTime DateAchat { get; set; }
+        /// <summary>
+        /// Obtient ou définit l'identifiant de l'état de l'exemplaire
+        /// </summary>
         public string IdEtat { get; set; }
+        /// <summary>
+        /// Obtient ou définit l'identifiant du document associé
+        /// </summary>
         public string Id { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Exemplaire"/>
+        /// </summary>
+        /// <param name="numero">Numéro de l'exemplaire</param>
+        /// <param name="dateAchat">Date d'achat</param>
+        /// <param name="photo">URL de la photo</param>
+        /// <param name="idEtat">Identifiant de l'état</param>
+        /// <param name="idDocument">Identifiant du document</param>
         public Exemplaire(int numero, DateTime dateAchat, string photo, string idEtat, string idDocument)
         {
             this.Numero = numero;

MediaTekDocuments/model/Genre.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,6 +6,11 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Genre : Categorie
     {
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Genre"/>
+        /// </summary>
+        /// <param name="id">Identifiant du genre</param>
+        /// <param name="libelle">Libellé du genre</param>
         public Genre(string id, string libelle) : base(id, libelle)
         {
         }

MediaTekDocuments/model/Livre.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,10 +6,34 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Livre : LivreDvd
     {
+        /// <summary>
+        /// Obtient l'ISBN du livre
+        /// </summary>
         public string Isbn { get; }
+        /// <summary>
+        /// Obtient l'auteur du livre
+        /// </summary>
         public string Auteur { get; }
+        /// <summary>
+        /// Obtient la collection du livre
+        /// </summary>
         public string Collection { get; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Livre"/>
+        /// </summary>
+        /// <param name="id">Identifiant du livre</param>
+        /// <param name="titre">Titre du livre</param>
+        /// <param name="image">URL de l'image du livre</param>
+        /// <param name="isbn">ISBN du livre</param>
+        /// <param name="auteur">Auteur du livre</param>
+        /// <param name="collection">Collection du livre</param>
+        /// <param name="idGenre">Identifiant du genre</param>
+        /// <param name="genre">Libellé du genre</param>
+        /// <param name="idPublic">Identifiant du public</param>
+        /// <param name="lePublic">Libellé du public</param>
+        /// <param name="idRayon">Identifiant du rayon</param>
+        /// <param name="rayon">Libellé du rayon</param>
         public Livre(string id, string titre, string image, string isbn, string auteur, string collection,
             string idGenre, string genre, string idPublic, string lePublic, string idRayon, string rayon)
             : base(id, titre, image, idGenre, genre, idPublic, lePublic, idRayon, rayon)

MediaTekDocuments/model/LivreDvd.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,6 +6,18 @@ namespace MediaTekDocuments.model
     /// </summary>
     public abstract class LivreDvd : Document
     {
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="LivreDvd"/>
+        /// </summary>
+        /// <param name="id">Identifiant du document</param>
+        /// <param name="titre">Titre du document</param>
+        /// <param name="image">URL de l'image du document</param>
+        /// <param name="idGenre">Identifiant du genre</param>
+        /// <param name="genre">Libellé du genre</param>
+        /// <param name="idPublic">Identifiant du public</param>
+        /// <param name="lePublic">Libellé du public</param>
+        /// <param name="idRayon">Identifiant du rayon</param>
+        /// <param name="rayon">Libellé du rayon</param>
         protected LivreDvd(string id, string titre, string image, string idGenre, string genre,
             string idPublic, string lePublic, string idRayon, string rayon)
             : base(id, titre, image, idGenre, genre, idPublic, lePublic, idRayon, rayon)

MediaTekDocuments/model/Public.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,6 +6,11 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Public : Categorie
     {
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Public"/>
+        /// </summary>
+        /// <param name="id">Identifiant du public</param>
+        /// <param name="libelle">Libellé du public</param>
         public Public(string id, string libelle) : base(id, libelle)
         {
         }

MediaTekDocuments/model/Rayon.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,6 +6,11 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Rayon : Categorie
     {
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Rayon"/>
+        /// </summary>
+        /// <param name="id">Identifiant du rayon</param>
+        /// <param name="libelle">Libellé du rayon</param>
         public Rayon(string id, string libelle) : base(id, libelle)
         {
         }

MediaTekDocuments/model/Revue.cs

@@ -1,4 +1,4 @@
-
+
 namespace MediaTekDocuments.model
 {
     /// <summary>
@@ -6,9 +6,29 @@ namespace MediaTekDocuments.model
     /// </summary>
     public class Revue : Document
     {
+        /// <summary>
+        /// Obtient ou définit la périodicité de la revue
+        /// </summary>
         public string Periodicite { get; set; }
+        /// <summary>
+        /// Obtient ou définit le délai de mise à disposition de la revue
+        /// </summary>
         public int DelaiMiseADispo { get; set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="Revue"/>
+        /// </summary>
+        /// <param name="id">Identifiant de la revue</param>
+        /// <param name="titre">Titre de la revue</param>
+        /// <param name="image">URL de l'image de la revue</param>
+        /// <param name="idGenre">Identifiant du genre</param>
+        /// <param name="genre">Libellé du genre</param>
+        /// <param name="idPublic">Identifiant du public</param>
+        /// <param name="lePublic">Libellé du public</param>
+        /// <param name="idRayon">Identifiant du rayon</param>
+        /// <param name="rayon">Libellé du rayon</param>
+        /// <param name="periodicite">Périodicité</param>
+        /// <param name="delaiMiseADispo">Délai de mise à disposition</param>
         public Revue(string id, string titre, string image, string idGenre, string genre,
             string idPublic, string lePublic, string idRayon, string rayon,
             string periodicite, int delaiMiseADispo)

MediaTekDocuments/model/Utilisateur.cs

@@ -1,12 +1,42 @@
-public class Utilisateur
+/// <summary>
+/// Classe métier Utilisateur (représente un utilisateur de l'application)
+/// </summary>
+public class Utilisateur
 {
+    /// <summary>
+    /// Obtient ou définit l'identifiant technique de l'utilisateur
+    /// </summary>
     public string Id { get; set; }
+    /// <summary>
+    /// Obtient ou définit l'identifiant de connexion de l'utilisateur
+    /// </summary>
     public string Identifiant { get; set; }
+    /// <summary>
+    /// Obtient ou définit le nom de l'utilisateur
+    /// </summary>
     public string Nom { get; set; }
+    /// <summary>
+    /// Obtient ou définit le prénom de l'utilisateur
+    /// </summary>
     public string Prenom { get; set; }
+    /// <summary>
+    /// Obtient ou définit l'identifiant du service de l'utilisateur
+    /// </summary>
     public int IdService { get; set; }
+    /// <summary>
+    /// Obtient ou définit le libellé du service de l'utilisateur
+    /// </summary>
     public string LibelleService { get; set; }
 
+    /// <summary>
+    /// Initialise une nouvelle instance de la classe <see cref="Utilisateur"/>
+    /// </summary>
+    /// <param name="id">Identifiant technique</param>
+    /// <param name="identifiant">Identifiant de connexion</param>
+    /// <param name="nom">Nom</param>
+    /// <param name="prenom">Prénom</param>
+    /// <param name="idService">Identifiant du service</param>
+    /// <param name="libelleService">Libellé du service</param>
     public Utilisateur(string id, string identifiant, string nom, string prenom, int idService, string libelleService)
     {
         this.Id = id;

MediaTekDocuments/view/FrmAuth.cs

@@ -10,23 +10,49 @@ using System.IO;
 
 namespace MediaTekDocuments.view
 {
+    /// <summary>
+    /// Fenêtre d'authentification de l'application.
+    /// Permet à l'utilisateur de se connecter en saisissant ses identifiants.
+    /// </summary>
     public partial class FrmAuth : Form
     {
+        /// <summary>
+        /// Instance du contrôleur pour la gestion de l'authentification.
+        /// </summary>
         private readonly FrmAuthController controller;
+
+        /// <summary>
+        /// Obtient l'utilisateur authentifié.
+        /// </summary>
         public Utilisateur user { get; private set; }
 
+        /// <summary>
+        /// Initialise une nouvelle instance de la classe <see cref="FrmAuth"/>.
+        /// Configure le contrôleur d'authentification.
+        /// </summary>
         public FrmAuth()
         {
             InitializeComponent();
             this.controller = new FrmAuthController();
         }
 
+        /// <summary>
+        /// Gère l'événement de chargement du formulaire.
+        /// </summary>
+        /// <param name="sender">La source de l'événement.</param>
+        /// <param name="e">Les données de l'événement.</param>
         private void FrmAuth_Load(object sender, EventArgs e)
         {
             // Méthode laissée vide intentionnellement. 
             // Aucun traitement spécifique n'est requis au chargement du formulaire d'authentification.
         }
 
+        /// <summary>
+        /// Gère le clic sur le bouton de connexion.
+        /// Vérifie les identifiants et le service de l'utilisateur pour autoriser l'accès.
+        /// </summary>
+        /// <param name="sender">La source de l'événement.</param>
+        /// <param name="e">Les données de l'événement.</param>
         private void btnLogin_Click(object sender, EventArgs e)
         {
             string identifiant = txtIdentifiant.Text;