mathieu/mabibli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files
MaBibli.Tests/ServiceSouhaitsTests.cs
+230 -5
View File
@@ -52,6 +52,119 @@ public class ServiceSouhaitsTests : IDisposable
new EnregistrementSouhait { Titre = titre, Auteur = auteur, Isbn = isbn, Note = note },
utilisateur);
// ── Ordre choisi à la main ───────────────────────────────────────────────
private async Task<IReadOnlyList<string>> TitresAsync(string utilisateur = Mathieu) =>
(await _souhaits.ListerAsync(utilisateur)).Select(s => s.Titre).ToList();
/// <summary>
/// L'ordre d'affichage est celui de la liste, pas l'alphabet : classer une liste d'envies
/// par titre répondait à une question que personne ne se pose.
/// </summary>
[Fact]
public async Task Les_envies_sortent_dans_lordre_dajout_par_defaut()
{
await AjouterAsync("Zèbre", auteur: "Zoé Zed");
await AjouterAsync("Abricot", auteur: "Anne Alpha");
Assert.Equal(["Zèbre", "Abricot"], await TitresAsync());
}
[Fact]
public async Task Une_envie_nouvelle_se_pose_en_fin_de_liste()
{
await AjouterAsync("Premier");
await AjouterAsync("Deuxième");
await AjouterAsync("Troisième");
Assert.Equal(["Premier", "Deuxième", "Troisième"], await TitresAsync());
}
[Fact]
public async Task Reordonner_fixe_lordre_demande()
{
var a = (await AjouterAsync("Premier")).Souhait!.Id;
var b = (await AjouterAsync("Deuxième")).Souhait!.Id;
var c = (await AjouterAsync("Troisième")).Souhait!.Id;
Assert.True(await _souhaits.ReordonnerAsync([c, a, b], Mathieu));
Assert.Equal(["Troisième", "Premier", "Deuxième"], await TitresAsync());
}
/// <summary>Réenvoyer le même ordre ne doit rien bouger.</summary>
[Fact]
public async Task Reordonner_est_idempotent()
{
var a = (await AjouterAsync("Premier")).Souhait!.Id;
var b = (await AjouterAsync("Deuxième")).Souhait!.Id;
await _souhaits.ReordonnerAsync([b, a], Mathieu);
await _souhaits.ReordonnerAsync([b, a], Mathieu);
Assert.Equal(["Deuxième", "Premier"], await TitresAsync());
}
/// <summary>
/// ⚠️ Le cas qui perdrait des données : la liste du client est périmée (une envie ajoutée
/// depuis un autre appareil n'y figure pas). L'absente doit <b>survivre</b>, rangée à la
/// suite — mal classée vaut infiniment mieux que disparue.
/// </summary>
[Fact]
public async Task Une_envie_absente_de_lordre_envoye_est_conservee()
{
var a = (await AjouterAsync("Premier")).Souhait!.Id;
var b = (await AjouterAsync("Deuxième")).Souhait!.Id;
await AjouterAsync("Ajoutée ailleurs");
await _souhaits.ReordonnerAsync([b, a], Mathieu);
Assert.Equal(["Deuxième", "Premier", "Ajoutée ailleurs"], await TitresAsync());
}
/// <summary>
/// ⚠️ L'invariant de la table : réordonner ne doit pas offrir un moyen détourné de toucher
/// à la liste de quelqu'un d'autre en devinant un identifiant.
/// </summary>
[Fact]
public async Task Reordonner_ne_touche_jamais_la_liste_dun_autre()
{
var sienne = (await AjouterAsync("À Camille", utilisateur: Camille)).Souhait!.Id;
var a = (await AjouterAsync("Premier", utilisateur: Mathieu)).Souhait!.Id;
var b = (await AjouterAsync("Deuxième", utilisateur: Mathieu)).Souhait!.Id;
// Mathieu glisse l'identifiant de Camille en tête de SA demande.
await _souhaits.ReordonnerAsync([sienne, b, a], Mathieu);
Assert.Equal(["Deuxième", "Premier"], await TitresAsync(Mathieu));
Assert.Equal(["À Camille"], await TitresAsync(Camille));
}
[Fact]
public async Task Reordonner_sans_identite_ne_fait_rien()
{
await AjouterAsync("Premier");
Assert.False(await _souhaits.ReordonnerAsync([1], null));
}
/// <summary>
/// Supprimer laisse des trous dans les rangs ; ils ne doivent pas déranger l'ordre, et le
/// prochain ajout doit tout de même atterrir en dernier.
/// </summary>
[Fact]
public async Task Une_suppression_ne_desordonne_pas_la_liste()
{
await AjouterAsync("Premier");
var b = (await AjouterAsync("Deuxième")).Souhait!.Id;
await AjouterAsync("Troisième");
Assert.True(await _souhaits.SupprimerAsync(b, Mathieu));
await AjouterAsync("Quatrième");
Assert.Equal(["Premier", "Troisième", "Quatrième"], await TitresAsync());
}
// ── Portée personnelle ───────────────────────────────────────────────────
[Fact]
@@ -189,18 +302,28 @@ public class ServiceSouhaitsTests : IDisposable
Assert.Null(resultat.Souhait!.Isbn);
}
/// <summary>
/// ⚠️ <b>Contrat changé le 2026-08-18</b> : la liste était classée par auteur puis titre,
/// elle suit désormais le <b>rang choisi par son propriétaire</b>. L'alphabet répondait à
/// une question que personne ne se pose devant une liste d'envies ; « qu'est-ce que je veux
/// le plus ? » en est une.
/// <para>
/// L'ancien ordre n'est pas perdu pour autant : la migration <c>RangDesEnvies</c> le
/// reconduit dans les rangs initiaux, pour que les listes existantes ne se réordonnent pas
/// toutes seules. C'est <c>MigrationRangDesEnviesTests</c> qui le vérifie.
/// </para>
/// </summary>
[Fact]
public async Task La_liste_est_ordonnee_par_auteur_puis_titre()
public async Task La_liste_ne_se_classe_plus_par_ordre_alphabetique()
{
await AjouterAsync("Les fourmis", "Bernard Werber");
await AjouterAsync("Sans auteur", null);
await AjouterAsync("Germinal", "Émile Zola");
await AjouterAsync("Demain les chats", "Bernard Werber");
var titres = (await _souhaits.ListerAsync(Mathieu)).Select(s => s.Titre).ToList();
// Werber avant Zola, ses titres classés entre eux, et l'envie sans auteur en dernier.
Assert.Equal(["Demain les chats", "Les fourmis", "Germinal", "Sans auteur"], titres);
Assert.Equal(
["Les fourmis", "Sans auteur", "Germinal", "Demain les chats"],
await TitresAsync());
}
[Fact]
@@ -226,6 +349,108 @@ public class ServiceSouhaitsTests : IDisposable
public Task<(ResultatBibliographie, string?)> RechercherParAuteurAsync(
string auteur, CancellationToken ct = default) =>
Task.FromResult((BnfBibliographieParser.Parser(xml, auteur), (string?)null));
/// <summary>Les périodiques n'interviennent pas dans la bibliographie par auteur.</summary>
public Task<(PeriodiqueDetecte?, string?)> RechercherPeriodiqueAsync(
string issn, CancellationToken ct = default) =>
Task.FromResult(((PeriodiqueDetecte?)null, (string?)null));
/// <summary>Recherche par titre : couverte par ses propres tests.</summary>
public Task<(IReadOnlyList<CandidatLivre>, string?)> RechercherParTitreAsync(
string titre, string? auteur, CancellationToken ct = default) =>
Task.FromResult(((IReadOnlyList<CandidatLivre>)[], (string?)null));
}
/// <summary>
/// Client BnF qui <b>ne répond pas</b> : c'est le cas « Robert A. Harper » remonté en usage.
/// </summary>
private sealed class BnfMuetFake(EtatSourceBibliographie etat, string message) : IBnfClient
{
public Task<(IReadOnlyList<CandidatLivre>, string?)> RechercherAsync(
string isbn, string? urlCouverture, CancellationToken ct = default) =>
Task.FromResult(((IReadOnlyList<CandidatLivre>)[], (string?)null));
public Task<(ResultatBibliographie, string?)> RechercherParAuteurAsync(
string auteur, CancellationToken ct = default) =>
Task.FromResult((new ResultatBibliographie { Etat = etat }, (string?)message));
public Task<(PeriodiqueDetecte?, string?)> RechercherPeriodiqueAsync(
string issn, CancellationToken ct = default) =>
Task.FromResult(((PeriodiqueDetecte?)null, (string?)null));
public Task<(IReadOnlyList<CandidatLivre>, string?)> RechercherParTitreAsync(
string titre, string? auteur, CancellationToken ct = default) =>
Task.FromResult(((IReadOnlyList<CandidatLivre>)[], (string?)null));
}
/// <summary>
/// ⚠️ <b>Le défaut que ce lot corrige.</b> Une BnF muette rend une liste vide, exactement
/// comme un auteur réellement absent de son catalogue. Sans <c>SourceMuette</c>, l'écran
/// affirmait « la BnF ne connaît aucun livre de cet auteur » à propos d'une question qu'il
/// n'avait pas pu poser.
/// </summary>
[Theory]
[InlineData(EtatSourceBibliographie.DelaiDepasse)]
[InlineData(EtatSourceBibliographie.Injoignable)]
[InlineData(EtatSourceBibliographie.ReponseIllisible)]
public async Task Une_BnF_muette_ne_se_confond_pas_avec_un_auteur_sans_oeuvre(
EtatSourceBibliographie etat)
{
var biblio = await BibliographieAsync(new BnfMuetFake(etat, "La BnF n'a pas répondu."));
Assert.Empty(biblio.Oeuvres);
Assert.True(biblio.SourceMuette);
Assert.Equal(etat, biblio.Etat);
Assert.NotNull(biblio.Avertissement);
}
/// <summary>
/// Le pendant : la BnF <b>a</b> répondu, elle ne connaît simplement rien. Là, et là
/// seulement, l'écran a le droit d'expliquer l'absence.
/// </summary>
[Fact]
public async Task Une_BnF_qui_repond_sans_rien_connaitre_nest_pas_muette()
{
var biblio = await BibliographieAsync(new BnfBibliographieFake(ReponseVide));
Assert.Empty(biblio.Oeuvres);
Assert.False(biblio.SourceMuette);
Assert.Equal(EtatSourceBibliographie.Ok, biblio.Etat);
Assert.Null(biblio.Avertissement);
}
/// <summary>Une bibliographie qui a abouti n'est jamais signalée comme muette.</summary>
[Fact]
public async Task Une_bibliographie_obtenue_nest_pas_muette()
{
var biblio = await BibliographieAsync(
new BnfBibliographieFake(Fixture.Lire("bnf-auteur-werber.xml")));
Assert.NotEmpty(biblio.Oeuvres);
Assert.False(biblio.SourceMuette);
}
private const string ReponseVide = """
<srw:searchRetrieveResponse xmlns:srw="http://www.loc.gov/zing/srw/">
<srw:numberOfRecords>0</srw:numberOfRecords>
</srw:searchRetrieveResponse>
""";
/// <summary>Bibliographie de Werber avec le client BnF fourni : seule la source varie.</summary>
/// <summary>
/// Bibliographie de Werber avec le client BnF fourni : <b>seule la source varie</b>.
/// L'auteur doit exister au catalogue, une bibliographie partant toujours d'un auteur à soi.
/// </summary>
private async Task<BibliographieDto> BibliographieAsync(IBnfClient bnf)
{
await _catalogue.CreerAsync(
new EnregistrementLivre { Titre = "Les fourmis", Auteur = "Bernard Werber" }, Mathieu);
var auteurs = new ServiceAuteurs(_db);
var service = new ServiceBibliographie(_db, bnf, auteurs);
var werber = (await auteurs.ListerAsync()).Single(a => a.Nom.Contains("Werber"));
return (await service.ObtenirAsync(werber.Id, Mathieu))!;
}
private async Task<BibliographieDto> BibliographieWerberAsync(string utilisateur = Mathieu)