mabibli/MaBibli.Shared/Dtos/LivreDto.cs

using System.Text.Json.Serialization;
using MaBibli.Shared.Entites;

namespace MaBibli.Shared.Dtos;

/// <summary>Un auteur tel qu'exposé par l'API : de quoi l'afficher et cliquer dessus.</summary>
public record AuteurDto
{
    public required int Id { get; init; }

    public required string Nom { get; init; }

    /// <summary>Nombre de livres du catalogue rattachés à cet auteur. Renseigné par la liste des auteurs.</summary>
    public int NombreDeLivres { get; init; }

    /// <summary>
    /// Rôle sur le livre où cet auteur figure. <b>N'a de sens qu'à l'intérieur d'un
    /// <see cref="LivreDto"/></b> : la liste des auteurs, elle, ne parle d'aucun livre en
    /// particulier et le laisse à <c>NonPrecise</c>.
    /// </summary>
    public RoleAuteur Role { get; init; }
}

/// <summary>
/// Un livre tel qu'exposé par l'API. Volontairement <b>sans</b> la collection de ses prêts :
/// le catalogue n'a besoin que de savoir si le livre est dehors, et l'historique complet se
/// demande à part (<c>GET /api/livres/{id}/prets</c>) pour ne pas alourdir chaque liste.
/// </summary>
public record LivreDto
{
    public required int Id { get; init; }

    public string? Isbn { get; init; }

    public required string Titre { get; init; }

    /// <summary>Auteurs, dans l'ordre de la couverture. Peut être vide.</summary>
    public IReadOnlyList<AuteurDto> Auteurs { get; init; } = [];

    public IReadOnlyList<string> Themes { get; init; } = [];

    public string? Editeur { get; init; }

    public required Format Format { get; init; }

    /// <summary>
    /// Roman, bande dessinée… <c>NonPrecise</c> par défaut, qui ne veut <b>pas</b> dire « roman ».
    /// </summary>
    public TypeDocument TypeDocument { get; init; }

    /// <summary>
    /// Statut de lecture <b>de l'utilisateur courant</b>, ou <c>null</c> s'il n'en a jamais posé
    /// (« non commencé »).
    /// </summary>
    /// <remarks>
    /// Ce champ dépend de qui appelle : le même livre remonte « Lu » pour l'un et <c>null</c>
    /// pour l'autre. C'est voulu — le livre est commun, sa lecture ne l'est pas.
    /// </remarks>
    public Statut? Statut { get; init; }

    /// <summary>Nombre de pages, ou <c>null</c> s'il n'a jamais été renseigné.</summary>
    /// <remarks>⚠️ Jamais <c>0</c> pour dire « inconnu » : l'interface ne l'affiche que renseigné.</remarks>
    public int? NombrePages { get; init; }

    public string? CoverUrl { get; init; }

    public string? UrlNotice { get; init; }

    public required DateTime DateAjout { get; init; }

    /// <summary>
    /// Qui a saisi le livre. <b>Information d'affichage, pas une frontière</b> :
    /// la bibliothèque est commune et aucune lecture ne filtre sur ce champ.
    /// </summary>
    public string? AjoutePar { get; init; }

    /// <summary>
    /// Nom de la personne qui a le livre en ce moment, ou <c>null</c> s'il est à la maison.
    /// </summary>
    /// <remarks>
    /// <b>Commun à tout le foyer</b>, contrairement au statut de lecture : un livre absent l'est
    /// pour tout le monde. Renseigné depuis le prêt ouvert du livre — il ne peut y en avoir qu'un.
    /// </remarks>
    public string? PreteA { get; init; }

    /// <summary>Date du prêt en cours, s'il y en a un.</summary>
    public DateTime? PreteDepuis { get; init; }

    [JsonIgnore]
    public bool EstPrete => PreteA is not null;

    /// <summary>Auteurs sur une ligne, pour un affichage compact.</summary>
    [JsonIgnore]
    public string? AuteursAffiches =>
        Auteurs.Count == 0 ? null : string.Join(", ", Auteurs.Select(a => a.Nom));
}