Files
mabibli/MaBibli.Shared/Isbn/CodePeriodique.cs
T
mathieuandClaude Opus 5 5cf566bc33 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>
2026-08-19 00:14:01 +02:00

63 lines
2.5 KiB
C#

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}";
}
}