Donne aux numéros de revue leur couverture et leur une, et un tiret à l'ISSN

L'ISSN est désormais rangé sous sa forme à tiret, et pas seulement affiché ainsi.
C'est le seul endroit où le projet s'écarte de « la valeur stockée reste nue »,
et il y a une raison : le code-barres produit déjà un ISSN à tiret, et la BnF
interroge `bib.issn` avec le tiret. Un ISSN tapé « 24666718 » ne se rapprochait
donc de rien, et le scan suivant créait une seconde fiche à côté. La canonisation
a lieu avant la recherche, pas seulement à l'écriture. Les champs de saisie, eux,
gardent la valeur tapée : découper à la frappe se battrait avec le curseur.

`ServiceRenormalisation` rattrape les ISSN existants — par un passage dédié, le
mécanisme générique confondant tous les NULL en une seule clé, alors que
l'unicité est ici un index partiel. Une fiche dont la forme canonique est déjà
prise garde la sienne : le serveur doit démarrer.

La couverture d'un numéro est une URL collée, jamais une photo : aucune source ne
peut la fournir, l'ISSN désignant la revue et non la parution, et le projet ne
stocke aucun fichier. Le garde du relais de couvertures a donc été étendu aux
numéros — l'oublier n'aurait produit aucune erreur visible, seulement une image
présente en ligne et absente hors-ligne.

Les articles à la une vivent dans une table à part et non dans `Theme` : un thème
est un vocabulaire qu'on réutilise, un titre d'article est unique à sa parution.
Rien ne se partage, donc pas de n-n — une simple clé étrangère vers le numéro.
Ils se saisissent au point-virgule seul : « Ukraine, deux ans après » serait
coupé en deux par la virgule.

Un PUT sur le numéro était indispensable : on note un numéro le jour où on le
range et on en recopie le sommaire plus tard. Sans lui, couverture et une
n'auraient existé qu'à la création, c'est-à-dire jamais.

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

MaBibli.Shared/Dtos/RevueDto.cs

@@ -1,3 +1,6 @@
+using System.Text.Json.Serialization;
+using MaBibli.Shared.Textes;
+
 namespace MaBibli.Shared.Dtos;
 
 /// <summary>
@@ -34,6 +37,12 @@ public record NumeroRevueDto
     public DateTime? DateParution { get; init; }
 
     public string? Note { get; init; }
+
+    /// <summary>Couverture du numéro, quand une URL a été collée. Aucune source ne la fournit.</summary>
+    public string? CoverUrl { get; init; }
+
+    /// <summary>Articles annoncés à la une, dans l'ordre de saisie.</summary>
+    public IReadOnlyList<string> Articles { get; init; } = [];
 }
 
 /// <summary>Charge utile de création ou de modification d'une revue.</summary>
@@ -46,7 +55,7 @@ public record EnregistrementRevue
     public string? Editeur { get; set; }
 }
 
-/// <summary>Charge utile d'ajout d'un numéro.</summary>
+/// <summary>Charge utile d'ajout ou de modification d'un numéro.</summary>
 public record AjoutNumeroRevue
 {
     /// <summary>Obligatoire : deux numéros sans numéro seraient indiscernables.</summary>
@@ -55,4 +64,28 @@ public record AjoutNumeroRevue
     public DateTime? DateParution { get; set; }
 
     public string? Note { get; set; }
+
+    /// <summary>
+    /// URL d'une image de couverture. <b>Aucune source ne peut la fournir</b> — l'ISSN désigne
+    /// la revue, pas la parution : elle est collée à la main, ou absente.
+    /// </summary>
+    public string? CoverUrl { get; set; }
+
+    /// <summary>Articles à la une, dans l'ordre de la couverture.</summary>
+    public List<string> Articles { get; set; } = [];
+
+    /// <summary>
+    /// Vue « une seule ligne » des <see cref="Articles"/>, pour un champ de saisie simple.
+    /// </summary>
+    /// <remarks>
+    /// ⚠️ Séparateur : le <b>point-virgule</b> seul, contrairement aux thèmes d'un livre. Un
+    /// titre d'article contient souvent une virgule (« Ukraine, deux ans après »), qui le
+    /// couperait en deux.
+    /// </remarks>
+    [JsonIgnore]
+    public string? ArticlesTexte
+    {
+        get => Articles.Count == 0 ? null : ListeSaisie.Joindre(Articles);
+        set => Articles = ListeSaisie.Decouper(value, virguleAussi: false);
+    }
 }

MaBibli.Shared/Entites/ArticleUne.cs

