discount und summary

Webshop.Api/Controllers/Admin/AdminDiscountsController.cs

@@ -1,18 +1,98 @@
-// Auto-generiert von CreateWebshopFiles.ps1
+// src/Webshop.Api/Controllers/Admin/AdminDiscountsController.cs
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.AspNetCore.Authorization;
-
 using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
+using Webshop.Application.DTOs.Discounts;
+using Webshop.Application.Services.Admin.Interfaces;
 
 namespace Webshop.Api.Controllers.Admin
 {
+    /// <summary>
+    /// API-Endpunkte zur Verwaltung von Rabatten und Gutscheincodes.
+    /// </summary>
     [ApiController]
     [Route("api/v1/admin/[controller]")]
     [Authorize(Roles = "Admin")]
     public class AdminDiscountsController : ControllerBase
     {
+        private readonly IAdminDiscountService _adminDiscountService;
 
+        public AdminDiscountsController(IAdminDiscountService adminDiscountService)
+        {
+            _adminDiscountService = adminDiscountService;
+        }
+
+        /// <summary>
+        /// Ruft eine Liste aller konfigurierten Rabatte ab.
+        /// </summary>
+        [HttpGet]
+        public async Task<ActionResult<IEnumerable<DiscountDto>>> GetAllDiscounts()
+        {
+            var discounts = await _adminDiscountService.GetAllDiscountsAsync();
+            return Ok(discounts);
+        }
+
+        /// <summary>
+        /// Ruft einen einzelnen Rabatt anhand seiner eindeutigen ID ab.
+        /// </summary>
+        /// <param name="id">Die ID des Rabatts.</param>
+        [HttpGet("{id}")]
+        public async Task<ActionResult<DiscountDto>> GetDiscountById(Guid id)
+        {
+            var discount = await _adminDiscountService.GetDiscountByIdAsync(id);
+            if (discount == null) return NotFound();
+            return Ok(discount);
+        }
+
+        /// <summary>
+        /// Erstellt einen neuen Rabatt.
+        /// </summary>
+        /// <remarks>
+        /// **Funktionsweise von Rabatten:**
+        /// - **DiscountType:** 'Percentage' (z.B. 10 f<>r 10%) oder 'FixedAmount' (z.B. 5 f<>r 5,00<30>).
+        /// - **CouponCode:** Wenn `requiresCouponCode` auf `true` gesetzt ist, muss ein eindeutiger `couponCode` angegeben werden.
+        /// - **G<>ltigkeit:** Kann durch `startDate` und `endDate` zeitlich begrenzt werden.
+        /// - **Zuweisung:** Der Rabatt kann entweder bestimmten Produkten (`assignedProductIds`) oder ganzen Kategorien (`assignedCategoryIds`) zugewiesen werden. Wenn beide Listen leer sind, gilt der Rabatt f<>r den gesamten Warenkorb (sofern `minimumOrderAmount` erreicht ist).
+        /// </remarks>
+        /// <param name="discountDto">Das Datenobjekt des zu erstellenden Rabatts.</param>
+        [HttpPost]
+        public async Task<ActionResult<DiscountDto>> CreateDiscount([FromBody] DiscountDto discountDto)
+        {
+            if (!ModelState.IsValid) return BadRequest(ModelState);
+            var createdDiscount = await _adminDiscountService.CreateDiscountAsync(discountDto);
+            return CreatedAtAction(nameof(GetDiscountById), new { id = createdDiscount.Id }, createdDiscount);
+        }
+
+        /// <summary>
+        /// Aktualisiert einen bestehenden Rabatt.
+        /// </summary>
+        /// <param name="id">Die ID des zu aktualisierenden Rabatts.</param>
+        /// <param name="discountDto">Die neuen Daten f<>r den Rabatt.</param>
+        [HttpPut("{id}")]
+        public async Task<IActionResult> UpdateDiscount(Guid id, [FromBody] DiscountDto discountDto)
+        {
+            if (id != discountDto.Id) return BadRequest();
+            if (!ModelState.IsValid) return BadRequest(ModelState);
+
+            var success = await _adminDiscountService.UpdateDiscountAsync(discountDto);
+            if (!success) return NotFound();
+
+            return NoContent();
+        }
+
+        /// <summary>
+        /// L<>scht einen Rabatt.
+        /// </summary>
+        /// <param name="id">Die ID des zu l<>schenden Rabatts.</param>
+        [HttpDelete("{id}")]
+        public async Task<IActionResult> DeleteDiscount(Guid id)
+        {
+            var success = await _adminDiscountService.DeleteDiscountAsync(id);
+            if (!success) return NotFound();
+
+            return NoContent();
+        }
     }
-}
+}

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)
         {