using MediatR; using System.ComponentModel.DataAnnotations; namespace EnvelopeGenerator.Application.EnvelopeReceivers.Commands.Create; /// /// Befehl zur Erstellung eines Umschlags. /// /// Der Titel des Umschlags. Dies ist ein Pflichtfeld. /// Die Nachricht, die im Umschlag enthalten sein soll. Dies ist ein Pflichtfeld. /// Das mit dem Umschlag verknüpfte Dokument. Dies ist ein Pflichtfeld. /// Eine Sammlung von Empfängern, die den Umschlag erhalten. Dies ist ein Pflichtfeld. /// Die Sprache des Umschlags. Standardmäßig "de-DE", wenn nicht angegeben. /// Das Ablaufdatum des Umschlags. Optional. /// Das Datum, an dem vor dem Ablauf eine Warnung ausgegeben werden soll. Optional. /// Der Vertragstyp, der mit dem Umschlag verknüpft ist. Standardmäßig der Typ "Contract". /// Gibt an, ob die Zwei-Faktor-Authentifizierung für den Umschlag aktiviert ist. Standardmäßig false. public record CreateEnvelopeCommand( [Required] string Title, [Required] string Message, [Required] DocumentCreateDto Document, [Required] IEnumerable Receivers, string Language = "de-DE", DateTime? ExpiresWhen = null, DateTime? ExpiresWarningWhen = null, int ContractType = (int)Common.Constants.ContractType.Contract, bool TFAEnabled = false ) : IRequest; #region DTOs /// /// Signaturposition auf einem Dokument. /// /// X-Position /// Y-Position /// Seite, auf der sie sich befindet public record Signature([Required] int X, [Required] int Y, [Required] int Page); /// /// DTO für Empfänger, die erstellt oder abgerufen werden sollen. /// Wenn nicht, wird sie erstellt und mit einer Signatur versehen. /// /// Unterschriften auf Dokumenten. /// Der Name, mit dem der Käufer angesprochen werden soll. Bei Null oder keinem Wert wird der zuletzt verwendete Name verwendet. /// Sollte mit Vorwahl geschrieben werden public record ReceiverGetOrCreateDto([Required] IEnumerable Signatures, string? Name = null, string? PhoneNumber = null) { private string _emailAddress = string.Empty; /// /// E-Mail-Adresse des Empfängers. /// [Required] public required string EmailAddress { get => _emailAddress.ToLower(); init => _emailAddress = _emailAddress.ToLower(); } }; /// /// DTO zum Erstellen eines Dokuments. /// /// /// Die Dokumentdaten im Byte-Array-Format. Wird verwendet, wenn das Dokument als Roh-Binärdaten bereitgestellt wird. /// /// /// Die Dokumentdaten im Base64-String-Format. Wird verwendet, wenn das Dokument als Base64-codierter String bereitgestellt wird. /// public record DocumentCreateDto(byte[]? DataAsByte = null, string? DataAsBase64 = null); #endregion