namespace EnvelopeGenerator.Application.Common.Query;

/// <summary>
/// Stellt eine Abfrage dar, um die Details eines Empfängers zu lesen.
/// um spezifische Informationen über einen Empfänger abzurufen.
/// </summary>
public record ReceiverQueryBase
{
    /// <summary>
    /// ID des Empfängers
    /// </summary>
    public virtual int? Id { get; set; }

    /// <summary>
    /// E-Mail Adresse des Empfängers
    /// </summary>
    public virtual string? EmailAddress { get; set; }

    /// <summary>
    /// Eindeutige Signatur des Empfängers
    /// </summary>
    public virtual string? Signature { get; set; }

    /// <summary>
    /// Checks whether any of the specified query criteria have a value.
    /// </summary>
    /// <remarks>
    /// This property returns <c>true</c> if at least one of the fields 
    /// <see cref="Id"/>, <see cref="EmailAddress"/>, or <see cref="Signature"/> is not null.
    /// <para>Usage example: The query can be executed only if at least one criterion is specified.</para>
    /// </remarks>
    public bool HasAnyCriteria => Id is not null || EmailAddress is not null || Signature is not null;
}