commentaire endpoint

PyroFetes/Endpoints/Warehouse/CreateWarehouseEndpoint.cs

@@ -6,17 +6,17 @@ using PyroFetes.Models;
 namespace PyroFetes.Endpoints.Warehouse;
 
 public class CreateWarehouseEndpoint(PyroFetesDbContext db) 
-    : Endpoint<CreateWarehouseDto, GetWarehouseDto>
+    : Endpoint<CreateWarehouseDto, GetWarehouseDto> //Instanciation d'une connexion à la bdd dans un endpoint, utilise l'élément de requête CreateWarehouseDto et l'élement de réponse GetWarehouseDto
 {
-    public override void Configure()
+    public override void Configure() //Configuration de l'endpoint
     {
-        Post("/api/warehouse");
-        AllowAnonymous();
+        Post("/api/warehouse"); //Créer un entrepot 
+        AllowAnonymous(); //Autorise l'accès sans authentification
     }
 
     public override async Task HandleAsync(CreateWarehouseDto req, CancellationToken ct)
     {
-        var warehouse = new Models.Warehouse
+        var warehouse = new Models.Warehouse //Création d'un nom, d'un poids maximal et minimal, d'une adresse, d'un code postal et du nom de la ville rentré par l'utilisateur
         {
             Name = req.Name,
             MaxWeight = req.MaxWeight,
@@ -27,8 +27,8 @@ public class CreateWarehouseEndpoint(PyroFetesDbContext db)
             City = req.City
         };
 
-        db.Warehouses.Add(warehouse);
-        await db.SaveChangesAsync(ct);
+        db.Warehouses.Add(warehouse); //Ajout de l'entrepot à la bdd
+        await db.SaveChangesAsync(ct); //Sauvegarde de l'entrepot dans la bdd
 
         // 🔹 Ajout des produits liés à cet entrepôt
         if (req.Products is not null && req.Products.Any())
@@ -46,7 +46,7 @@ public class CreateWarehouseEndpoint(PyroFetesDbContext db)
             await db.SaveChangesAsync(ct);
         }
 
-        var response = new GetWarehouseDto
+        var response = new GetWarehouseDto //renvoie l'id, d'un nom, d'un poids maximal et minimal, d'une adresse, d'un code postal et du nom de la ville
         {
             Id = warehouse.Id,
             Name = warehouse.Name,
@@ -58,6 +58,6 @@ public class CreateWarehouseEndpoint(PyroFetesDbContext db)
             City = warehouse.City
         };
 
-        await Send.OkAsync(response, ct);
+        await Send.OkAsync(response, ct); //Réponse au client
     }
 }

PyroFetes/Endpoints/Warehouse/DeleteWarehouseEndpoint.cs

@@ -45,6 +45,6 @@ public class DeleteWarehouseEndpoint(PyroFetesDbContext db) : Endpoint<DeleteWar
         await db.SaveChangesAsync(ct);
 
         Console.WriteLine($"Entrepôt {warehouseToDelete.Name} (ID {req.Id}) supprimé avec succès.");
-        await Send.NoContentAsync(ct);
+        await Send.NoContentAsync(ct); //Renvoie une réponse réussite 204 
     }
 }