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.Api/Services/Couvertures/ServiceCouvertures.cs

@@ -35,7 +35,8 @@ public interface IServiceCouvertures
 /// </para>
 /// <list type="number">
 /// <item>
-/// <b>L'URL doit déjà exister en base</b> comme couverture d'un livre ou d'une envie. Le proxy
+/// <b>L'URL doit déjà exister en base</b> comme couverture d'un livre, d'une envie ou d'un
+/// numéro de revue. Le proxy
 /// ne va donc jamais chercher une URL choisie au moment de l'appel : seulement une valeur que
 /// l'application détient déjà.
 /// </item>
@@ -115,9 +116,16 @@ public sealed class ServiceCouvertures(HttpClient http, MaBibliDbContext db) : I
     /// L'URL est-elle déjà enregistrée comme couverture ? Comparaison <b>exacte</b> : c'est la
     /// valeur stockée qui autorise, pas une ressemblance.
     /// </summary>
+    /// <remarks>
+    /// ⚠️ <b>Les numéros de revue en font partie</b> depuis qu'ils portent une couverture. Les
+    /// oublier ici aurait produit exactement le défaut que ce service existe pour corriger :
+    /// une image qui s'affiche en ligne et jamais hors-ligne, l'appel de mise en cache étant
+    /// refusé par le relais.
+    /// </remarks>
     private async Task<bool> EstConnueAsync(string url, CancellationToken ct) =>
         await db.Livres.AnyAsync(l => l.CoverUrl == url, ct)
-        || await db.LivresSouhaites.AnyAsync(s => s.CoverUrl == url, ct);
+        || await db.LivresSouhaites.AnyAsync(s => s.CoverUrl == url, ct)
+        || await db.NumerosRevue.AnyAsync(n => n.CoverUrl == url, ct);
 
     /// <summary>
     /// Lit au plus <see cref="TailleMaximale"/> octets, et rend <c>null</c> si le corps dépasse.

MaBibli.Api/Services/Revues/ServiceRevues.cs

@@ -1,6 +1,7 @@
 using MaBibli.Api.Data;
 using MaBibli.Shared.Dtos;
 using MaBibli.Shared.Entites;
+using MaBibli.Shared.Isbn;
 using MaBibli.Shared.Textes;
 using Microsoft.EntityFrameworkCore;
 
@@ -36,6 +37,18 @@ public interface IServiceRevues
     Task<ResultatRevue> AjouterNumeroAsync(
         int revueId, AjoutNumeroRevue saisie, CancellationToken ct = default);
 
+    /// <summary>
+    /// Modifie un numéro déjà recensé : son numéro, sa parution, sa note, sa couverture et ses
+    /// articles à la une.
+    /// </summary>
+    /// <remarks>
+    /// Sans ce point d'entrée, la couverture et les articles ne se seraient saisis qu'à la
+    /// création — c'est-à-dire jamais, puisqu'on ajoute un numéro le jour où on l'achète et
+    /// qu'on en recopie la une plus tard.
+    /// </remarks>
+    Task<ResultatRevue> ModifierNumeroAsync(
+        int numeroId, AjoutNumeroRevue saisie, CancellationToken ct = default);
+
     Task<bool> RetirerNumeroAsync(int numeroId, CancellationToken ct = default);
 }
 
@@ -57,7 +70,7 @@ public sealed class ServiceRevues(MaBibliDbContext db) : IServiceRevues
     {
         var revues = await db.Revues
             .AsNoTracking()
-            .Include(r => r.Numeros)
+            .Include(r => r.Numeros).ThenInclude(n => n.Articles)
             .OrderBy(r => r.TitreNormalise)
             .ToListAsync(ct);
 
@@ -73,7 +86,10 @@ public sealed class ServiceRevues(MaBibliDbContext db) : IServiceRevues
             return ResultatRevue.Invalide("Le titre de la revue est obligatoire.");
         }
 
