Compte les pages d'un livre, et fais des envies une liste à deux moitiés

Lot U — le nombre de pages
`Livre.NombrePages` est nullable, sans valeur par défaut : « 0 page » se lirait
comme une donnée là où l'on veut dire « on ne sait pas ». Même raison que pour
`TypeDocument.NonPrecise` — un défaut qui ne prétend rien n'a rien à reprendre,
d'où une migration réduite à un `AddColumn`. Le service refuse un zéro plutôt
que de l'écrire ; effacer le champ reste la façon de revenir à « inconnu ».

Le préremplissage vient de `dc:format`, que rien ne lisait jusqu'ici. ⚠️ Ce
champ n'est pas un nombre mais une phrase décrivant le support, et les notices
déjà enregistrées sous Fixtures/ le montrent : « 1 vol. (113 p.) : ill., couv.
ill. en coul. ; 18 cm », « 503 p. : couv. ill. ; 17 cm ». Les règles sont donc
étroites — un nombre suivi de « p. » ou de « page(s) », rien d'autre — et tout
le reste rend `null`. L'erreur n'est pas symétrique : un champ vide se remplit à
la main en trois secondes, un chiffre faux s'enregistre sans que personne ne le
voie. « 1 vol. » ne vaut pas 1, « 30 cm » ne vaut pas 30, et « (p. 45-90) »,
qui est une pagination de contribution, ne vaut rien. La valeur reste proposée
dans un champ modifiable, et rien n'est déduit pour un ebook.

Lot X — éditer une envie, et souhaiter une revue
`PUT /api/souhaits/{id}` recalcule la clé d'œuvre et l'auteur normalisé : sans
ce recalcul, le rapprochement « déjà au catalogue » continuerait de se faire sur
l'ancienne forme, et le signalement mentirait sans le dire. Le filtre sur
l'appelant fait partie de la clé de recherche, pas d'une vérification ultérieure
— l'envie d'un autre est introuvable (404), jamais refusée (403).

⚠️ Une édition peut heurter l'unicité (utilisateur, œuvre, auteur), ce qu'un
ajout ne peut pas : renommer une envie en une autre déjà présente répond par un
message lisible, jamais par « UNIQUE constraint failed ». 400 et non 409,
contrairement au doublon du catalogue : là-bas posséder deux exemplaires est
légitime et l'appel se reconfirme, ici l'index l'interdit et il n'y a rien à
confirmer. Le rang n'est pas touché — l'ordre a son propre point d'entrée.

⚠️ La couverture n'est écrite que si la charge utile en porte une. Aucun écran
n'offre de champ « URL de couverture » pour une envie (décision actée), donc un
remplacement inconditionnel l'aurait effacée à la première faute de frappe
corrigée.

`RevueSouhaitee` est une table sœur, et non des colonnes de plus sur
`LivreSouhaite` : un numéro n'a pas d'auteur et se distingue par son numéro,
deux choses que la clé d'unicité des envies de livres ne sait pas exprimer sans
devenir fausse pour tout le monde. `NumeroNormalise` est NOT NULL avec un défaut
vide — SQLite tient deux NULL pour distincts, et « Médor, sans numéro »
s'ajouterait autant de fois qu'on cliquerait. L'ISSN est canonisé avec son tiret,
seul code du projet rangé ainsi.

Le coût de la table sœur est payé partout où il devait l'être : affichage,
`.txt`, `.csv` et instantané hors-ligne `souhaits-revues`. ⚠️ Les revues forment
une SECTION à part plutôt que des lignes entrelacées : chaque table numérote son
rang indépendamment, et mélanger deux suites sans rapport produirait un ordre que
personne n'a choisi. Le `.txt`, groupé par auteur, ne pouvait de toute façon pas
les accueillir — elles n'en ont pas, et « Auteur non précisé » désigne des livres
dont l'auteur est inconnu. Le CSV gagne une colonne « Type » : sans elle, un tri
par titre rendrait revues et livres indiscernables, et la colonne des codes
mêlerait ISBN et ISSN en silence.

