Files
ShopSolution-backend/Webshop.Api/Controllers/Admin/AdminDiscountsController.cs
2025-08-12 11:52:50 +02:00

98 lines
4.0 KiB
C#

// 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€).
/// - **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();
}
}
}