-        var issn = Vide(saisie.Issn);
+        // ⚠️ Canonisé AVANT la recherche, pas seulement à l'écriture : « 24666718 » et
+        // « 2466-6718 » désignent la même revue, et sans cela le scan suivant en créerait une
+        // seconde à côté de celle saisie à la main.
+        var issn = FormatageIssn.Canonique(saisie.Issn);
         var normalise = NormalisationTexte.Normaliser(titre);
 
         // ⚠️ « Créer OU retrouver » et non « créer » : le flux du code-barres 977 rescanne
@@ -81,7 +97,7 @@ public sealed class ServiceRevues(MaBibliDbContext db) : IServiceRevues
         // à comprendre qu'il doit aller chercher la fiche lui-même — alors que le geste est
         // toujours le même : « voici un numéro de plus ».
         var existante = await db.Revues
-            .Include(r => r.Numeros)
+            .Include(r => r.Numeros).ThenInclude(n => n.Articles)
             .FirstOrDefaultAsync(
                 r => (issn != null && r.Issn == issn) || r.TitreNormalise == normalise, ct);
 
@@ -117,7 +133,7 @@ public sealed class ServiceRevues(MaBibliDbContext db) : IServiceRevues
     public async Task<ResultatRevue> ModifierAsync(
         int id, EnregistrementRevue saisie, CancellationToken ct = default)
     {
-        var revue = await db.Revues.Include(r => r.Numeros).FirstOrDefaultAsync(r => r.Id == id, ct);
+        var revue = await db.Revues.Include(r => r.Numeros).ThenInclude(n => n.Articles).FirstOrDefaultAsync(r => r.Id == id, ct);
         if (revue is null)
         {
             return ResultatRevue.Introuvable;
@@ -135,7 +151,7 @@ public sealed class ServiceRevues(MaBibliDbContext db) : IServiceRevues
             return ResultatRevue.Invalide($"La revue « {titre} » existe déjà.");
         }
 
-        var issn = Vide(saisie.Issn);
+        var issn = FormatageIssn.Canonique(saisie.Issn);
         if (issn is not null && await db.Revues.AnyAsync(r => r.Id != id && r.Issn == issn, ct))
         {
             return ResultatRevue.Invalide($"L'ISSN {issn} est déjà celui d'une autre revue.");
@@ -168,7 +184,7 @@ public sealed class ServiceRevues(MaBibliDbContext db) : IServiceRevues
     public async Task<ResultatRevue> AjouterNumeroAsync(
         int revueId, AjoutNumeroRevue saisie, CancellationToken ct = default)
     {
-        var revue = await db.Revues.Include(r => r.Numeros).FirstOrDefaultAsync(r => r.Id == revueId, ct);
+        var revue = await db.Revues.Include(r => r.Numeros).ThenInclude(n => n.Articles).FirstOrDefaultAsync(r => r.Id == revueId, ct);
         if (revue is null)
         {
             return ResultatRevue.Introuvable;
@@ -199,19 +215,104 @@ public sealed class ServiceRevues(MaBibliDbContext db) : IServiceRevues
             Numero = numero,
             DateParution = saisie.DateParution,
             Note = Vide(saisie.Note),
+            CoverUrl = Vide(saisie.CoverUrl),
             DateAjout = DateTime.UtcNow,
         };
 
         ligne.RecalculerFormes();
+        RemplacerArticles(ligne, saisie.Articles);
         db.NumerosRevue.Add(ligne);
         await db.SaveChangesAsync(ct);
 
-        var relue = await db.Revues.AsNoTracking().Include(r => r.Numeros)
+        var relue = await db.Revues.AsNoTracking().Include(r => r.Numeros).ThenInclude(n => n.Articles)
             .FirstAsync(r => r.Id == revueId, ct);
 
         return ResultatRevue.Ok(Projeter(relue));
     }
 
+    public async Task<ResultatRevue> ModifierNumeroAsync(
+        int numeroId, AjoutNumeroRevue saisie, CancellationToken ct = default)
+    {
+        var ligne = await db.NumerosRevue
+            .Include(n => n.Articles)
+            .FirstOrDefaultAsync(n => n.Id == numeroId, ct);
+
+        if (ligne is null)
+        {
+            return ResultatRevue.Introuvable;
+        }
+
+        var numero = saisie.Numero?.Trim();
+        if (string.IsNullOrWhiteSpace(numero))
+        {
+            return ResultatRevue.Invalide("Le numéro est obligatoire.");
+        }
+
+        var normalise = NormalisationTexte.Normaliser(numero);
+        if (await db.NumerosRevue.AnyAsync(
+                n => n.Id != numeroId && n.RevueId == ligne.RevueId && n.NumeroNormalise == normalise, ct))
+        {
+            return ResultatRevue.Invalide($"Le numéro {numero} est déjà dans votre collection.");
+        }
+
+        if (saisie.DateParution is { } parution && parution.Date > DateTime.UtcNow.Date.AddDays(1))
+        {
+            return ResultatRevue.Invalide("La date de parution ne peut pas être dans le futur.");
+        }
+
+        ligne.Numero = numero;
+        ligne.DateParution = saisie.DateParution;
+        ligne.Note = Vide(saisie.Note);
+        ligne.CoverUrl = Vide(saisie.CoverUrl);
+        ligne.RecalculerFormes();
+        RemplacerArticles(ligne, saisie.Articles);
+
+        await db.SaveChangesAsync(ct);
+
+        var relue = await db.Revues.AsNoTracking().Include(r => r.Numeros).ThenInclude(n => n.Articles)
+            .FirstAsync(r => r.Id == ligne.RevueId, ct);
+
+        return ResultatRevue.Ok(Projeter(relue));
+    }
+
+    /// <summary>
+    /// Remplace les articles à la une du numéro par ceux de la saisie.
+    /// </summary>
+    /// <remarks>
+    /// ⚠️ Remplacement et non fusion : la ligne de saisie <b>est</b> la liste. Un titre effacé
+    /// du champ doit disparaître, comme pour les thèmes d'un livre.
+    /// <para>
+    /// Le dédoublonnage a déjà eu lieu à la saisie (<c>ListeSaisie</c>), mais il est refait ici
+    /// sur la forme normalisée : c'est l'unicité <c>(NumeroRevueId, TitreNormalise)</c> qui est
+    /// en jeu, et un appel direct à l'API n'est pas passé par le champ texte.
+    /// </para>
+    /// </remarks>
+    private void RemplacerArticles(NumeroRevue numero, IReadOnlyList<string>? titres)
+    {
+        if (numero.Articles.Count > 0)
+        {
+            db.ArticlesUne.RemoveRange(numero.Articles);
+            numero.Articles.Clear();
+        }
+
+        var vus = new HashSet<string>(StringComparer.Ordinal);
+        var position = 0;
+
+        foreach (var titre in titres ?? [])
+        {
+            var article = new ArticleUne { NumeroRevue = numero, Titre = titre ?? string.Empty };
+            article.RecalculerFormes();
+
+            if (article.TitreNormalise.Length == 0 || !vus.Add(article.TitreNormalise))
+            {
+                continue;
+            }
+
+            article.Position = position++;
+            numero.Articles.Add(article);
+        }
+    }
+
     public async Task<bool> RetirerNumeroAsync(int numeroId, CancellationToken ct = default)
     {
         var numero = await db.NumerosRevue.FirstOrDefaultAsync(n => n.Id == numeroId, ct);
@@ -249,6 +350,12 @@ public sealed class ServiceRevues(MaBibliDbContext db) : IServiceRevues
                 Numero = n.Numero,
                 DateParution = n.DateParution,
                 Note = n.Note,
+                CoverUrl = n.CoverUrl,
+                Articles = n.Articles
+                    .OrderBy(a => a.Position)
+                    .ThenBy(a => a.Id)
+                    .Select(a => a.Titre)
+                    .ToList(),
             })
             .ToList(),
     };