`ServiceRenormalisation` connaît la nouvelle table, avec la règle de collision
déjà en place. ⚠️ L'ISSN y est canonisé à part : `Renormaliser` n'applique rien
quand la clé ne bouge pas, un ISSN mal formé sur une ligne au titre inchangé y
échapperait.

`RevueSouhaitee` ne porte PAS de `CoverUrl` : rien à ajouter au garde de
`GET /api/couvertures`.

Vérifié en exécution : ISSN « 24666718 » rangé « 2466-6718 », édition de l'envie
d'un autre en 404, et les deux exports portant bien les deux moitiés.
602 tests au vert (552 au départ), aucun avertissement de compilation.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

MaBibli.Shared/Dtos/CandidatLivre.cs

@@ -50,6 +50,17 @@ public record CandidatLivre
     /// <summary>Code langue tel que fourni par la source (« fre », « eng »…).</summary>
     public string? Langue { get; init; }
 
+    /// <summary>
+    /// Nombre de pages lu dans la description matérielle de la notice, quand elle en donne un.
+    /// </summary>
+    /// <remarks>
+    /// ⚠️ <b>Une proposition, jamais une certitude</b> : la BnF n'expose pas un nombre de pages
+    /// mais une phrase (<c>dc:format</c> : « 1 vol. (349 p.) », « 30 cm », « 2 disques
+    /// compacts »). Tout ce que le nettoyage ne comprend pas reste <c>null</c> — mieux vaut un
+    /// champ vide qu'un chiffre inventé.
+    /// </remarks>
+    public int? NombrePages { get; init; }
+
     /// <summary>URL de la couverture chez OpenLibrary, toujours renseignée (voir remarques du service).</summary>
     public string? CoverUrl { get; init; }
 

MaBibli.Shared/Dtos/EnregistrementLivre.cs

@@ -47,6 +47,15 @@ public record EnregistrementLivre
     /// </summary>
     public Statut? Statut { get; set; }
 
+    /// <summary>
+    /// Nombre de pages. <c>null</c> = non renseigné, et surtout pas <c>0</c>.
+    /// </summary>
+    /// <remarks>
+    /// Peut arriver prérempli depuis <c>dc:format</c> de la BnF ; c'est alors une
+    /// <b>proposition</b>, que la saisie corrige ou efface.
+    /// </remarks>
+    public int? NombrePages { get; set; }
+
     public string? CoverUrl { get; set; }
 
     /// <summary>

MaBibli.Shared/Dtos/LivreDto.cs

@@ -58,6 +58,10 @@ public record LivreDto
     /// </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; }

MaBibli.Shared/Dtos/SouhaitDto.cs

@@ -68,6 +68,55 @@ public record EnregistrementSouhait
     public string? Note { get; set; }
 }
 
