Sortir le statut de lecture et l'auteur de la table Livre

Deux changements de modele en une seule migration, plus la recherche qui
en depend.

Le statut de lecture devient personnel. Il etait une colonne de Livre,
donc partage par tout le foyer, alors que deux membres lisent le meme
exemplaire a des rythmes differents. Il vit desormais dans une table
(LivreId, Utilisateur, Statut) avec unicite sur le couple. L'absence de
ligne vaut « non commence » : sur une bibliotheque de foyer la plupart
des couples n'ont aucun statut, et les materialiser tous multiplierait
les lignes par le nombre de comptes pour n'exprimer qu'un vide. Rien
n'est donc ecrit a la creation d'un livre.

Piege rencontre : un Dictionary<int, Statut> renvoyait la valeur 0 de
l'enumeration — « À lire » — pour un livre sans ligne, rendant « non
commence » indiscernable d'un choix explicite. Le dictionnaire est
desormais typé Statut?.

L'auteur devient une table. Deux formes normalisees y cohabitent, et ce
n'est pas une redondance : NomNormalise garde l'ordre de saisie pour la
recherche en sous-chaine, CleRegroupement trie les mots et porte l'index
unique, donc l'invariant « un auteur, une fiche ». Les initiales
echappent a la cle et sont traitees en memoire, sur une table qui compte
au plus quelques centaines de lignes.

Un livre peut avoir plusieurs auteurs — le lookup ISBN en renvoie quatre
pour Introduction to Algorithms — d'ou la table de liaison, avec une
position qui conserve l'ordre de la couverture.

Les rapprochements ambigus ne sont jamais appliques seuls : l'API les
liste, l'utilisateur accepte ou refuse, et les refus sont memorises pour
que la suggestion ne revienne pas. Le couple refuse est range par
identifiant croissant, donc un refus vaut dans les deux sens.

Reprise des donnees existantes. L'ancien statut, commun, est rattache a
AjoutePar — seule personne que la base associe au livre. Les statuts des
livres sans AjoutePar sont perdus : les attribuer serait une invention.
Les trois valeurs sont reprises telles quelles, « À lire » compris, parce
que c'est ce que l'ancienne interface affichait. L'ancien champ auteur
devient une fiche par valeur distincte.

La migration ne peut pas tout faire : lower() de SQLite ne retire pas les
accents, donc « Émile Zola » et « emile zola » y restent deux fiches.
ServiceRenormalisation finit le travail en C# au demarrage, reunit ces
variantes, applique aussi la regle des initiales — sans quoi une base
heritee resterait eclatee la ou une saisie neuve aurait ete reunie
d'emblee — et garde le nom d'affichage le plus presentable. Il est
idempotent, et sert de filet si les regles de normalisation changent.

L'ordre de la migration compte : les colonnes condamnees sont recopiees
dans une table de transit avant d'etre supprimees, parce que supprimer
une colonne sous SQLite reconstruit la table.

