Verbesserte Funktionen zur Erstellung von Umschlägen und Aktualisierung von Projekten

Neue DTOs und Befehle zur Erstellung von Umschlägen in CreateEnvelope.cs hinzugefügt. Aktualisierte Projektdateien, um net7.0, net8.0 und net9.0 zu unterstützen. Refactored EnvelopeController für bessere Struktur und Fehlerbehandlung. Einführung einer Methode zur Erstellung von Umschlägen in EnvelopeReceiverController unter Verwendung von IMediator. Allgemeine Verbesserungen der Funktionalität und Kompatibilität.

EnvelopeGenerator.Application/EnvelopeGenerator.Application.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
 	<PropertyGroup>
-		<TargetFramework>net7.0</TargetFramework>
+		<TargetFrameworks>net7.0;net8.0;net9.0</TargetFrameworks>
 		<ImplicitUsings>enable</ImplicitUsings>
 		<Nullable>enable</Nullable>
 	</PropertyGroup>

EnvelopeGenerator.Application/EnvelopeReceivers/Commands/CreateEnvelope.cs

@@ -1,7 +1,7 @@
 using MediatR;
 using System.ComponentModel.DataAnnotations;
 
-namespace EnvelopeGenerator.Application.Envelope.Commands;
+namespace EnvelopeGenerator.Application.EnvelopeReceivers.Commands;
 
 #region DTOs
 /// <summary>
@@ -43,12 +43,12 @@ public record CreateEnvelopeCommand(
     [Required] string Title,
     [Required] string Message,
     [Required] DocumentCreateDto Document,
-    [Required] IEnumerable<ReceiverGetOrCreateDto> Receivers
+    [Required] IEnumerable<ReceiverGetOrCreateDto> Receivers,
     string Language = "de-DE",
     DateTime? ExpiresWhen = null,
     DateTime? ExpiresWarningWhen = null,
     int ContractType = (int)Common.Constants.ContractType.Contract,
-    bool TFAEnabled = false,
+    bool TFAEnabled = false
     ) : IRequest;
 
 /// <summary>
@@ -56,7 +56,7 @@ public record CreateEnvelopeCommand(
 /// </summary>
 public class CreateEnvelopeCommandHandler : IRequestHandler<CreateEnvelopeCommand>
 {
-    public Task Handle(CreateEnvelopeCommand request, CancellationToken cancellationToken)
+    public Task<Unit> Handle(CreateEnvelopeCommand request, CancellationToken cancellationToken = default)
     {
         throw new NotImplementedException();
     }

EnvelopeGenerator.Domain/EnvelopeGenerator.Domain.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFrameworks>net7.0;net8.0;net9.0</TargetFrameworks>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
   </PropertyGroup>

EnvelopeGenerator.GeneratorAPI/Controllers/EnvelopeController.cs

@@ -3,50 +3,49 @@ using EnvelopeGenerator.Application.Contracts.Services;
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
 
-namespace EnvelopeGenerator.GeneratorAPI.Controllers
+namespace EnvelopeGenerator.GeneratorAPI.Controllers;
+
+[Route("api/[controller]")]
+[ApiController]
+[Authorize]
+public class EnvelopeController : ControllerBase
 {
-    [Route("api/[controller]")]
+    private readonly ILogger<EnvelopeController> _logger;
-    [ApiController]
+    private readonly IEnvelopeService _envelopeService;
-    [Authorize]
+    
-    public class EnvelopeController : ControllerBase
+    public EnvelopeController(ILogger<EnvelopeController> logger, IEnvelopeService envelopeService)
     {
-        private readonly ILogger<EnvelopeController> _logger;
+        _logger = logger;
-        private readonly IEnvelopeService _envelopeService;
+        _envelopeService = envelopeService;
+    }
 
-        public EnvelopeController(ILogger<EnvelopeController> logger, IEnvelopeService envelopeService)
+    [Authorize]
+    [HttpGet]
+    public async Task<IActionResult> GetAsync(
+        [FromQuery] int? min_status = null,
+        [FromQuery] int? max_status = null,
+        [FromQuery] params int[] ignore_statuses)
+    {
+        try
         {
-            _logger = logger;
+            if (User.GetId() is int intId)
-            _envelopeService = envelopeService;
+                return await _envelopeService.ReadByUserAsync(intId, min_status: min_status, max_status: max_status, ignore_statuses: ignore_statuses).ThenAsync(
-        }
+                    Success: Ok,
-
+                    Fail: IActionResult (msg, ntc) =>
-        [Authorize]
+                    {
-        [HttpGet]
+                        _logger.LogNotice(ntc);
-        public async Task<IActionResult> GetCurrentAsync(
+                        return StatusCode(StatusCodes.Status500InternalServerError);
-            [FromQuery] int? min_status = null,
+                    });
-            [FromQuery] int? max_status = null,
+            else
-            [FromQuery] params int[] ignore_statuses)
-        {
-            try
             {
-                if (User.GetId() is int intId)
+                _logger.LogError("Despite successful authorization, the 'api/envelope' route encountered an issue: the user ID is not recognized as an integer. This may be due to the removal of the ID during the creation of the claims list.");
-                    return await _envelopeService.ReadByUserAsync(intId, min_status: min_status, max_status: max_status, ignore_statuses: ignore_statuses).ThenAsync(
-                        Success: Ok,
-                        Fail: IActionResult (msg, ntc) =>
-                        {
-                            _logger.LogNotice(ntc);
-                            return StatusCode(StatusCodes.Status500InternalServerError);
-                        });
-                else
-                {
-                    _logger.LogError("Despite successful authorization, the 'api/envelope' route encountered an issue: the user ID is not recognized as an integer. This may be due to the removal of the ID during the creation of the claims list.");
-                    return StatusCode(StatusCodes.Status500InternalServerError);
-                }
-            }
-            catch (Exception ex)
-            {
-                _logger.LogError(ex, "{Message}", ex.Message);
                 return StatusCode(StatusCodes.Status500InternalServerError);
             }
         }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "{Message}", ex.Message);
+            return StatusCode(StatusCodes.Status500InternalServerError);
+        }
     }
 }