+/// <summary>
+/// Une envie de revue — ou de numéro précis — telle qu'exposée par l'API.
+/// </summary>
+/// <remarks>
+/// Comme <see cref="SouhaitDto"/>, <b>aucun champ « utilisateur »</b> : l'API ne rend que les
+/// envies de l'appelant.
+/// <para>
+/// Il n'y a volontairement <b>ni « Possede » ni « RevueId »</b>, contrairement aux envies de
+/// livres : le rapprochement avec les revues possédées supposerait de décider ce que vaut
+/// « j'ai la revue mais pas ce numéro », et un signalement faux sur une liste d'envies est
+/// exactement ce qu'on cherche à éviter. Rien n'empêchera de l'ajouter le jour où le besoin
+/// sera constaté.
+/// </para>
+/// </remarks>
+public record RevueSouhaiteeDto
+{
+    public required int Id { get; init; }
+
+    public required string Titre { get; init; }
+
+    /// <summary><c>null</c> = la revue entière, pas un numéro particulier.</summary>
+    public string? Numero { get; init; }
+
+    /// <summary>ISSN sous sa forme à tiret, la seule rangée en base.</summary>
+    public string? Issn { get; init; }
+
+    public string? Note { get; init; }
+
+    public required DateTime DateAjout { get; init; }
+
+    /// <summary>Titre suivi de son numéro, tel qu'on l'épelle à un kiosquier.</summary>
+    [JsonIgnore]
+    public string TitreComplet =>
+        string.IsNullOrWhiteSpace(Numero) ? Titre : $"{Titre} n° {Numero}";
+}
+
+/// <summary>Charge utile d'ajout ou de modification d'une envie de revue.</summary>
+/// <remarks>Sans identité : le propriétaire est déterminé par le serveur.</remarks>
+public record EnregistrementRevueSouhaitee
+{
+    public string Titre { get; set; } = string.Empty;
+
+    public string? Numero { get; set; }
+
+    public string? Issn { get; set; }
+
+    public string? Note { get; set; }
+}
+
 /// <summary>Charge utile du masquage personnel d'une œuvre bibliographique.</summary>
 public record MasquageBibliographie
 {

MaBibli.Shared/Entites/Livre.cs

@@ -37,6 +37,21 @@ public class Livre
     /// </remarks>
     public TypeDocument TypeDocument { get; set; }
 
+    /// <summary>
+    /// Nombre de pages, <b>facultatif</b>.
+    /// </summary>
+    /// <remarks>
+    /// ⚠️ <c>null</c> et non <c>0</c> : aucun livre déjà catalogué ne porte cette information,
+    /// et « 0 page » se lirait comme une donnée alors que c'est une absence. Même famille de
+    /// piège que <see cref="TypeDocument.NonPrecise"/>, dont le défaut ne prétend rien.
+    /// <para>
+    /// Il peut être proposé par la BnF (<c>dc:format</c> : « 1 vol. (349 p.) »), mais il reste
+    /// <b>modifiable</b> et n'est jamais imposé. Rien n'est déduit pour un ebook, dont la
+    /// pagination dépend de la police.
+    /// </para>
+    /// </remarks>
+    public int? NombrePages { get; set; }
+
     /// <summary>URL de la couverture (OpenLibrary), pas de fichier stocké localement.</summary>
     public string? CoverUrl { get; set; }
 

MaBibli.Shared/Entites/RevueSouhaitee.cs

@@ -0,0 +1,107 @@
+using MaBibli.Shared.Isbn;
+using MaBibli.Shared.Textes;
+
+namespace MaBibli.Shared.Entites;
+
+/// <summary>
+/// Une revue — ou un numéro précis — que l'on aimerait acquérir. <b>Personnelle</b>, comme
+/// <see cref="LivreSouhaite"/>.
+/// </summary>
+/// <remarks>
+/// <b>Pourquoi une table sœur plutôt que des colonnes de plus sur <see cref="LivreSouhaite"/> ?</b>
+/// Une envie de livre est identifiée par un couple (œuvre, auteur) : c'est ce que porte son index
+/// unique, et c'est ce qui permet de la rapprocher du catalogue. Un numéro de revue n'a
+/// <b>pas d'auteur</b> et se distingue par son <i>numéro</i> — deux notions que la clé de
+/// <c>LivreSouhaite</c> ne sait pas exprimer sans devenir fausse pour tout le monde. Y loger les
+/// revues aurait obligé à écrire « et qui n'est pas une revue » à chaque rapprochement, à chaque
+/// export et à chaque compteur : c'est exactement le raisonnement qui a séparé
+/// <see cref="Revue"/> de <see cref="Livre"/>.
+/// <para>
+/// ⚠️ <b>Le coût est assumé et il est réel</b> : deux tables se fusionnent à l'affichage, dans
+/// les deux exports et dans l'instantané hors-ligne. C'est là que le sujet se rate s'il est
+/// bâclé — une envie de revue invisible en librairie ne sert à rien.
+/// </para>
+/// <para>
+/// <see cref="Utilisateur"/> est une <b>frontière</b>, pas une trace : aucun point d'entrée
+/// n'accepte de nom d'utilisateur, et l'envie d'un autre répond 404, jamais 403.
+/// </para>
+/// </remarks>
+public class RevueSouhaitee
+{
+    public int Id { get; set; }
+
+    /// <summary>
+    /// <c>YNH_USER</c> du propriétaire de l'envie. <b>Frontière</b> : toute lecture filtre dessus.
+    /// </summary>
+    public string Utilisateur { get; set; } = string.Empty;
+
+    /// <summary>Titre de la revue (« Médor »), sans son numéro.</summary>
+    public string Titre { get; set; } = string.Empty;
+
+    /// <summary>Titre mis à plat. Sert au dédoublonnage.</summary>
+    /// <remarks>
+    /// ⚠️ <see cref="NormalisationTexte"/> et non <c>CleOeuvre</c> : le titre d'une revue n'a ni
+    /// mention de responsabilité ni sous-titre à couper, et « Médor : les yeux ouverts » est une
+    /// accroche qu'on ne tape pas. C'est la même règle que <see cref="Revue.TitreNormalise"/>.
+    /// </remarks>
+    public string TitreNormalise { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Numéro souhaité (« 43 », « hors-série 7 »), ou <c>null</c> pour la revue entière.
+    /// </summary>
+    /// <remarks>
+    /// Facultatif, et c'est la moitié du besoin : on souhaite parfois un numéro précis vu en
+    /// kiosque, parfois l'abonnement à un titre qu'on ne possède pas encore.
+    /// </remarks>
+    public string? Numero { get; set; }
+
+    /// <summary>
+    /// Numéro mis à plat. <b>Jamais <c>null</c></b> — chaîne vide pour « la revue entière ».
+    /// </summary>
+    /// <remarks>
+    /// ⚠️ Même piège que <see cref="LivreSouhaite.AuteurNormalise"/> : SQLite tient deux
+    /// <c>NULL</c> pour distincts, et l'unicité laisserait alors passer autant de fois « Médor,
+    /// pas de numéro » qu'on voudrait.
+    /// </remarks>
+    public string NumeroNormalise { get; set; } = string.Empty;
+
+    /// <summary>
+    /// ISSN, facultatif, <b>canonisé avec son tiret</b> (« 2466-6718 »).
+    /// </summary>
+    /// <remarks>
+    /// C'est la forme rangée en base pour tout le projet — seule exception à « la valeur stockée
+    /// reste nue », l'ISSN étant produit à tiret par le code-barres et interrogé à tiret par la
+    /// BnF. Sans canonisation, un ISSN tapé « 24666718 » ne se rapprocherait de rien.
+    /// </remarks>
+    public string? Issn { get; set; }
+
+    /// <summary>Note libre : « vu chez le dentiste », « demander au kiosque ».</summary>
+    public string? Note { get; set; }
+
+    public DateTime DateAjout { get; set; }
+
+    /// <summary>
+    /// Rang dans la section « revues » de la liste, du plus désiré au moins désiré.
+    /// </summary>
+    /// <remarks>
+    /// ⚠️ Cette numérotation est <b>indépendante</b> de celle de <see cref="LivreSouhaite.Rang"/> :
+    /// chaque table repart de zéro par utilisateur. C'est précisément pourquoi la liste affiche
+    /// deux sections plutôt qu'un seul classement entrelacé — deux suites de rangs sans rapport
+    /// mélangées produiraient un ordre que personne n'a choisi.
+    /// </remarks>
+    public int Rang { get; set; }
+
+    public void RecalculerFormes()
+    {
+        Titre = Titre.Trim();
+        TitreNormalise = NormalisationTexte.Normaliser(Titre);
+
+        Numero = string.IsNullOrWhiteSpace(Numero) ? null : Numero.Trim();
+        NumeroNormalise = Numero is null ? string.Empty : NormalisationTexte.Normaliser(Numero);
+
+        // Canonique() rend la saisie élaguée quand ce n'est pas un ISSN : un code mal recopié
+        // est conservé tel quel plutôt que jeté — le voir mal formé vaut mieux que le voir
+        // disparaître.
+        Issn = FormatageIssn.Canonique(Issn);
+    }
+}