Scanne depuis une série et depuis les envies, et y range un souhait

Le scanner s'ouvre dans la place visée d'une série, sous son champ ISBN. C'est ce
qui répond à « le retour doit ramener sur la série ET sur la place » : il n'y a
pas de retour, on n'a jamais quitté la place. Passer par l'écran d'ajout
obligeait à revenir rattacher à la main, donc à risquer le mauvais tome.

Même composant dans la voie « par ISBN » des envies, sans création de livre au
bout. L'add-on EAN-2 y est ignoré, et ce n'est pas un oubli : il ne concerne que
les revues, qui ne se souhaitent pas.

Ranger une envie dans une série se fait depuis la série — c'est là qu'on voit
l'ordre de lecture, donc là qu'on sait quelle position donner. Le geste crée une
place ordinaire, LivreId à NULL, titre repris de l'envie : rien ne relie les deux
en base, et c'est tout le sujet. Les séries sont communes au foyer, la liste
d'envies est personnelle, et son sens même est de préparer un cadeau sans que
l'autre le voie venir. Une clé étrangère afficherait « tome 3 souhaité par
untel » à tout le monde ; ce qui doit rester invisible est le lien, pas
l'existence du tome, qu'on aurait saisie à la main de toute façon.

L'envie survit au rattachement, comme une envie déjà au catalogue est signalée et
jamais supprimée — à plus forte raison ici, puisque rien n'a été acheté. Les
envies dont le titre est déjà un tome de la série ne sont pas proposées : la
place n'étant identifiée que par son titre, les offrir mènerait au doublon.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
mathieu
2026-08-21 11:25:48 +02:00
co-authored by Claude Opus 5
parent 1d35dc06f4
commit 7e47a5d6c0
2 changed files with 221 additions and 0 deletions
+55
View File
@@ -76,9 +76,32 @@
title="@MotifBlocage" @onclick="ChercherParIsbnAsync">
@(_recherche ? "Recherche…" : "Chercher")
</button>
@*
J2 : le cas d'usage est direct — le livre est en main, en librairie. C'est le même
composant de scan que l'écran d'ajout au catalogue, sans création de Livre au bout :
un souhait n'est pas une possession.
*@
<button type="button" class="bouton bouton-discret"
disabled="@(_scan || !Reseau.EnLigne)" title="@MotifBlocage"
@onclick="OuvrirScanner">
Scanner
</button>
</div>
}
@if (_scan)
{
<ScannerCodeBarres OnCodeDetecte="SurCodeDetecteAsync" OnAnnuler="() => _scan = false" />
}
@* L1 : la BnF met environ une seconde à répondre. Sans indicateur, l'écran ne dit rien et
l'on reclique — donc on relance l'appel. *@
@if (_recherche)
{
<Patience Message="Interrogation de la BnF, puis d'OpenLibrary…" />
}
@if (_erreur is not null)
{
<p class="message-erreur" role="alert">@_erreur</p>
@@ -196,6 +219,9 @@
private TriResultats _tri = TriResultats.Date;
private bool _recherche;
private bool _ajout;
/// <summary>Le scanner est ouvert. Il ne l'est que depuis la voie « par ISBN ».</summary>
private bool _scan;
private string? _erreur;
protected override void OnInitialized() => Reseau.Change += SurChangementReseau;
@@ -239,8 +265,37 @@
}
}
private void OuvrirScanner()
{
_erreur = null;
_candidats = [];
_avertissements = [];
_scan = true;
}
/// <summary>
/// Enchaîne la recherche sur le code lu, sans bouton à confirmer.
/// </summary>
/// <remarks>
/// Le code reste dans le champ : un décodage erroné se corrige et se relance. C'est la
/// décision déjà actée pour l'écran d'ajout au catalogue, et la seule cohérente avec une
/// douchette, qui envoie <c>Entrée</c> d'elle-même.
/// <para>
/// ⚠️ L'add-on EAN-2 (numéro de parution) est ignoré ici, et ce n'est pas un oubli : il ne
/// concerne que les revues, qui ne se souhaitent pas — cet écran alimente une liste
/// d'<i>œuvres</i>. Un code de périodique est d'ailleurs intercepté plus bas et nommé.
/// </para>
/// </remarks>
private async Task SurCodeDetecteAsync(CodeScanne lecture)
{
_scan = false;
_isbn = lecture.Code;
await ChercherParIsbnAsync();
}
private void Basculer(Mode mode)
{
_scan = false;
_mode = mode;
_focusAFaire = true;
_erreur = null;
+166
View File
@@ -226,6 +226,34 @@ else
title="@MotifBlocage" @onclick="ChercherLookupAsync">
@(_lookupEnCours ? "Recherche…" : "Préremplir")
</button>
@*
J1 : le scanner s'ouvre ICI, dans la place visée, et non sur
l'écran d'ajout.
⚠️ C'est ce qui répond à l'exigence « le retour doit ramener
sur la série ET sur la place visée » : il n'y a pas de
retour, on n'a jamais quitté la place. Passer par /ajout
obligeait à revenir rattacher à la main — donc à risquer de
rattacher le mauvais tome.
*@
<button type="button" class="bouton bouton-discret"
disabled="@(_enCours || _lookupScan || !Reseau.EnLigne)"
title="@MotifBlocage" @onclick="OuvrirScanTome">
Scanner
</button>
@if (_lookupScan)
{
<ScannerCodeBarres OnCodeDetecte="SurCodeTomeAsync"
OnAnnuler="() => _lookupScan = false" />
}
@* L1 : la cascade BnF puis OpenLibrary prend une seconde ou deux. *@
@if (_lookupEnCours)
{
<Patience Message="Interrogation de la BnF, puis d'OpenLibrary…" />
}
@if (_lookupCandidats.Count > 0)
{
@foreach (var candidat in _lookupCandidats)
@@ -288,8 +316,57 @@ else
@onclick="() => OuvrirRattachement(AjoutDepuisCatalogue)">
Depuis le catalogue
</button>
@*
Lot P — le chemin inverse de « place vide → envie ».
⚠️ Ce geste n'ÉPARGNE QU'UNE RESAISIE : il crée une place ordinaire, LivreId à
NULL, titre repris de l'envie. Rien ne relie les deux en base, et c'est délibéré —
les séries sont COMMUNES au foyer, la liste d'envies est PERSONNELLE, et son sens
même est de préparer un cadeau sans que l'autre le voie venir. Une clé étrangère
vers l'envie afficherait « tome 3 souhaité par untel » à tout le monde.
*@
<button type="button" class="bouton bouton-discret"
disabled="@(_enCours || !Reseau.EnLigne)" title="@MotifBlocage"
@onclick="OuvrirEnviesAsync">
Depuis mes envies
</button>
</div>
@if (_enviesOuvertes)
{
<div class="recherche-livre">
@if (_enviesChargement)
{
<Patience Message="Lecture de votre liste d'envies…" />
}
else if (_envies.Count == 0)
{
<p class="message-discret">
Votre liste d'envies est vide — ou ne contient rien qui ne soit déjà un tome
de cette série.
</p>
}
else
{
<p class="message-discret">
Le tome est ajouté comme <strong>manquant</strong>, avec le titre de l'envie.
L'envie <strong>reste dans votre liste</strong> : rien n'a été acheté, et
personne d'autre ne verra qu'elle est à vous.
</p>
@foreach (var envie in _envies)
{
<button type="button" class="bouton bouton-discret" @key="envie.Id"
disabled="@(_enCours || !Reseau.EnLigne)" title="@MotifBlocage"
@onclick="() => AjouterDepuisEnvieAsync(envie)">
@envie.Titre@(string.IsNullOrWhiteSpace(envie.Auteur) ? "" : $" — {envie.Auteur}")
</button>
}
}
</div>
}
@if (_rattachement == AjoutDepuisCatalogue)
{
<div class="recherche-livre">
@@ -419,6 +496,13 @@ else
private IReadOnlyList<CandidatLivre> _lookupCandidats = [];
private bool _lookupEnCours;
/// <summary>Le scanner est ouvert sur la place visée par le lookup ISBN (lot J1).</summary>
private bool _lookupScan;
private bool _enviesOuvertes;
private bool _enviesChargement;
private IReadOnlyList<SouhaitDto> _envies = [];
private string? MotifBlocage => Reseau.EnLigne ? null : EtatReseau.MotifHorsLigne;
private IReadOnlySet<int> CheminRacine => new HashSet<int> { Id };
@@ -616,11 +700,93 @@ else
}
}
private void OuvrirScanTome()
{
_erreur = null;
_lookupCandidats = [];
_lookupScan = true;
}
/// <summary>
/// Enchaîne le lookup sur le code lu, sans quitter la place visée.
/// </summary>
/// <remarks>
/// Le code reste dans le champ : un décodage erroné se corrige et se relance, comme sur
/// l'écran d'ajout au catalogue.
/// <para>
/// ⚠️ Un code de périodique (<c>977</c>) est refusé plus bas par <c>ChercherLookupAsync</c> :
/// <c>ElementSerie.LivreId</c> ne pointe que vers <c>Livre</c>, et les revues restent
/// délibérément hors de ce flux.
/// </para>
/// </remarks>
private async Task SurCodeTomeAsync(CodeScanne lecture)
{
_lookupScan = false;
_lookupIsbn = lecture.Code;
await ChercherLookupAsync();
}
/// <summary>
/// Ouvre la liste des envies dans laquelle puiser un tome à recenser.
/// </summary>
/// <remarks>
/// ⚠️ Les envies déjà présentes dans la série sont écartées de la liste : les proposer
/// mènerait droit au doublon, la place étant identifiée par son seul titre.
/// </remarks>
private async Task OuvrirEnviesAsync()
{
_erreur = null;
_message = null;
_enviesOuvertes = true;
_enviesChargement = true;
var toutes = await Api.ListerSouhaitsAsync();
var deja = new HashSet<string>(
_serie?.Elements.Select(e => NormalisationTexte.Normaliser(e.Titre)) ?? [],
StringComparer.Ordinal);
_envies = toutes
.Where(envie => !deja.Contains(NormalisationTexte.Normaliser(envie.Titre)))
.ToList();
_enviesChargement = false;
}
/// <summary>
/// Recense un tome à partir d'une envie, <b>sans rien lier</b>.
/// </summary>
/// <remarks>
/// La place créée est celle qu'on aurait saisie à la main : <c>LivreId</c> à <c>NULL</c>,
/// titre repris de l'envie. L'envie <b>survit</b> — c'est la règle déjà tenue par « une
/// envie déjà au catalogue est signalée, jamais supprimée », et à plus forte raison ici
/// puisque rien n'a été acheté.
/// <para>
/// ⚠️ Ce qui doit rester invisible au foyer n'est pas l'existence du tome — on l'aurait
/// saisie à la main de toute façon — mais le <b>lien</b> avec la liste de quelqu'un. Il n'y
/// en a aucun en base.
/// </para>
/// </remarks>
private async Task AjouterDepuisEnvieAsync(SouhaitDto envie)
{
await EcrireAsync(() => Api.AjouterElementSerieAsync(
Id, new AjoutElementSerie { Titre = envie.Titre }));
if (_erreur is null)
{
_enviesOuvertes = false;
_envies = [];
_message = $"« {envie.Titre} » est recensé comme tome manquant. "
+ "Il reste dans votre liste d'envies.";
}
}
private void OuvrirLookup(ElementSerieDto element)
{
_lookupElement = element;
_lookupIsbn = string.Empty;
_lookupCandidats = [];
_lookupScan = false;
_erreur = null;
}