mathieu/mabibli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 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.Shared/Isbn/CodePeriodique.cs
+62
View File
@@ -0,0 +1,62 @@
using System.Globalization;
namespace MaBibli.Shared.Isbn;
/// <summary>
/// Reconnaissance des codes-barres de <b>périodiques</b> et extraction de leur ISSN.
/// </summary>
/// <remarks>
/// Un livre porte un EAN-13 préfixé <c>978</c> ou <c>979</c> ; un magazine porte <c>977</c>,
/// qui encode un <b>ISSN</b> — c'est-à-dire un <i>titre de revue</i>, pas un ouvrage. Aucune
/// recherche <c>bib.isbn</c> ne peut donc aboutir sur un tel code, et l'application répondait
/// « aucun résultat » là où le code lui-même dit qu'on ne cherche pas au bon endroit.
/// <para>
/// Structure du code, vérifiée sur <c>9772466671438</c> le 2026-08-18 :
/// <c>977</c> + les <b>7 premiers chiffres de l'ISSN</b> (sa clé n'y figure pas, elle est
/// recalculée) + <b>2 chiffres de parution</b> + la clé EAN-13. Les deux chiffres de parution
/// sont la raison pour laquelle un même ISSN couvre tous les numéros d'une revue : ils ne sont
/// <b>pas</b> exploitables comme numéro d'édition fiable, et ne sont donc pas exposés ici.
/// </para>
/// </remarks>
public static class CodePeriodique
{
/// <summary>Préfixe EAN-13 réservé aux publications en série.</summary>
public const string Prefixe = "977";
/// <summary>
/// Vrai si <paramref name="ean"/> (déjà normalisé) est un EAN-13 valide de périodique.
/// </summary>
public static bool EstCodePeriodique(string? ean) =>
IsbnUtils.EstIsbn13Valide(ean) && ean!.StartsWith(Prefixe, StringComparison.Ordinal);
/// <summary>
/// ISSN porté par le code-barres, sous sa forme canonique à tiret (<c>2466-6718</c>),
/// ou <c>null</c> si le code n'est pas celui d'un périodique.
/// </summary>
/// <remarks>
/// La clé de l'ISSN n'est pas dans le code-barres : elle se recalcule (somme pondérée 8→2,
/// modulo 11, <c>X</c> si le complément vaut 10). C'est le même principe que la clé ISBN-10,
/// sur sept chiffres au lieu de neuf.
/// </remarks>
public static string? IssnDepuis(string? ean)
{
if (!EstCodePeriodique(ean))
{
return null;
}
// Chiffres 4 à 10 du code : l'ISSN amputé de sa clé.
var corps = ean!.Substring(3, 7);
var somme = 0;
for (var i = 0; i < 7; i++)
{
somme += (corps[i] - '0') * (8 - i);
}
var cle = (11 - (somme % 11)) % 11;
var caractereCle = cle == 10 ? "X" : cle.ToString(CultureInfo.InvariantCulture);
return $"{corps[..4]}-{corps[4..]}{caractereCle}";
}
}
MaBibli.Shared/Isbn/FormatageIsbn.cs
+205
View File
@@ -0,0 +1,205 @@
namespace MaBibli.Shared.Isbn;
/// <summary>
/// Découpage d'un ISBN en tranches séparées par des tirets, <b>pour l'affichage seulement</b>.
/// </summary>
/// <remarks>
/// <c>9782846391009</c> → <c>978-2-84639-100-9</c>. La valeur <b>stockée reste nue</b> : ces
/// tirets ne franchissent jamais la frontière de la base ni celle des requêtes aux sources
/// (la BnF indexe l'ISBN sans tiret). Le seul point d'entrée est <see cref="Afficher"/>.
/// <para>
/// Le découpage dépend du <b>groupe linguistique</b> puis de l'<b>éditeur</b>, et les tranches
/// sont publiées par l'agence internationale — elles ne se devinent pas. Les tables ci-dessous
/// sont extraites du <c>RangeMessage.xml</c> officiel (<c>isbn-international.org</c>), version
/// du 2026-08-18.
/// </para>
/// <para>
/// <b>Principe tenu :</b> on n'affiche <b>jamais</b> une coupure qu'on ne sait pas juste. Le
/// français (<c>978-2</c>) est découpé en entier, jusqu'à l'éditeur. Ailleurs, on s'arrête au
/// groupe et à la clé — deux frontières toujours exactes — et l'on ne devine pas la limite
/// éditeur/publication. Une tranche en moins se lit encore ; une tranche fausse trompe.
/// </para>
/// </remarks>
public static class FormatageIsbn
{
/// <summary>Longueur du groupe linguistique, d'après les 7 chiffres qui suivent <c>978</c>.</summary>
private static readonly (int Debut, int Fin, int Longueur)[] GroupesSous978 =
[
(0000000, 5999999, 1),
(6000000, 6499999, 3),
(6500000, 6599999, 2),
(6600000, 6699999, 2),
(6999000, 6999999, 5),
(7000000, 7999999, 1),
(8000000, 9499999, 2),
(9500000, 9899999, 3),
(9900000, 9989999, 4),
(9990000, 9999999, 5),
];
/// <summary>Idem sous <c>979</c> : seuls deux groupes existent à ce jour.</summary>
private static readonly (int Debut, int Fin, int Longueur)[] GroupesSous979 =
[
(1000000, 1599999, 2),
(8000000, 8999999, 1),
];
/// <summary>
/// Longueur du numéro d'éditeur dans le groupe <b>francophone</b>, d'après les 7 chiffres
/// qui suivent <c>978-2</c>.
/// </summary>
/// <remarks>
/// C'est la seule table d'éditeurs embarquée, et c'est un choix : la collection est
/// majoritairement francophone, et les 19 tranches ci-dessous couvrent donc l'essentiel du
/// fonds. Embarquer les ~220 groupes du monde entier alourdirait le WASM téléchargé par le
/// navigateur pour un gain marginal.
/// </remarks>
private static readonly (int Debut, int Fin, int Longueur)[] EditeursFrancophones =
[
(0000000, 1999999, 2),
(2000000, 3499999, 3),
(3500000, 3999999, 5),
(4000000, 4869999, 3),
(4870000, 4949999, 6),
(4950000, 4959999, 3),
(4960000, 4966999, 4),
(4967000, 4969999, 5),
(4970000, 5279999, 3),
(5280000, 5299999, 4),
(5300000, 6999999, 3),
(7000000, 8399999, 4),
(8400000, 8999999, 5),
(9000000, 9197999, 6),
(9198000, 9198099, 5),
(9198100, 9199429, 6),
(9199430, 9199689, 7),
(9199690, 9499999, 6),
(9500000, 9999999, 7),
];
private const string GroupeFrancophone = "2";
/// <summary>
/// Rend l'ISBN lisible, tirets compris.
/// </summary>
/// <returns>
/// La forme découpée, ou l'entrée telle quelle si elle n'est pas un ISBN valide — on ne
/// découpe jamais ce qu'on n'a pas reconnu, un ISBN mal saisi doit se voir tel qu'il est.
/// </returns>
public static string Afficher(string? brut)
{
if (string.IsNullOrWhiteSpace(brut))
{
return string.Empty;
}
var isbn = IsbnUtils.Normaliser(brut);
if (!IsbnUtils.EstValide(isbn))
{
return brut.Trim();
}
var decoupe = isbn!.Length == 13 ? Decouper13(isbn) : Decouper10(isbn);
return decoupe ?? isbn;
}
private static string? Decouper13(string isbn)
{
var prefixe = isbn[..3];
var table = prefixe switch
{
"978" => GroupesSous978,
"979" => GroupesSous979,
// 977 (périodique) et tout autre préfixe EAN ne portent pas d'ISBN : rien à découper.
_ => null,
};
if (table is null || !TrouverLongueur(table, isbn.AsSpan(3), out var longueurGroupe))
{
return null;
}
var groupe = isbn.Substring(3, longueurGroupe);
var corps = isbn[(3 + longueurGroupe)..];
return prefixe + "-" + Assembler(groupe, corps, francophone: prefixe == "978" && groupe == GroupeFrancophone);
}
private static string? Decouper10(string isbn)
{
// Un ISBN-10 est un ISBN-13 en 978 amputé de son préfixe : les tranches de groupe
// sont donc exactement les mêmes.
if (!TrouverLongueur(GroupesSous978, isbn.AsSpan(), out var longueurGroupe))
{
return null;
}
var groupe = isbn[..longueurGroupe];
var corps = isbn[longueurGroupe..];
return Assembler(groupe, corps, francophone: groupe == GroupeFrancophone);
}
/// <summary>
/// Recolle <c>groupe - [éditeur - publication] - clé</c> à partir du corps de l'ISBN
/// (tout ce qui suit le groupe, clé comprise).
/// </summary>
private static string Assembler(string groupe, string corps, bool francophone)
{
var cle = corps[^1..];
var milieu = corps[..^1];
if (francophone
&& TrouverLongueur(EditeursFrancophones, corps.AsSpan(), out var longueurEditeur)
// Il doit rester au moins un chiffre de publication : sinon la tranche est plus
// longue que le corps, et on afficherait une coupure absurde plutôt que rien.
&& longueurEditeur < milieu.Length)
{
var editeur = milieu[..longueurEditeur];
var publication = milieu[longueurEditeur..];
return $"{groupe}-{editeur}-{publication}-{cle}";
}
return $"{groupe}-{milieu}-{cle}";
}
/// <summary>
/// Cherche la tranche contenant les 7 premiers chiffres de <paramref name="chiffres"/>.
/// </summary>
/// <remarks>
/// Les tables de l'agence sont toutes indexées sur <b>7 chiffres</b>, complétés par des
/// zéros quand il en manque — c'est ce que fait le remplissage ci-dessous.
/// </remarks>
private static bool TrouverLongueur(
(int Debut, int Fin, int Longueur)[] table, ReadOnlySpan<char> chiffres, out int longueur)
{
longueur = 0;
var cle = 0;
for (var i = 0; i < 7; i++)
{
// Le X final d'un ISBN-10 n'est jamais dans les 7 premiers chiffres d'un corps
// exploitable, mais le vérifier coûte moins cher que d'y croire.
var c = i < chiffres.Length ? chiffres[i] : '0';
if (!char.IsDigit(c))
{
return false;
}
cle = (cle * 10) + (c - '0');
}
foreach (var (debut, fin, valeur) in table)
{
if (cle >= debut && cle <= fin)
{
longueur = valeur;
return true;
}
}
// Tranche non attribuée : on ne devine pas.
return false;
}
}