Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
67 lines
2.7 KiB
C#
67 lines
2.7 KiB
C#
namespace MaBibli.Shared.Dtos;
|
|
|
|
/// <summary>Source d'où proviennent les métadonnées d'un candidat.</summary>
|
|
public enum SourceMetadonnees
|
|
{
|
|
/// <summary>Catalogue général de la BnF, via son API SRU (Dublin Core).</summary>
|
|
Bnf = 0,
|
|
|
|
/// <summary>OpenLibrary (Internet Archive), second rideau de la cascade.</summary>
|
|
OpenLibrary = 1,
|
|
}
|
|
|
|
/// <summary>
|
|
/// Une notice candidate pour un ISBN donné.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Un même ISBN peut correspondre à <b>plusieurs</b> notices (rééditions successives partageant
|
|
/// l'ISBN). Décision actée dans CLAUDE.md : on ne choisit pas à la place de l'utilisateur,
|
|
/// on lui présente tous les candidats. C'est l'interface (phase 3) qui fera choisir.
|
|
/// </remarks>
|
|
public record CandidatLivre
|
|
{
|
|
/// <summary>Titre nettoyé de la ponctuation ISBD.</summary>
|
|
public required string Titre { get; init; }
|
|
|
|
/// <summary>
|
|
/// Auteurs au format « Prénom Nom », dans l'ordre donné par la source. Peut être vide.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Une liste, et non une chaîne : <i>Introduction to Algorithms</i> en renvoie quatre
|
|
/// (Cormen, Leiserson, Rivest, Stein), et les recoller pour les redécouper ensuite ferait
|
|
/// perdre la frontière entre « Zola, Émile » et deux auteurs.
|
|
/// </remarks>
|
|
public IReadOnlyList<string> Auteurs { get; init; } = [];
|
|
|
|
/// <summary>
|
|
/// Les auteurs sur une ligne, séparés comme les attend un champ de saisie
|
|
/// (<see cref="EnregistrementLivre.SeparateurAuteurs"/>).
|
|
/// </summary>
|
|
public string? Auteur =>
|
|
Auteurs.Count == 0
|
|
? null
|
|
: string.Join($"{EnregistrementLivre.SeparateurAuteurs} ", Auteurs);
|
|
|
|
public string? Editeur { get; init; }
|
|
|
|
/// <summary>Année de publication telle que fournie par la source (texte : « 1979 », « March 2007 »…).</summary>
|
|
public string? Annee { get; init; }
|
|
|
|
/// <summary>Code langue tel que fourni par la source (« fre », « eng »…).</summary>
|
|
public string? Langue { get; init; }
|
|
|
|
/// <summary>URL de la couverture chez OpenLibrary, toujours renseignée (voir remarques du service).</summary>
|
|
public string? CoverUrl { get; init; }
|
|
|
|
public required SourceMetadonnees Source { get; init; }
|
|
|
|
/// <summary>Forme d'ISBN qui a effectivement produit cette notice (13 ou 10 converti).</summary>
|
|
public string? IsbnInterroge { get; init; }
|
|
|
|
/// <summary>Identifiant chez la source : ark BnF (<c>ark:/12148/cb…</c>) ou clé OpenLibrary (<c>/books/OL…M</c>).</summary>
|
|
public string? IdentifiantSource { get; init; }
|
|
|
|
/// <summary>URL de consultation de la notice chez la source.</summary>
|
|
public string? UrlNotice { get; init; }
|
|
}
|