@@ -0,0 +1,51 @@
+using MaBibli.Shared.Textes;
+
+namespace MaBibli.Shared.Entites;
+
+/// <summary>
+/// Un article annoncé <b>à la une</b> d'un numéro de revue.
+/// </summary>
+/// <remarks>
+/// <b>Sur le NUMÉRO, jamais sur la revue</b> (tranché avec l'utilisateur le 2026-08-20) : les
+/// articles à la une changent à chaque parution. Posés sur <see cref="Revue"/>, ils décriraient
+/// une ligne éditoriale et non un sommaire.
+/// <para>
+/// <b>Pourquoi une table à part et non <see cref="Theme"/> ?</b> Un thème est un vocabulaire
+/// qu'on <i>réutilise</i> — « dark fantasy » revient sur dix livres —, alors qu'un titre
+/// d'article est unique à sa parution et ne se réutilisera jamais. Rangés dans
+/// <c>Themes</c>, « Ukraine : le front d'hiver » et ses semblables rempliraient de bruit un
+/// vocabulaire qui sert le catalogue.
+/// </para>
+/// <para>
+/// ⚠️ Conséquence directe : <b>pas de n-n</b>. Une simple clé étrangère vers le numéro suffit,
+/// puisque rien ne se partage. C'est ce qui distingue cette table de <c>LivreTheme</c>.
+/// </para>
+/// <para>
+/// ⚠️ La saisie se fait au <b>point-virgule</b>, et surtout pas à la virgule : un titre
+/// d'article en contient souvent (« Ukraine, deux ans après »), et elle le couperait en deux.
+/// Voir <see cref="ListeSaisie"/>.
+/// </para>
+/// </remarks>
+public class ArticleUne
+{
+    public int Id { get; set; }
+
+    public int NumeroRevueId { get; set; }
+
+    public NumeroRevue? NumeroRevue { get; set; }
+
+    /// <summary>Le titre tel qu'il est imprimé en couverture.</summary>
+    public string Titre { get; set; } = string.Empty;
+
+    /// <summary>Forme mise à plat, porteuse de l'unicité au sein du numéro.</summary>
+    public string TitreNormalise { get; set; } = string.Empty;
+
+    /// <summary>Rang d'affichage : l'ordre de saisie est celui de la couverture.</summary>
+    public int Position { get; set; }
+
+    public void RecalculerFormes()
+    {
+        Titre = Titre.Trim();
+        TitreNormalise = NormalisationTexte.Normaliser(Titre);
+    }
+}

MaBibli.Shared/Entites/Revue.cs

@@ -1,3 +1,4 @@
+using MaBibli.Shared.Isbn;
 using MaBibli.Shared.Textes;
 
 namespace MaBibli.Shared.Entites;
@@ -56,7 +57,10 @@ public class Revue
     {
         Titre = Titre.Trim();
         TitreNormalise = NormalisationTexte.Normaliser(Titre);
-        Issn = string.IsNullOrWhiteSpace(Issn) ? null : Issn.Trim();
+        // ⚠️ L'ISSN est rangé sous sa forme À TIRET, et ce n'est pas de la cosmétique : c'est
+        // celle que produit le code-barres (CodePeriodique.IssnDepuis) et celle qu'interroge
+        // bib.issn à la BnF. Un ISSN tapé « 24666718 » ne se serait rapproché de rien.
+        Issn = FormatageIssn.Canonique(Issn);
     }
 }
 
@@ -93,11 +97,31 @@ public class NumeroRevue
     /// <summary>Note libre : « dossier sur l'eau », « prêté à Paul », « acheté en gare ».</summary>
     public string? Note { get; set; }
 
+    /// <summary>
+    /// URL d'une image de couverture, collée à la main.
+    /// </summary>
+    /// <remarks>
+    /// ⚠️ <b>Aucune source ne peut la fournir</b>, contrairement aux livres : l'ISSN désigne la
+    /// <i>revue</i>, pas la parution, et OpenLibrary n'a donc rien à en dire. C'est pourquoi ce
+    /// champ n'est alimenté que par une URL saisie — et pourquoi l'écran n'en propose aucune.
+    /// <para>
+    /// ⚠️ Une image de numéro doit être <b>connue du relais</b>
+    /// (<c>GET /api/couvertures</c>) au même titre que celle d'un livre ou d'une envie, sans
+    /// quoi elle s'afficherait en ligne et jamais hors-ligne — exactement le défaut corrigé le
+    /// 2026-08-20 pour les hébergeurs sans CORS.
+    /// </para>
+    /// </remarks>
+    public string? CoverUrl { get; set; }
+
+    /// <summary>Articles annoncés à la une, dans l'ordre de saisie.</summary>
+    public List<ArticleUne> Articles { get; set; } = [];
+
     public DateTime DateAjout { get; set; }
 
     public void RecalculerFormes()
     {
         Numero = Numero.Trim();
         NumeroNormalise = NormalisationTexte.Normaliser(Numero);
+        CoverUrl = string.IsNullOrWhiteSpace(CoverUrl) ? null : CoverUrl.Trim();
     }
 }

