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>
This commit is contained in:
mathieu
2026-08-19 00:14:01 +02:00
co-authored by Claude Opus 5
parent 2f1e854ea3
commit 5cf566bc33
44 changed files with 3857 additions and 213 deletions
+120 -1
View File
@@ -1,5 +1,7 @@
using MaBibli.Api.Services.Catalogue;
using MaBibli.Api.Services.Isbn;
using MaBibli.Shared.Dtos;
using MaBibli.Shared.Isbn;
namespace MaBibli.Tests;
@@ -172,4 +174,121 @@ public class BnfBibliographieParserTests
[InlineData(null, null)]
public void Extrait_une_annee_triable_des_dates_BnF(string? date, int? attendu) =>
Assert.Equal(attendu, ServiceBibliographie.AnneeTriable(date));
}
// ── Recherche par titre (liste d'envies) ─────────────────────────────────
/// <summary>
/// ⚠️ Le filtre de type est aussi indispensable ici qu'en bibliographie. Mesuré sur la
/// réponse réelle enregistrée : <c>bib.title all "la bête humaine"</c> croisé avec Zola
/// rend 20 notices, dont <b>12 films</b> de Jean Renoir, un manuscrit et un multimédia.
/// Sans filtre, la liste d'envies proposerait d'acheter un DVD.
/// </summary>
[Fact]
public void Recherche_par_titre_ecarte_ce_qui_nest_pas_un_livre()
{
var candidats = BnfBibliographieParser.ParserRecherche(
Fixture.Lire("bnf-titre-bete-humaine.xml"));
// 6 « texte imprimé » sur 20 notices : tout le reste est écarté.
Assert.Equal(6, candidats.Count);
Assert.All(candidats, c => Assert.Equal(SourceMetadonnees.Bnf, c.Source));
Assert.All(candidats, c => Assert.False(string.IsNullOrWhiteSpace(c.Titre)));
}
/// <summary>
/// La couverture vient de l'ISBN de la notice, la BnF n'en fournissant aucune. Une notice
/// sans ISBN — cas courant pour les éditions anciennes — n'en a simplement pas.
/// </summary>
[Fact]
public void Recherche_par_titre_remonte_ISBN_et_couverture_quand_la_notice_en_porte_un()
{
var candidats = BnfBibliographieParser.ParserRecherche(
Fixture.Lire("bnf-titre-bete-humaine.xml"));
var avecIsbn = candidats.Where(c => c.IsbnInterroge is not null).ToList();
Assert.NotEmpty(avecIsbn);
Assert.All(avecIsbn, c =>
{
Assert.True(IsbnUtils.EstValide(c.IsbnInterroge));
Assert.Equal(IsbnUtils.UrlCouverture(c.IsbnInterroge!), c.CoverUrl);
});
// Sans ISBN, pas de couverture inventée.
Assert.All(
candidats.Where(c => c.IsbnInterroge is null),
c => Assert.Null(c.CoverUrl));
}
/// <summary>
/// Contrairement à la bibliographie, <b>aucun post-filtre sur l'auteur</b> : c'est
/// l'utilisateur qui choisit dans la liste, en voyant les auteurs de chaque notice.
/// </summary>
/// <remarks>
/// Les deux notices vérifiées ici sont précisément celles que le post-filtre de
/// <see cref="BnfBibliographieParser.Parser"/> écarterait, et les garder est le bon choix
/// pour une liste d'envies :
/// <list type="bullet">
/// <item>la <b>bande dessinée signée Dobbs</b> — une adaptation de « La bête humaine » se
/// souhaite parfaitement, et son auteur est affiché, donc rien ne trompe ;</item>
/// <item>la notice <b>sans aucun <c>dc:creator</c></b>, qui n'aurait pu correspondre à
/// aucun auteur demandé.</item>
/// </list>
/// </remarks>
[Fact]
public void Recherche_par_titre_ne_post_filtre_pas_lauteur()
{
var candidats = BnfBibliographieParser.ParserRecherche(
Fixture.Lire("bnf-titre-bete-humaine.xml"));
Assert.Contains(candidats, c => c.Auteurs.Any(a => a.Contains("Dobbs")));
Assert.Contains(candidats, c => c.Auteurs.Count == 0);
}
// ── Motifs d'échec lisibles ──────────────────────────────────────────────
/// <summary>
/// ⚠️ Ces messages <b>atteignent l'utilisateur</b>. Ils ne doivent porter aucun nom de
/// classe .NET : « BnF injoignable (TaskCanceledException) » est ce qui s'affichait, et
/// « TaskCanceledException » ne veut rien dire pour qui range ses livres.
/// </summary>
[Theory]
[InlineData(EtatSourceBibliographie.DelaiDepasse)]
[InlineData(EtatSourceBibliographie.Injoignable)]
[InlineData(EtatSourceBibliographie.ReponseIllisible)]
public void Le_motif_dechec_est_ecrit_pour_un_humain(EtatSourceBibliographie etat)
{
var message = MotifEchec(etat);
Assert.Contains("Robert A. Harper", message);
Assert.DoesNotContain("Exception", message, StringComparison.OrdinalIgnoreCase);
Assert.DoesNotContain("Task", message, StringComparison.Ordinal);
Assert.DoesNotContain("Http", message, StringComparison.Ordinal);
}
/// <summary>
/// Le délai dépassé se retente, et le message doit le dire : c'est le seul des trois qui
/// appelle une action immédiate de l'utilisateur.
/// </summary>
[Fact]
public void Un_delai_depasse_invite_a_reessayer()
=> Assert.Contains("réessay", MotifEchec(EtatSourceBibliographie.DelaiDepasse),
StringComparison.OrdinalIgnoreCase);
/// <summary>Les trois motifs se distinguent : les confondre reviendrait à ne rien dire.</summary>
[Fact]
public void Les_trois_motifs_sont_distincts()
{
var motifs = new[]
{
EtatSourceBibliographie.DelaiDepasse,
EtatSourceBibliographie.Injoignable,
EtatSourceBibliographie.ReponseIllisible,
}.Select(MotifEchec).ToList();
Assert.Equal(motifs.Count, motifs.Distinct().Count());
}
private static string MotifEchec(EtatSourceBibliographie etat) =>
BnfClient.MotifDeSourceMuette(etat, "Robert A. Harper");
}