EnvelopeGenerator.GeneratorAPI/Controllers/EnvelopeReceiverController.cs

@@ -1,6 +1,8 @@
 using DigitalData.Core.DTO;
 using EnvelopeGenerator.Application.Contracts.Services;
+using EnvelopeGenerator.Application.EnvelopeReceivers.Commands;
 using EnvelopeGenerator.Common.My.Resources;
+using MediatR;
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
 
@@ -12,12 +14,16 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
     public class EnvelopeReceiverController : ControllerBase
     {
         private readonly ILogger<EnvelopeReceiverController> _logger;
+
         private readonly IEnvelopeReceiverService _erService;
 
-        public EnvelopeReceiverController(ILogger<EnvelopeReceiverController> logger, IEnvelopeReceiverService envelopeReceiverService)
+        private readonly IMediator _mediator;
+
+        public EnvelopeReceiverController(ILogger<EnvelopeReceiverController> logger, IEnvelopeReceiverService envelopeReceiverService, IMediator mediator)
         {
             _logger = logger;
             _erService = envelopeReceiverService;
+            _mediator = mediator;
         }
                 
         [HttpGet]
@@ -94,5 +100,55 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
                 return StatusCode(StatusCodes.Status500InternalServerError);
             }
         }
+
+        /// <summary>
+        /// Datenübertragungsobjekt mit Informationen zu Umschlägen, Empfängern und Unterschriften.
+        /// </summary>
+        /// <param name="envelope"></param>
+        /// <param name="cancellationToken">Token to cancel the operation</param>
+        /// <returns>HTTP-Antwort</returns>
+        /// <remarks>
+        /// Sample request:
+        ///
+        ///     POST /api/envelope
+        ///     {
+        ///        "title": "Vertragsdokument",
+        ///        "message": "Bitte unterschreiben Sie dieses Dokument.",
+        ///        "document": {
+        ///            "dataAsBase64": "dGVzdC1iYXNlNjQtZGF0YQ=="  
+        ///        },
+        ///        "receivers": [
+        ///            {
+        ///                "emailAddress": "example@example.com",
+        ///                "signatures": [
+        ///                    {
+        ///                        "x": 100,
+        ///                        "y": 200,
+        ///                        "page": 1
+        ///                    }
+        ///                ],
+        ///                "name": "Max Mustermann",
+        ///                "phoneNumber": "+49123456789"
+        ///            }
+        ///        ],
+        ///        "language": "de-DE",
+        ///        "expiresWhen": "2025-12-31T23:59:59Z",
+        ///        "expiresWarningWhen": "2025-12-24T23:59:59Z",
+        ///        "contractType": 1,
+        ///        "tfaEnabled": false
+        ///     }
+        ///
+        /// </remarks>
+        /// <response code="202">Envelope-Erstellung und Sendeprozessbefehl erfolgreich</response>
+        /// <response code="400">Wenn ein Fehler im HTTP-Body auftritt</response>
+        /// <response code="401">Wenn kein autorisierter Token vorhanden ist</response>
+        /// <response code="500">Es handelt sich um einen unerwarteten Fehler. Die Protokolle sollten überprüft werden.</response>
+        [Authorize]
+        [HttpPost]
+        public async Task<IActionResult> CreateAsync([FromBody] CreateEnvelopeCommand envelope, CancellationToken cancellationToken)
+        {
+            await _mediator.Send(envelope, cancellationToken);
+            return Accepted();
+        }
     }
 }

EnvelopeGenerator.Infrastructure/EnvelopeGenerator.Infrastructure.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFrameworks>net7.0;net8.0;net9.0</TargetFrameworks>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
   </PropertyGroup>