Files
ShopSolution-backend/Webshop.Api/Controllers/Admin/AdminDiscountsController.cs
2025-08-29 13:57:39 +02:00

122 lines
5.3 KiB
C#

// src/Webshop.Api/Controllers/Admin/AdminDiscountsController.cs
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Webshop.Application;
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]
[ProducesResponseType(typeof(DiscountDto), StatusCodes.Status201Created)]
[ProducesResponseType(StatusCodes.Status400BadRequest)]
public async Task<ActionResult<DiscountDto>> CreateDiscount([FromBody] DiscountDto discountDto)
{
if (!ModelState.IsValid) return BadRequest(ModelState);
var result = await _adminDiscountService.CreateDiscountAsync(discountDto);
if (result.Type == ServiceResultType.Success)
{
return CreatedAtAction(nameof(GetDiscountById), new { id = result.Value!.Id }, result.Value);
}
return BadRequest(new { Message = result.ErrorMessage });
}
/// <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}")]
[ProducesResponseType(StatusCodes.Status204NoContent)]
[ProducesResponseType(StatusCodes.Status400BadRequest)]
[ProducesResponseType(StatusCodes.Status404NotFound)]
public async Task<IActionResult> UpdateDiscount(Guid id, [FromBody] DiscountDto discountDto)
{
if (id != discountDto.Id) return BadRequest("ID in URL und Body stimmen nicht überein.");
if (!ModelState.IsValid) return BadRequest(ModelState);
var result = await _adminDiscountService.UpdateDiscountAsync(discountDto);
return result.Type switch
{
ServiceResultType.Success => NoContent(),
ServiceResultType.NotFound => NotFound(new { Message = result.ErrorMessage }),
ServiceResultType.InvalidInput => BadRequest(new { Message = result.ErrorMessage }),
_ => StatusCode(StatusCodes.Status500InternalServerError, "Ein unerwarteter Fehler ist aufgetreten.")
};
}
/// <summary>
/// Löscht einen Rabatt.
/// </summary>
/// <param name="id">Die ID des zu löschenden Rabatts.</param>
[HttpDelete("{id}")]
[ProducesResponseType(StatusCodes.Status204NoContent)]
[ProducesResponseType(StatusCodes.Status404NotFound)]
public async Task<IActionResult> DeleteDiscount(Guid id)
{
var result = await _adminDiscountService.DeleteDiscountAsync(id);
return result.Type switch
{
ServiceResultType.Success => NoContent(),
ServiceResultType.NotFound => NotFound(new { Message = result.ErrorMessage }),
_ => StatusCode(StatusCodes.Status500InternalServerError, "Ein unerwarteter Fehler ist aufgetreten.")
};
}
}
}