Verifie sur une base a l'ancien schema contenant 9 livres, 2 prets et
trois variantes de Zola : prets intacts, statuts rattaches, les trois
Zola reunis sous « Émile Zola », « P.F. Hamilton » absorbe par
« Peter F. Hamilton », « Hamilton » seul laisse en suggestion.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
mathieu
2026-08-18 02:22:46 +02:00
co-authored by Claude Opus 5
parent 4a8bc98f50
commit b594a4b2c1
32 changed files with 2856 additions and 164 deletions
+100 -27
View File
@@ -8,32 +8,54 @@ namespace MaBibli.Tests;
/// </summary>
public class FiltreLivresTests
{
private static Auteur Auteur(int id, string nom)
{
var auteur = new Auteur { Id = id, Nom = nom };
auteur.RecalculerFormes();
return auteur;
}
private static readonly Auteur Zola = Auteur(1, "Émile Zola");
private static readonly Auteur Maupassant = Auteur(2, "Guy de Maupassant");
private static Livre Livre(
int id, string titre, Auteur? auteur, Format format, Statut? statut, string? ajoutePar,
string? lecteur = "mathieu")
{
var livre = new Livre
{
Id = id,
Titre = titre,
Format = format,
AjoutePar = ajoutePar,
};
livre.RecalculerFormes();
if (auteur is not null)
{
livre.Auteurs.Add(new LivreAuteur { LivreId = id, AuteurId = auteur.Id, Auteur = auteur });
}
if (statut is { } valeur && lecteur is not null)
{
livre.Statuts.Add(new StatutLecture { LivreId = id, Utilisateur = lecteur, Statut = valeur });
}
return livre;
}
// « mathieu » a un statut sur les quatre livres ; « camille » n'en a aucun.
private static readonly Livre[] Catalogue =
[
new()
{
Id = 1, Titre = "Germinal", Auteur = "Émile Zola",
Format = Format.Physique, Statut = Statut.Lu, AjoutePar = "mathieu",
},
new()
{
Id = 2, Titre = "La Bête humaine", Auteur = "Émile Zola",
Format = Format.Numerique, Statut = Statut.ALire, AjoutePar = "camille",
},
new()
{
Id = 3, Titre = "Le Horla", Auteur = "Guy de Maupassant",
Format = Format.Physique, Statut = Statut.EnCours, AjoutePar = "camille",
},
new()
{
Id = 4, Titre = "Bel-Ami", Auteur = null,
Format = Format.Numerique, Statut = Statut.Lu, AjoutePar = null,
},
Livre(1, "Germinal", Zola, Format.Physique, Statut.Lu, "mathieu"),
Livre(2, "La Bête humaine", Zola, Format.Numerique, Statut.ALire, "camille"),
Livre(3, "Le Horla", Maupassant, Format.Physique, Statut.EnCours, "camille"),
Livre(4, "Bel-Ami", null, Format.Numerique, Statut.Lu, null),
];
private static List<Livre> Filtrer(CritereLivres criteres) =>
FiltreLivres.Appliquer(Catalogue.AsQueryable(), criteres).ToList();
private static List<Livre> Filtrer(CritereLivres criteres, string? utilisateur = "mathieu") =>
FiltreLivres.Appliquer(Catalogue.AsQueryable(), criteres, utilisateur).ToList();
[Fact]
public void Sans_critere_tout_le_catalogue_remonte()
@@ -61,13 +83,26 @@ public class FiltreLivresTests
[InlineData(Statut.EnCours, 1)]
[InlineData(Statut.Lu, 2)]
public void Le_filtre_statut_ne_garde_que_ce_statut(Statut statut, int attendu)
{
var resultat = Filtrer(new CritereLivres { Statut = statut });
=> Assert.Equal(attendu, Filtrer(new CritereLivres { Statut = statut }).Count);
Assert.Equal(attendu, resultat.Count);
Assert.All(resultat, l => Assert.Equal(statut, l.Statut));
/// <summary>
/// <b>Le statut est personnel.</b> Le même filtre, la même bibliothèque, une autre personne :
/// rien ne remonte, parce que « camille » n'a posé aucun statut.
/// </summary>
[Fact]
public void Le_filtre_statut_ne_voit_que_le_statut_de_lappelant()
{
Assert.Equal(2, Filtrer(new CritereLivres { Statut = Statut.Lu }, "mathieu").Count);
Assert.Empty(Filtrer(new CritereLivres { Statut = Statut.Lu }, "camille"));
// Sans filtre, en revanche, camille voit toute la bibliothèque : elle est commune.
Assert.Equal(4, Filtrer(new CritereLivres(), "camille").Count);
}
[Fact]
public void Sans_identite_aucun_statut_ne_correspond()
=> Assert.Empty(Filtrer(new CritereLivres { Statut = Statut.Lu }, null));
[Fact]
public void La_recherche_porte_sur_le_titre()
=> Assert.Equal(["Germinal"], Filtrer(new CritereLivres { Recherche = "germ" }).Select(l => l.Titre));
@@ -78,6 +113,26 @@ public class FiltreLivresTests
["Germinal", "La Bête humaine"],
Filtrer(new CritereLivres { Recherche = "zola" }).Select(l => l.Titre));
/// <summary>
/// Le besoin exprimé dans IDEES.md : « Emile » doit trouver « Émile ». Il n'y a pas de
/// collation SQLite pour ça, seule la colonne normalisée le permet.
/// </summary>
[Theory]
[InlineData("emile")]
[InlineData("Émile")]
[InlineData("EMILE ZOLA")]
[InlineData("zola, émile")]
public void La_recherche_ignore_les_accents_sur_lauteur(string terme)
=> Assert.Equal(
["Germinal", "La Bête humaine"],
Filtrer(new CritereLivres { Recherche = terme }).Select(l => l.Titre));
[Theory]
[InlineData("bete")]
[InlineData("BÊTE")]
public void La_recherche_ignore_les_accents_sur_le_titre(string terme)
=> Assert.Equal(["La Bête humaine"], Filtrer(new CritereLivres { Recherche = terme }).Select(l => l.Titre));
[Theory]
[InlineData("HORLA")]
[InlineData("horla")]
@@ -88,12 +143,18 @@ public class FiltreLivresTests
[Fact]
public void Un_livre_sans_auteur_ne_fait_pas_echouer_la_recherche()
{
// Le livre 4 a Auteur = null : la clause sur l'auteur doit le traverser sans exploser.
// Le livre 4 n'a aucun auteur : la clause sur les auteurs doit le traverser sans exploser.
var resultat = Filtrer(new CritereLivres { Recherche = "bel" });
Assert.Equal(["Bel-Ami"], resultat.Select(l => l.Titre));
}
[Fact]
public void Le_filtre_par_auteur_regroupe_ses_livres()
=> Assert.Equal(
["Germinal", "La Bête humaine"],
Filtrer(new CritereLivres { AuteurId = Zola.Id }).Select(l => l.Titre));
[Fact]
public void Les_criteres_se_combinent()
{
@@ -147,4 +208,16 @@ public class FiltreLivresTests
Assert.DoesNotContain(proprietes, nom => nom.Contains("Ajoute", StringComparison.OrdinalIgnoreCase));
Assert.DoesNotContain(proprietes, nom => nom.Contains("Utilisateur", StringComparison.OrdinalIgnoreCase));
}
/// <summary>
/// Troisième verrou, sur la décision inverse : <see cref="Livre"/> ne doit plus jamais porter
/// de colonne <c>Statut</c>, qui redeviendrait commune à tout le foyer.
/// </summary>
[Fact]
public void Livre_ne_porte_aucun_statut_commun()
{
var statut = typeof(Livre).GetProperty("Statut");
Assert.Null(statut);
}
}