EnvelopeGenerator/EnvelopeGenerator.GeneratorAPI/Controllers/ReceiverController.cs

using DigitalData.Core.API;
using DigitalData.Core.DTO;
using EnvelopeGenerator.Application.Contracts.Services;
using EnvelopeGenerator.Application.DTOs.Receiver;
using EnvelopeGenerator.Application.Receivers.Queries.Read;
using EnvelopeGenerator.Domain.Entities;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;

namespace EnvelopeGenerator.GeneratorAPI.Controllers;

/// <summary>
/// Controller für die Verwaltung von Empfängern.
/// </summary>
/// <remarks>
/// Dieser Controller bietet Endpunkte für CRUD-Operationen (Erstellen, Lesen, Aktualisieren, Löschen) 
/// sowie zusätzliche Funktionen wie das Abrufen von Empfängern basierend auf E-Mail-Adresse oder Signatur.
/// </remarks>
[Route("api/[controller]")]
[ApiController]
[Authorize]
public class ReceiverController : CRUDControllerBaseWithErrorHandling<IReceiverService, ReceiverCreateDto, ReceiverReadDto, ReceiverUpdateDto, Receiver, int>
{
    /// <summary>
    /// Initialisiert eine neue Instanz des <see cref="ReceiverController"/>-Controllers.
    /// </summary>
    /// <param name="logger">Der Logger für die Protokollierung.</param>
    /// <param name="service">Der Dienst für Empfängeroperationen.</param>
    public ReceiverController(ILogger<ReceiverController> logger, IReceiverService service) : base(logger, service)
    {
    }

    /// <summary>
    /// Ruft eine Liste von Empfängern ab, basierend auf den angegebenen Abfrageparametern.
    /// </summary>
    /// <param name="receiver">Die Abfrageparameter, einschließlich E-Mail-Adresse und Signatur.</param>
    /// <returns>Eine Liste von Empfängern oder ein Fehlerstatus.</returns>
    [HttpGet]
    public async Task<IActionResult> Get([FromQuery] ReadReceiverQuery receiver)
    {
        if (receiver.Id is null && receiver.EmailAddress is null && receiver.Signature is null)
            return await base.GetAll();

        if (receiver.Id is int id)
            return await _service.ReadByIdAsync(id).ThenAsync(
                Success: Ok,
                Fail: IActionResult (msg, ntc) =>
                {
                    return NotFound();
                });

        return await _service.ReadByAsync(emailAddress: receiver.EmailAddress, signature: receiver.Signature).ThenAsync(
                Success: Ok,
                Fail: IActionResult (msg, ntc) =>
                {
                    return NotFound();
                });
    }

    #region REMOVED ENDPOINTS
    /// <summary>
    /// Diese Methode ist deaktiviert und wird nicht verwendet.
    /// </summary>
    [NonAction]
    public override Task<IActionResult> GetAll() => base.GetAll();

    /// <summary>
    /// Diese Methode ist deaktiviert und wird nicht verwendet.
    /// </summary>
    [NonAction]
    public override Task<IActionResult> Delete([FromRoute] int id) => base.Delete(id);

    /// <summary>
    /// Diese Methode ist deaktiviert und wird nicht verwendet.
    /// </summary>
    [NonAction]
    public override Task<IActionResult> Update(ReceiverUpdateDto updateDto) => base.Update(updateDto);

    /// <summary>
    /// Diese Methode ist deaktiviert und wird nicht verwendet.
    /// </summary>
    [NonAction]
    public override Task<IActionResult> Create(ReceiverCreateDto createDto)
    {
        return base.Create(createDto);
    }

    /// <summary>
    /// Diese Methode ist deaktiviert und wird nicht verwendet.
    /// </summary>
    [NonAction]
    public override Task<IActionResult> GetById([FromRoute] int id)
    {
        return base.GetById(id);
    }
    #endregion
}