namespace MaBibli.Shared.Dtos;

/// <summary>
/// Ce qu'on sait d'un code-barres qui s'est révélé être celui d'un <b>périodique</b>
/// (préfixe <c>977</c>) et non d'un livre.
/// </summary>
/// <remarks>
/// Le modèle de données ne gère <b>pas</b> les périodiques : ni numéro, ni date de parution.
/// Cet objet n'existe donc pas pour cataloguer une revue, mais pour <b>dire à l'utilisateur ce
/// qu'il vient de scanner</b> au lieu de lui répondre « aucun résultat » — ce qui l'enverrait
/// chercher un défaut là où il n'y en a pas.
/// </remarks>
public record PeriodiqueDetecte
{
    /// <summary>ISSN déduit du code-barres, forme canonique à tiret (<c>2466-6718</c>).</summary>
    public required string Issn { get; init; }

    /// <summary>
    /// Titre de la revue d'après la BnF, ou <c>null</c> si elle ne connaît pas cet ISSN
    /// ou n'a pas répondu. Le distinguer d'un titre trouvé est ce qui permet de ne pas
    /// affirmer un nom qu'on n'a pas.
    /// </summary>
    public string? Titre { get; init; }

    /// <summary>Éditeur de la revue, quand la notice en porte un.</summary>
    public string? Editeur { get; init; }

    /// <summary>Année de début de publication de la revue (et non du numéro scanné).</summary>
    public string? Annee { get; init; }
}