discount und summary

Webshop.Api/Controllers/Admin/AdminShopInfoController.cs

@@ -7,6 +7,9 @@ using Webshop.Application.Services.Admin;
 
 namespace Webshop.Api.Controllers.Admin
 {
+    /// <summary>
+    /// API-Endpunkte zur Verwaltung der zentralen Shop-Stammdaten.
+    /// </summary>
     [ApiController]
     [Route("api/v1/admin/[controller]")]
     [Authorize(Roles = "Admin")]
@@ -19,6 +22,12 @@ namespace Webshop.Api.Controllers.Admin
             _shopInfoService = shopInfoService;
         }
 
+        /// <summary>
+        /// Ruft die aktuellen Stammdaten des Shops ab.
+        /// </summary>
+        /// <remarks>
+        /// Diese Daten werden typischerweise in einem "Stammdaten"- oder "Shop-Einstellungen"-Formular im Admin-Dashboard angezeigt.
+        /// </remarks>
         [HttpGet]
         public async Task<ActionResult<AdminShopInfoDto>> GetShopInfo()
         {
@@ -26,6 +35,13 @@ namespace Webshop.Api.Controllers.Admin
             return Ok(info);
         }
 
+        /// <summary>
+        /// Aktualisiert die zentralen Stammdaten des Shops.
+        /// </summary>
+        /// <remarks>
+        /// Sendet das gesamte, ausgefüllte DTO. Alle Felder werden überschrieben.
+        /// </remarks>
+        /// <param name="shopInfoDto">Das Datenobjekt mit den neuen Shop-Informationen.</param>
         [HttpPut]
         public async Task<IActionResult> UpdateShopInfo([FromBody] AdminShopInfoDto shopInfoDto)
         {