Traiter les retours d'usage du 2026-08-18 (2ᵉ série)

Six lots, issus d'IDEES.md. Les décisions actées sont reportées dans
CLAUDE.md, et les entrées traitées retirées d'IDEES.md.

1. Douchette USB, ISSN et enchaînement du scan
   - Champ ISBN focalisé à l'ouverture : c'est tout ce qu'exige une
     douchette USB, qui se présente au système comme un clavier. Remède
     au scan caméra, qui rate sur la webcam d'un PC (optique, pas
     décodage).
   - Un EAN en 977 est un périodique : il porte un ISSN, donc un titre de
     revue. Intercepté AVANT la validation ISBN (c'est un EAN-13
     parfaitement valide), l'ISSN est déduit du code puis nommé via
     bib.issn. Auparavant la cascade s'exécutait en entier pour finir sur
     « aucun résultat ».
   - L'enchaînement après scan existait déjà mais était invisible : une
     étape « Recherche » affiche désormais le code interrogé.

2. ISBN affichés avec des tirets
   Tables extraites du RangeMessage.xml officiel — plusieurs tranches ne
   sont pas celles qu'on suppose. Le francophone est découpé en entier,
   ailleurs on s'arrête au groupe et à la clé : aucune coupure fausse.
   Corrige au passage l'export CSV, où un ISBN nu était lu comme un
   nombre par Excel.

3. Hors-ligne : la liste d'envies
   ListerSouhaitsAsync était le seul point de lecture hors du dispositif
   hors-ligne, d'où le « 404 Not Found » brut à l'écran. Cinquième
   instantané, écritures refusées, plus aucun message HTTP. Même défaut
   corrigé sur la bibliographie.

4. Navigation par onglets
   Catalogue / Auteurs / Prêts / Envies dans MainLayout ; les barres
   d'actions ne portent plus que des actions. Filtres repliés derrière un
   bouton compteur, ligne « format » masquée quand le fonds n'a qu'un
   format. Une seule entrée d'ajout, désactivée hors-ligne — pas masquée.

5. Liste d'envies : ordre, recherche, couvertures
   Migration RangDesEnvies. Le remplissage reconduit l'ordre affiché
   jusqu'ici : sans lui, les listes existantes se seraient réordonnées
   toutes seules. Réordonnancement par flèches et glisser-déposer (le
   drag & drop HTML5 ne marche pas au doigt). Ajout dans son propre
   écran, avec recherche par titre (bib.title) et couvertures enfin
   alimentées.

6. Bibliographie : une source muette n'est pas une liste vide
   L'écran affichait « BnF injoignable » PUIS « la BnF ne connaît aucun
   livre de cet auteur » — la seconde phrase étant fausse. Les deux cas
   s'excluent désormais, et un bouton Réessayer est offert.

   Vérifié en exécution : le diagnostic d'IDEES.md était faux sur un
   point. Robert A. Harper a bien 7 œuvres à la BnF (85 notices
   annoncées) ; c'était le même délai dépassé observé deux fois, pris
   pour deux causes distinctes.

380 tests, dont un qui applique réellement la migration (EnsureCreated
n'en joue aucune) et un qui verrouille les messages atteignant
l'utilisateur.

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

MaBibli.Client/Pages/AjoutIsbn.razor

@@ -12,6 +12,7 @@
 {
     <p class="message-discret">
         Scannez le code-barres, ou saisissez l'ISBN imprimé sur le livre.
+        Une douchette USB fonctionne telle quelle : le champ est déjà actif.
     </p>
 
     @*
@@ -27,8 +28,17 @@
         </p>
     }
 
+    @*
+        Le champ est focalisé à l'ouverture et valide sur Entrée : c'est tout ce qu'exige une
+        douchette USB, qui se présente au système comme un CLAVIER — elle « tape » les chiffres
+        puis Entrée. Aucune permission, aucun HTTPS, aucun décodage : c'est le contournement le
+        plus rentable du scan caméra, qui rate souvent sur la webcam d'un PC.
+        La recherche n'est délibérément PAS déclenchée à chaque frappe : une douchette tape trop
+        vite, et chaque caractère partirait en requête.
+    *@
     <div class="barre-recherche">
         <input class="champ-saisie" type="text" inputmode="numeric" placeholder="978…"
+               @ref="_champIsbn"
                @bind="_isbn" @bind:event="oninput" @onkeydown="SurTouche"
                aria-label="ISBN" autocomplete="off" />
     </div>
@@ -51,6 +61,18 @@
     </div>
 }
 
