commentaire endpoint

PyroFetes/Endpoints/Supplier/CreateSupplierEndpoint.cs

@@ -7,17 +7,17 @@ using PyroFetes.Models;
 namespace PyroFetes.Endpoints.Supplier;
 
 public class CreateSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext) 
-    : Endpoint<CreateSupplierDto, GetSupplierDto>
+    : Endpoint<CreateSupplierDto, GetSupplierDto> //Instanciation d'une connexion à la bdd dans un endpoint, utilise l'élément de requête CreateSupplierDto et l'élement de réponse GetSupplierDto
 {
-    public override void Configure()
+    public override void Configure() //Configuration de l'endpoint
     {
-        Post("/api/suppliers");
-        AllowAnonymous();
+        Post("/api/suppliers"); //Créer un fournisseur
+        AllowAnonymous(); //Autorise l'accès sans authentification
     }
 
     public override async Task HandleAsync(CreateSupplierDto req, CancellationToken ct)
     {
-        var supplier = new Models.Supplier
+        var supplier = new Models.Supplier //Création d'un nom, email, numéro de téléphone, adresse, code postal et nom de la ville rentré par l'utilisateur
         {
             Name = req.Name,
             Email = req.Email,
@@ -27,8 +27,8 @@ public class CreateSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext)
             City = req.City
         };
 
-        pyrofetesdbcontext.Suppliers.Add(supplier);
-        await pyrofetesdbcontext.SaveChangesAsync(ct);
+        pyrofetesdbcontext.Suppliers.Add(supplier); //Ajout du fournisseur à la bdd
+        await pyrofetesdbcontext.SaveChangesAsync(ct); //Sauvegarde du fournisseur dans la bdd
 
         // Ajout des liaisons Price si produits renseignés
         if (req.Products is not null && req.Products.Any())
@@ -43,10 +43,10 @@ public class CreateSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext)
                 };
                 pyrofetesdbcontext.Prices.Add(price);
             }
-            await pyrofetesdbcontext.SaveChangesAsync(ct);
+            await pyrofetesdbcontext.SaveChangesAsync(ct); //Sauvegarde du fournisseur dans la bdd
         }
 
-        var response = new GetSupplierDto
+        var response = new GetSupplierDto //renvoie l'id, d'un nom, d'un email, d'un numéro de téléphone, d'une adresse, d'un code postal et du nom de la ville
         {
             Id = supplier.Id,
             Name = supplier.Name,
@@ -57,6 +57,6 @@ public class CreateSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext)
             City = supplier.City
         };
 
-        await Send.OkAsync(response, ct);
+        await Send.OkAsync(response, ct); //Réponse au client
     }
 }

PyroFetes/Endpoints/Supplier/DeleteSupplierEndpoint.cs

@@ -13,21 +13,21 @@ public class DeleteSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext) : End
 {
     public override void Configure()
     {
-        Delete("/api/suppliers/{@id}", x => new { x.Id });
-        AllowAnonymous();
+        Delete("/api/suppliers/{@id}", x => new { x.Id }); //Endpoint qui supprime un fournisseur en fonction  de l'id
+        AllowAnonymous(); //Autorise l'accès sans authentification
     }
     
     public override async Task HandleAsync(DeleteSupplierRequest req, CancellationToken ct)
     {
-        var supplierToDelete = await pyrofetesdbcontext
-            .Suppliers
-            .SingleOrDefaultAsync(s => s.Id == req.Id, ct);
+        var supplierToDelete = await pyrofetesdbcontext //Récupère un fournisseur dans la bdd et le stocke dans supplierToDelete
+            .Suppliers //Recherche un fournisseur dans la table Suppliers
+            .SingleOrDefaultAsync(s => s.Id == req.Id, ct); //Recherche un fournisseur dont l'id correspond à req.Id  
 
         if (supplierToDelete is null)
         {
             Console.WriteLine($"Aucun fournisseur avec l'ID {req.Id} trouvé.");
-            await Send.NotFoundAsync(ct);
-            return;
+            await Send.NotFoundAsync(ct); //Renvoie une erreur 404
+            return; //Arrêt de la méthode
         }
 
         // Supprimer les liaisons Price avant le fournisseur
@@ -46,6 +46,6 @@ public class DeleteSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext) : End
         await pyrofetesdbcontext.SaveChangesAsync(ct);
         Console.WriteLine($"Fournisseur {req.Id} et ses prix liés supprimés avec succès.");
 
-        await Send.NoContentAsync(ct);
+        await Send.NoContentAsync(ct); //Renvoie une réponse réussite 204 
     }
 }

PyroFetes/Endpoints/Supplier/GetAllSupplierEndpoint.cs

@@ -11,8 +11,8 @@ public class GetAllSuppliersEndpoint(PyroFetesDbContext pyrofetesdbcontext)
 {
     public override void Configure()
     {
-        Get("/api/suppliers");
-        AllowAnonymous();
+        Get("/api/suppliers"); //endpoint qui affiche le fournisseur en fonction de l'id
+        AllowAnonymous(); //Autorise l'accès sans authentification
     }
 
     public override async Task HandleAsync(CancellationToken ct)

PyroFetes/Endpoints/Supplier/GetSupplierEndpoint.cs

@@ -15,8 +15,8 @@ public class GetSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext)
 {
     public override void Configure()
     {
-        Get("/api/suppliers/{@id}", x => new { x.Id });
-        AllowAnonymous();
+        Get("/api/suppliers/{@id}", x => new { x.Id }); //endpoint qui affiche le fournisseur en fonction de l'id
+        AllowAnonymous(); //Autorise l'accès sans authentification
     }
 
     public override async Task HandleAsync(GetSupplierRequest req, CancellationToken ct)
@@ -28,8 +28,8 @@ public class GetSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext)
         if (supplier == null)
         {
             Console.WriteLine($"Aucun fournisseur avec l'ID {req.Id} trouvé.");
-            await Send.NotFoundAsync(ct);
-            return;
+            await Send.NotFoundAsync(ct); //Renvoie une erreur 404
+            return; //Arrêt de la méthode
         }
 
         var responseDto = new GetSupplierDto

PyroFetes/Endpoints/Supplier/UpdateSupplierEndpoint.cs

@@ -52,7 +52,7 @@ public class UpdateSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext) : End
             }
         }
 
-        await pyrofetesdbcontext.SaveChangesAsync(ct);
+        await pyrofetesdbcontext.SaveChangesAsync(ct);  //Sauvegarde les changements
 
         var response = new GetSupplierDto
         {
@@ -65,6 +65,6 @@ public class UpdateSupplierEndpoint(PyroFetesDbContext pyrofetesdbcontext) : End
             City = supplierToEdit.City
         };
 
-        await Send.OkAsync(response, ct);
+        await Send.OkAsync(response, ct); //Envoie de la réponse réussite 200 au client
     }
 }