MaBibli.Shared/Isbn/FormatageIssn.cs

@@ -0,0 +1,93 @@
+namespace MaBibli.Shared.Isbn;
+
+/// <summary>
+/// Mise en forme d'un ISSN : quatre chiffres, un tiret, quatre caractères (<c>2466-6718</c>).
+/// </summary>
+/// <remarks>
+/// <b>Bien plus simple que <see cref="FormatageIsbn"/></b>, et ce n'est pas un hasard : un ISSN
+/// se coupe <i>toujours</i> au même endroit, alors que les tranches d'un ISBN dépendent du
+/// groupe linguistique puis de l'éditeur. Il n'y a donc aucune table à embarquer, et aucune
+/// coupure ne peut être fausse.
+/// <para>
+/// ⚠️ <b>La forme à tiret est la forme canonique, y compris en base.</b> C'est le seul point où
+/// ce fichier s'écarte de la règle « la valeur stockée reste nue » tenue pour l'ISBN, et il y a
+/// une raison précise : <see cref="CodePeriodique.IssnDepuis"/> produit déjà un ISSN à tiret
+/// depuis le code-barres, et la BnF interroge <c>bib.issn</c> avec le tiret. Un ISSN saisi à la
+/// main sans tiret ne se serait donc rapproché de rien — ni de la revue déjà créée par un scan,
+/// ni d'une notice BnF.
+/// </para>
+/// <para>
+/// Les champs de <b>saisie</b> gardent en revanche ce que l'utilisateur tape : la canonisation a
+/// lieu à la validation, jamais à la frappe, sans quoi le tiret se battrait avec le curseur.
+/// </para>
+/// </remarks>
+public static class FormatageIssn
+{
+    /// <summary>Nombre de caractères d'un ISSN, tiret non compris.</summary>
+    private const int Longueur = 8;
+
+    /// <summary>
+    /// Les huit caractères de l'ISSN, sans tiret ni espace, ou <c>null</c> si la saisie n'en
+    /// est pas un.
+    /// </summary>
+    /// <remarks>
+    /// La dernière position peut valoir <c>X</c> : c'est une clé modulo 11, comme celle d'un
+    /// ISBN-10. Elle n'est <b>pas vérifiée</b> ici — un ISSN mal recopié doit pouvoir être
+    /// enregistré et corrigé, pas refusé au motif d'un chiffre.
+    /// </remarks>
+    public static string? Normaliser(string? saisie)
+    {
+        if (string.IsNullOrWhiteSpace(saisie))
+        {
+            return null;
+        }
+
+        Span<char> tampon = stackalloc char[Longueur];
+        var ecrits = 0;
+
+        foreach (var caractere in saisie)
+        {
+            if (char.IsWhiteSpace(caractere) || caractere is '-' or '–')
+            {
+                continue;
+            }
+
+            if (ecrits == Longueur)
+            {
+                return null;
+            }
+
+            var majuscule = char.ToUpperInvariant(caractere);
+            var valide = char.IsAsciiDigit(majuscule) || (majuscule == 'X' && ecrits == Longueur - 1);
+
+            if (!valide)
+            {
+                return null;
+            }
+
+            tampon[ecrits++] = majuscule;
+        }
+
+        return ecrits == Longueur ? new string(tampon) : null;
+    }
+
+    /// <summary>
+    /// Forme d'affichage à tiret. Une saisie qui n'est pas un ISSN est rendue <b>telle quelle</b> :
+    /// un code mal recopié doit se voir mal recopié, pas déguisé par un tiret.
+    /// </summary>
+    public static string? Afficher(string? valeur)
+    {
+        if (Normaliser(valeur) is not { } nu)
+        {
+            return valeur;
+        }
+
+        return $"{nu[..4]}-{nu[4..]}";
+    }
+
+    /// <summary>
+    /// Forme à ranger en base : le tiret quand c'est un ISSN, la saisie élaguée sinon.
+    /// </summary>
+    public static string? Canonique(string? valeur) =>
+        string.IsNullOrWhiteSpace(valeur) ? null : Afficher(valeur.Trim());
+}