Refactor DTOs und Queries für Klarheit und Konsistenz

- Aktualisiert `ReceiverGetOrCreateDto`, um E-Mail in Kleinbuchstaben korrekt zuzuordnen und verbesserte Dokumentation.
- Der Parameter `Receiver` wurde aus der `EnvelopeReceiverQuery` entfernt.
- Verbesserte Kommentare in `ReadEnvelopeReceiverQuery`, um den Zweck zu verdeutlichen.
- Detaillierte Zusammenfassungskommentare zu `ReadEnvelopeReceiverResponse` und `ReadEnvelopeResponse` zum besseren Verständnis der Eigenschaften hinzugefügt.
- Es wurden neue zusammenfassende Kommentare in `ReadReceiverQuery` und `ReadReceiverResponse` eingeführt, um ihre Rollen und Beziehungen zu beschreiben.

EnvelopeGenerator.Application/EnvelopeReceivers/Queries/Read/ReadEnvelopeReceiverQuery.cs

@@ -5,11 +5,24 @@ using MediatR;
 namespace EnvelopeGenerator.Application.EnvelopeReceivers.Queries.Read;
 
 /// <summary>
-/// Stellt eine Abfrage zum Lesen eines Envelope-Empfängers dar.
+/// Repräsentiert eine Abfrage zum Lesen eines Envelope-Empfängers.
 /// </summary>
+/// <remarks>
+/// Diese Abfrage kombiniert Informationen über einen Umschlag (<see cref="ReadEnvelopeQuery"/>) 
+/// und einen Empfänger (<see cref="ReadReceiverQuery"/>), um eine vollständige Antwort 
+/// (<see cref="ReadEnvelopeReceiverResponse"/>) zu generieren. 
+/// Die Antwort enthält Details wie den Status, die Zuordnung zwischen Umschlag und Empfänger 
+/// sowie zusätzliche Metadaten.
+/// </remarks>
 public record ReadEnvelopeReceiverQuery : EnvelopeReceiverQuery, IRequest<ReadEnvelopeReceiverResponse>
 {
+    /// <summary>
+    /// Der Umschlag, der mit dem Empfänger verknüpft ist.
+    /// </summary>
     public ReadEnvelopeQuery? Envelope { get; init; }
 
+    /// <summary>
+    /// Der Empfänger, der mit dem Umschlag verknüpft ist.
+    /// </summary>
     public ReadReceiverQuery? Receiver { get; init; }
-};
+};

EnvelopeGenerator.Application/EnvelopeReceivers/Queries/Read/ReadEnvelopeReceiverResponse.cs

@@ -12,35 +12,80 @@ namespace EnvelopeGenerator.Application.EnvelopeReceivers.Queries.Read;
 /// <param name="Receiver">Der angeforderte Empfänger.</param>
 public record ReadEnvelopeReceiverResponse(int UserId, int Status)
 {
+    /// <summary>
+    /// Repräsentiert die Antwort für das Lesen eines Envelope-Empfängers.
+    /// </summary>
+    /// <remarks>
+    /// Diese Klasse enthält Informationen über einen spezifischen Empfänger eines Umschlags (Envelope).
+    /// Sie verknüpft die Empfängerinformationen mit den zugehörigen Umschlagsdaten und bietet zusätzliche Metadaten.
+    /// </remarks>
+    /// <param name="UserId">Die eindeutige Kennung des Benutzers, der den Empfänger erstellt hat.</param>
+    /// <param name="Status">Der Status des Empfängers als numerischer Wert.</param>
     [NotMapped]
     public (int Envelope, int Receiver) Id => (Envelope: EnvelopeId, Receiver: ReceiverId);
 
+    /// <summary>
+    /// Die eindeutige Kennung des zugehörigen Umschlags.
+    /// </summary>
     [Required]
     public int EnvelopeId { get; init; }
 
+    /// <summary>
+    /// Die eindeutige Kennung des Empfängers.
+    /// </summary>
     [Required]
     public int ReceiverId { get; init; }
 
+    /// <summary>
+    /// Die Reihenfolge des Empfängers innerhalb des Umschlags.
+    /// </summary>
     public int Sequence { get; init; }
 
+    /// <summary>
+    /// Der Name des Empfängers. Kann als Platzhalter verwendet werden.
+    /// </summary>
     [TemplatePlaceholder("[NAME_RECEIVER]")]
     public string? Name { get; init; }
 
+    /// <summary>
+    /// Die Berufsbezeichnung des Empfängers.
+    /// </summary>
     public string? JobTitle { get; init; }
 
+    /// <summary>
+    /// Der Firmenname des Empfängers.
+    /// </summary>
     public string? CompanyName { get; init; }
 
+    /// <summary>
+    /// Eine private Nachricht, die mit dem Empfänger verknüpft ist.
+    /// </summary>
     public string? PrivateMessage { get; init; }
 
+    /// <summary>
+    /// Das Datum und die Uhrzeit, wann der Empfänger hinzugefügt wurde.
+    /// </summary>
     public DateTime AddedWhen { get; init; }
 
+    /// <summary>
+    /// Das Datum und die Uhrzeit, wann der Empfänger zuletzt geändert wurde (falls vorhanden).
+    /// </summary>
     public DateTime? ChangedWhen { get; init; }
 
+    /// <summary>
+    /// Gibt an, ob der Empfänger eine Telefonnummer hat.
+    /// </summary>
     public bool HasPhoneNumber { get; init; }
 
+    /// <summary>
+    /// Die zugehörigen Umschlagsdaten.
+    /// </summary>
     [Required]
     public required ReadEnvelopeResponse Envelope { get; init; }
 
+    /// <summary>
+    /// Die Liste der Empfängerinformationen.
+    /// </summary>
     [Required]
     public IEnumerable<ReadReceiverResponse> Receiver { get; init; } = new List<ReadReceiverResponse>();
 }