using System.Text.Json.Serialization; using MaBibli.Shared.Entites; using MaBibli.Shared.Textes; namespace MaBibli.Shared.Dtos; /// /// Charge utile de création et de modification d'un livre. /// /// /// n'y figure pas volontairement : il est déterminé par le serveur /// à partir de l'utilisateur authentifié, jamais par le client. /// public record EnregistrementLivre { /// Séparateur des auteurs dans la forme texte d'un champ de saisie. /// /// Le point-virgule, et non la virgule : celle-ci est déjà prise par la forme /// bibliographique « Zola, Émile », qu'on doit pouvoir taper telle quelle. /// public const char SeparateurAuteurs = ';'; /// Facultatif : certains livres n'ont pas d'ISBN. Normalisé par le serveur. public string? Isbn { get; set; } public string Titre { get; set; } = string.Empty; /// /// Auteurs, dans l'ordre de la couverture, chacun avec son rôle sur ce livre. Le /// serveur les rattache aux fiches existantes quand c'est sûr, et en crée sinon. /// public List Auteurs { get; set; } = []; /// Thèmes saisis manuellement, séparés par des points-virgules dans l'interface. public List Themes { get; set; } = []; public string? Editeur { get; set; } public Format Format { get; set; } /// Roman, bande dessinée… Facultatif : « non précisé » est une réponse valable. public TypeDocument TypeDocument { get; set; } /// /// Statut de lecture de l'appelant. null = non commencé, et aucune ligne n'est /// alors écrite en base. /// public Statut? Statut { get; set; } public string? CoverUrl { get; set; } /// /// Notice ayant servi au préremplissage, ou null pour une saisie manuelle. /// public string? UrlNotice { get; set; } /// /// Vue « une seule ligne » de , pour les champs de saisie simples. /// /// /// Non sérialisée : est la forme de référence sur le fil. Cette /// propriété existe pour que l'interface puisse lier un <input> unique sans /// avoir à gérer une liste dynamique — un foyer saisit un auteur dans l'immense majorité /// des cas, et les rares livres à quatre auteurs se tapent avec des « ; ». /// [JsonIgnore] public string? Auteur { get => Auteurs.Count == 0 ? null : string.Join($"{SeparateurAuteurs} ", Auteurs.Select(a => a.Nom)); set => Auteurs = Decouper(value, Auteurs); } [JsonIgnore] public string? ThemesTexte { get => Themes.Count == 0 ? null : ListeSaisie.Joindre(Themes); set => Themes = DecouperThemes(value); } /// /// Découpe une saisie texte en auteurs, en écartant les entrées vides. /// /// /// Auteurs déjà saisis, dont les rôles sont repris quand le nom réapparaît. /// /// /// ⚠️ Sans cette reprise, corriger une faute de frappe dans le champ des noms effacerait le /// rôle des auteurs voisins : le champ se relie à chaque frappe, et il reconstruirait la /// liste entière à « non précisé ». Le rapprochement se fait sur la forme normalisée du nom, /// pour survivre à un accent ajouté après coup. /// public static List Decouper(string? saisie, IEnumerable? connus = null) { if (string.IsNullOrWhiteSpace(saisie)) { return []; } var roles = new Dictionary(StringComparer.Ordinal); foreach (var connu in connus ?? []) { roles.TryAdd(NormalisationTexte.Normaliser(connu.Nom), connu.Role); } return saisie .Split(SeparateurAuteurs, StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries) .Select(nom => new AuteurSaisi( nom, roles.GetValueOrDefault(NormalisationTexte.Normaliser(nom), RoleAuteur.NonPrecise))) .ToList(); } /// /// Découpe la ligne des thèmes. Séparateur : le point-virgule, comme celui des /// auteurs juste au-dessus dans le même formulaire — la virgule reste acceptée, un thème /// n'en contenant jamais. /// public static List DecouperThemes(string? saisie) => ListeSaisie.Decouper(saisie, virguleAussi: true); } /// Un auteur tel qu'il est saisi : son nom, et son rôle sur ce livre. /// /// Le rôle n'appartient pas à la personne mais au lien : le même auteur scénarise un /// album et dessine le suivant. Voir . /// public record AuteurSaisi(string Nom, RoleAuteur Role = RoleAuteur.NonPrecise); /// Demande de renommage d'une fiche auteur. public record RenommerAuteur(string Nom); /// Résultat d'un renommage, avec collision éventuelle à confirmer. public record ResultatRenommageAuteur { public AuteurDto? Auteur { get; init; } public AuteurDto? Collision { get; init; } public bool EstCollision => Collision is not null; } /// Charge utile du changement de statut de lecture — l'action la plus fréquente. /// /// Le statut posé est toujours celui de l'appelant : il n'y a pas de champ « utilisateur », /// et il ne doit jamais y en avoir. Personne ne coche « lu » à la place d'un autre. /// public record ChangementStatut { /// null retire le statut : le livre redevient « non commencé » pour l'appelant. public Statut? Statut { get; set; } }