Verbesserung der Umschlagserstellung mit neuen DTOs und Befehlen

Einführung neuer Datenübertragungsobjekte für Signaturen und Empfänger.
Aktualisiert `CreateEnvelopeCommand` um benötigte Felder wie
`Title`, `Message`, `Document` und `Receivers`, zusammen mit optionalen
Parametern. Entfernt `EnvelopeCreateDto` für einen besser strukturierten
Ansatz zur Verwaltung von Umschlagserstellungsdaten.

EnvelopeGenerator.Application/Envelope/Commands/CreateEnvelope.cs

@@ -1,12 +1,62 @@
 using MediatR;
+using System.ComponentModel.DataAnnotations;
 
 namespace EnvelopeGenerator.Application.Envelope.Commands;
 
-public record CreateEnvelopeCommand(EnvelopeCreateDto Envelope) : IRequest;
+#region DTOs
+/// <summary>
+/// Signaturposition auf einem Dokument.
+/// </summary>
+/// <param name="X">X-Position</param>
+/// <param name="Y">Y-Position</param>
+/// <param name="Page">Seite, auf der sie sich befindet</param>
+public record Signature([Required] int X, [Required] int Y, [Required] int Page);
 
+/// <summary>
+/// DTO für Empfänger, die erstellt oder abgerufen werden sollen.
+/// Wenn nicht, wird sie erstellt und mit einer Signatur versehen.
+/// </summary>
+/// <param name="Signatures">Unterschriften auf Dokumenten.</param>
+/// <param name="Name">Der Name, mit dem der Käufer angesprochen werden soll. Bei Null oder keinem Wert wird der zuletzt verwendete Name verwendet.</param>
+/// <param name="PhoneNumber">Sollte mit Vorwahl geschrieben werden</param>
+public record ReceiverGetOrCreateDto([Required] IEnumerable<Signature> Signatures, string? Name = null, string? PhoneNumber = null)
+{
+    private string _emailAddress;
+
+    /// <summary>
+    /// E-Mail-Adresse des Empfängers.
+    /// </summary>
+    [Required]
+    public required string EmailAddress { get => _emailAddress.ToLower(); init => _emailAddress.ToLower(); }
+};
+
+/// <summary>
+/// DTO für die Erstellung eines Dokuments.
+/// </summary>
+public record DocumentCreateDto(byte[]? DataAsByte = null, string? DataAsBase64 = null);
+#endregion
+
+/// <summary>
+/// Befehl zur Erstellung eines Umschlags.
+/// </summary>
+public record CreateEnvelopeCommand(
+    [Required] string Title,
+    [Required] string Message,
+    [Required] DocumentCreateDto Document,
+    [Required] IEnumerable<ReceiverGetOrCreateDto> Receivers
+    string Language = "de-DE",
+    DateTime? ExpiresWhen = null,
+    DateTime? ExpiresWarningWhen = null,
+    int ContractType = (int)Common.Constants.ContractType.Contract,
+    bool TFAEnabled = false,
+    ) : IRequest;
+
+/// <summary>
+/// Handler für den CreateEnvelopeCommand.
+/// </summary>
 public class CreateEnvelopeCommandHandler : IRequestHandler<CreateEnvelopeCommand>
 {
-    public Task<Unit> Handle(CreateEnvelopeCommand request, CancellationToken cancellationToken)
+    public Task Handle(CreateEnvelopeCommand request, CancellationToken cancellationToken)
     {
         throw new NotImplementedException();
     }

EnvelopeGenerator.Application/Envelope/Commands/EnvelopeCreateDto.cs

@@ -1,23 +0,0 @@
-using System.ComponentModel.DataAnnotations;
-using System.ComponentModel.DataAnnotations.Schema;
-
-namespace EnvelopeGenerator.Application.Envelope.Commands;
-
-public class EnvelopeCreateDto
-{
-    [Required]
-    public required string Title { get; init; }
-
-    [Required]
-    public required string Message { get; init; }
-
-    public string Language { get; init; } = "de-DE";
-
-    public DateTime? ExpiresWhen { get; init; }
-
-    public DateTime? ExpiresWarningWhen { get; init; }
-
-    public int? ContractType { get; init; } = (int)Common.Constants.ContractType.Contract;
-
-    public bool TFAEnabled { get; init; } = false;
-}