+@*
+    Le scan enchaîne la recherche tout seul (décision actée). Encore faut-il que ça SE VOIE :
+    sans cet écran, on retombait sur la saisie avec un bouton « Chercher » intact, et l'on
+    croyait que le scan n'avait rien déclenché.
+*@
+@if (_etape == Etape.Recherche)
+{
+    <p class="message-discret" role="status">
+        Recherche de <span class="code-isbn">@FormatageIsbn.Afficher(_isbn)</span> à la BnF, puis chez OpenLibrary…
+    </p>
+}
+
 @if (_etape == Etape.Scan)
 {
     <ScannerCodeBarres OnCodeDetecte="SurCodeDetecteAsync" OnAnnuler="Recommencer" />
@@ -61,6 +83,11 @@
     <p class="message-erreur" role="alert">@_erreur</p>
 }
 
+@if (_messagePeriodique is not null)
+{
+    <p class="message-avertissement" role="status">@_messagePeriodique</p>
+}
+
 @foreach (var avertissement in _avertissements)
 {
     <p class="message-avertissement">@avertissement</p>
@@ -98,7 +125,7 @@
                         <span class="etiquette">@candidat.Source</span>
                         @if (!string.IsNullOrWhiteSpace(candidat.IsbnInterroge))
                         {
-                            <span>trouvé via @candidat.IsbnInterroge</span>
+                            <span>trouvé via <span class="code-isbn">@FormatageIsbn.Afficher(candidat.IsbnInterroge)</span></span>
                         }
                     </p>
 
@@ -132,10 +159,17 @@
 }
 
 @code {
-    private enum Etape { Saisie, Scan, Choix, Formulaire }
+    private enum Etape { Saisie, Scan, Recherche, Choix, Formulaire }
 
     private Etape _etape = Etape.Saisie;
     private string _isbn = string.Empty;
+    private ElementReference _champIsbn;
+
+    // Le focus ne se redonne qu'une fois par entrée dans l'étape de saisie : le reprendre à
+    // chaque rendu arracherait le curseur à l'utilisateur en pleine frappe.
+    private bool _focusAFaire = true;
+
+    private string? _messagePeriodique;
     private bool _chargement;
     private bool _enregistrement;
     private string? _erreur;
@@ -146,6 +180,33 @@
 
     protected override void OnInitialized() => Reseau.Change += SurChangementReseau;
 
+    /// <summary>
+    /// Donne le focus au champ ISBN dès que l'étape de saisie s'affiche.
+    /// </summary>
+    /// <remarks>
+    /// C'est ce qui rend une <b>douchette USB</b> utilisable sans rien d'autre : elle tape dans
+    /// le champ actif, quel qu'il soit. Sans focus automatique, l'utilisateur devrait cliquer
+    /// dans le champ avant chaque livre — et le gain sur le scan caméra disparaîtrait.
+    /// </remarks>
+    protected override async Task OnAfterRenderAsync(bool premierRendu)
+    {
+        if (_etape != Etape.Saisie || !_focusAFaire)
+        {
+            return;
+        }
+
+        _focusAFaire = false;
+
+        try
+        {
+            await _champIsbn.FocusAsync();
+        }
+        catch (InvalidOperationException)
+        {
+            // L'élément a disparu entre le rendu et l'appel (navigation rapide) : sans intérêt.
+        }
+    }
+
     private void SurChangementReseau() => _ = InvokeAsync(StateHasChanged);
 
     public void Dispose() => Reseau.Change -= SurChangementReseau;
@@ -156,16 +217,17 @@
     private void OuvrirScanner()
     {
         _erreur = null;
+        _messagePeriodique = null;
         _avertissements = [];
         _etape = Etape.Scan;
     }
 
     // Le scan enchaîne directement sur le flux de lookup existant : l'utilisateur
-    // ne retape jamais ce qui vient d'être scanné.
+    // ne retape jamais ce qui vient d'être scanné, et n'a aucun bouton à confirmer.
+    // Le code lu reste dans le champ : si le décodage était mauvais, il se corrige et se relance.
     private async Task SurCodeDetecteAsync(string isbn)
     {
         _isbn = isbn;
-        _etape = Etape.Saisie;
         await ChercherAsync();
     }
 
@@ -181,7 +243,9 @@
     {
         _chargement = true;
         _erreur = null;
+        _messagePeriodique = null;
         _avertissements = [];
+        _etape = Etape.Recherche;
 
         try
         {
@@ -190,12 +254,21 @@
             if (resultat is null)
             {
                 _erreur = $"« {_isbn} » n'est pas un ISBN valide.";
+                RevenirALaSaisie();
                 return;
             }
 
             _avertissements = resultat.Avertissements;
             _candidats = resultat.Candidats;
 
+            // Un code de périodique (977) n'a JAMAIS de candidat : ce n'est pas un échec de
+            // recherche, c'est un code qui ne décrit pas un livre. Le dire avant tout le reste.
+            if (resultat.Periodique is { } revue)
+            {
+                DecrireLeMagazine(revue);
+                return;
+            }
+
             if (_candidats.Count == 0)
             {
                 // Aucune notice : on ne bloque pas, le formulaire manuel reste la porte de sortie.
@@ -213,9 +286,12 @@
 
             _etape = Etape.Choix;
         }
-        catch (Exception ex)
+        catch (Exception)
         {
-            _erreur = $"La recherche a échoué : {ex.Message}";
+            _erreur = Reseau.EnLigne
+                ? "La recherche a échoué. Réessayez, ou saisissez la fiche à la main."
+                : "La recherche par ISBN interroge la BnF et OpenLibrary : indisponible hors ligne.";
+            RevenirALaSaisie();
         }
         finally
         {
@@ -223,6 +299,43 @@
         }
     }
 
+    /// <summary>
+    /// Dit ce qu'est le code scanné, puis bascule sur la saisie manuelle.
+    /// </summary>
+    /// <remarks>
+    /// MaBibli ne gère pas les périodiques : ni numéro, ni date de parution. Le titre est
+    /// pré-rempli, mais <b>pas l'ISBN</b> — le code-barres d'une revue n'en est pas un, et le
+    /// ranger dans <c>Livre.Isbn</c> ferait échouer tout lookup ultérieur sur cette fiche.
+    /// </remarks>
+    private void DecrireLeMagazine(PeriodiqueDetecte revue)
+    {
+        var nom = revue.Titre is null ? "un magazine" : $"le magazine « {revue.Titre} »";
+
+        _messagePeriodique =
+            $"Ce code-barres désigne {nom} (ISSN {revue.Issn}), pas un livre : "
+            + "il commence par 977, réservé aux publications en série. "
+            + "MaBibli ne gère pas les revues — vous pouvez tout de même créer une fiche à la main, "
+            + "sans ISBN.";
+
+        _saisie = new EnregistrementLivre
+        {
+            Titre = revue.Titre ?? string.Empty,
+            Editeur = revue.Editeur,
+            Format = Format.Physique,
+            Statut = Statut.ALire,
+        };
+
+        _erreur = null;
+        _etape = Etape.Formulaire;
+    }
+
+    /// <summary>Ramène l'écran à la saisie, champ ISBN de nouveau actif pour la douchette.</summary>
+    private void RevenirALaSaisie()
+    {
+        _etape = Etape.Saisie;
+        _focusAFaire = true;
+    }
+
     private void Choisir(CandidatLivre candidat)
     {
         _saisie = new EnregistrementLivre
@@ -242,10 +355,11 @@
 
     private void Recommencer()
     {
-        _etape = Etape.Saisie;
         _erreur = null;
+        _messagePeriodique = null;
         _erreurFormulaire = null;
         _candidats = [];
+        RevenirALaSaisie();
     }
 
     private async Task EnregistrerAsync()