Commentaire des DTO

PyroFetes/DTO/Material/Request/CreateMaterialDto.cs

@@ -1,9 +1,17 @@
-namespace API.DTO.Material.Request;
-
-public class CreateMaterialDto
+// Définition de l'espace de noms pour les DTO utilisés dans les requêtes liées aux matériaux
+namespace API.DTO.Material.Request
 {
-    public string? Label { get; set; }
-    public int Quantity { get; set; }
-    public int WarehouseId {get; set;}
+    // DTO utilisé pour créer un nouveau matériau
+    public class CreateMaterialDto
+    {
+        // Nom ou label du matériau
+        // Le type "string?" signifie que cette valeur peut être null si aucune valeur n'est fournie
+        public string? Label { get; set; }
 
+        // Quantité du matériau à créer
+        public int Quantity { get; set; }
+
+        // Identifiant de l'entrepôt dans lequel le matériau sera stocké
+        public int WarehouseId { get; set; }
+    }
 }

PyroFetes/DTO/Material/Request/UpdateMaterialDto.cs

@@ -1,10 +1,20 @@
-namespace API.DTO.Material.Request;
-
-public class UpdateMaterialDto
+// Définition de l'espace de noms pour les DTO utilisés dans les requêtes liées aux matériaux
+namespace API.DTO.Material.Request
 {
-    public int Id { get; set; }
-    public string? Label { get; set; }
-    public int Quantity { get; set; }
-    public int WarehouseId {get; set;}
+    // DTO utilisé pour mettre à jour un matériau existant
+    public class UpdateMaterialDto
+    {
+        // Identifiant unique du matériau à mettre à jour
+        public int Id { get; set; }
 
+        // Nom ou label du matériau
+        // Le type "string?" signifie que cette valeur peut être null si aucune valeur n'est fournie
+        public string? Label { get; set; }
+
+        // Quantité mise à jour du matériau
+        public int Quantity { get; set; }
+
+        // Identifiant de l'entrepôt associé au matériau
+        public int WarehouseId { get; set; }
+    }
 }

PyroFetes/DTO/Material/Response/GetMaterialDto.cs

@@ -1,10 +1,20 @@
-namespace API.DTO.Material.Response;
-
-public class GetMaterialDto
+// Définition de l'espace de noms pour les DTO utilisés dans les réponses liées aux matériaux
+namespace API.DTO.Material.Response
 {
-    public int Id { get; set; }
-    public string? Label { get; set; }
-    public int Quantity { get; set; }
-    public int WarehouseId {get; set;}
+    // DTO utilisé pour renvoyer les informations d'un matériau
+    public class GetMaterialDto
+    {
+        // Identifiant unique du matériau
+        public int Id { get; set; }
 
+        // Nom ou label du matériau
+        // Le type "string?" signifie que cette valeur peut être null si aucune valeur n'est définie
+        public string? Label { get; set; }
+
+        // Quantité disponible du matériau
+        public int Quantity { get; set; }
+
+        // Identifiant de l'entrepôt auquel le matériau est associé
+        public int WarehouseId { get; set; }
+    }
 }