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

Compte les pages d'un livre, et fais des envies une liste à deux moitiés

Browse Source 
Lot U — le nombre de pages
`Livre.NombrePages` est nullable, sans valeur par défaut : « 0 page » se lirait
comme une donnée là où l'on veut dire « on ne sait pas ». Même raison que pour
`TypeDocument.NonPrecise` — un défaut qui ne prétend rien n'a rien à reprendre,
d'où une migration réduite à un `AddColumn`. Le service refuse un zéro plutôt
que de l'écrire ; effacer le champ reste la façon de revenir à « inconnu ».

Le préremplissage vient de `dc:format`, que rien ne lisait jusqu'ici. ⚠️ Ce
champ n'est pas un nombre mais une phrase décrivant le support, et les notices
déjà enregistrées sous Fixtures/ le montrent : « 1 vol. (113 p.) : ill., couv.
ill. en coul. ; 18 cm », « 503 p. : couv. ill. ; 17 cm ». Les règles sont donc
étroites — un nombre suivi de « p. » ou de « page(s) », rien d'autre — et tout
le reste rend `null`. L'erreur n'est pas symétrique : un champ vide se remplit à
la main en trois secondes, un chiffre faux s'enregistre sans que personne ne le
voie. « 1 vol. » ne vaut pas 1, « 30 cm » ne vaut pas 30, et « (p. 45-90) »,
qui est une pagination de contribution, ne vaut rien. La valeur reste proposée
dans un champ modifiable, et rien n'est déduit pour un ebook.

Lot X — éditer une envie, et souhaiter une revue
`PUT /api/souhaits/{id}` recalcule la clé d'œuvre et l'auteur normalisé : sans
ce recalcul, le rapprochement « déjà au catalogue » continuerait de se faire sur
l'ancienne forme, et le signalement mentirait sans le dire. Le filtre sur
l'appelant fait partie de la clé de recherche, pas d'une vérification ultérieure
— l'envie d'un autre est introuvable (404), jamais refusée (403).

⚠️ Une édition peut heurter l'unicité (utilisateur, œuvre, auteur), ce qu'un
ajout ne peut pas : renommer une envie en une autre déjà présente répond par un
message lisible, jamais par « UNIQUE constraint failed ». 400 et non 409,
contrairement au doublon du catalogue : là-bas posséder deux exemplaires est
légitime et l'appel se reconfirme, ici l'index l'interdit et il n'y a rien à
confirmer. Le rang n'est pas touché — l'ordre a son propre point d'entrée.

⚠️ La couverture n'est écrite que si la charge utile en porte une. Aucun écran
n'offre de champ « URL de couverture » pour une envie (décision actée), donc un
remplacement inconditionnel l'aurait effacée à la première faute de frappe
corrigée.

`RevueSouhaitee` est une table sœur, et non des colonnes de plus sur
`LivreSouhaite` : un numéro n'a pas d'auteur et se distingue par son numéro,
deux choses que la clé d'unicité des envies de livres ne sait pas exprimer sans
devenir fausse pour tout le monde. `NumeroNormalise` est NOT NULL avec un défaut
vide — SQLite tient deux NULL pour distincts, et « Médor, sans numéro »
s'ajouterait autant de fois qu'on cliquerait. L'ISSN est canonisé avec son tiret,
seul code du projet rangé ainsi.

Le coût de la table sœur est payé partout où il devait l'être : affichage,
`.txt`, `.csv` et instantané hors-ligne `souhaits-revues`. ⚠️ Les revues forment
une SECTION à part plutôt que des lignes entrelacées : chaque table numérote son
rang indépendamment, et mélanger deux suites sans rapport produirait un ordre que
personne n'a choisi. Le `.txt`, groupé par auteur, ne pouvait de toute façon pas
les accueillir — elles n'en ont pas, et « Auteur non précisé » désigne des livres
dont l'auteur est inconnu. Le CSV gagne une colonne « Type » : sans elle, un tri
par titre rendrait revues et livres indiscernables, et la colonne des codes
mêlerait ISBN et ISSN en silence.

`ServiceRenormalisation` connaît la nouvelle table, avec la règle de collision
déjà en place. ⚠️ L'ISSN y est canonisé à part : `Renormaliser` n'applique rien
quand la clé ne bouge pas, un ISSN mal formé sur une ligne au titre inchangé y
échapperait.

`RevueSouhaitee` ne porte PAS de `CoverUrl` : rien à ajouter au garde de
`GET /api/couvertures`.

Vérifié en exécution : ISSN « 24666718 » rangé « 2466-6718 », édition de l'envie
d'un autre en 404, et les deux exports portant bien les deux moitiés.
602 tests au vert (552 au départ), aucun avertissement de compilation.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
mathieu
2026-08-21 14:02:09 +02:00
co-authored by Claude Opus 5
parent 1b47828c11
commit 94f0ef15c0
41 changed files with 4279 additions and 685 deletions
Download Patch File Download Diff File Expand all files Collapse all files
MaBibli.Tests/ExportSouhaitsTests.cs
+91 -16
View File
@@ -35,6 +35,7 @@ public class ExportSouhaitsTests
Souhait(2, "Germinal", "Émile Zola"),
Souhait(3, "Les fourmis", "Bernard Werber"),
],
[],
"Mathieu",
Jour);
@@ -60,6 +61,7 @@ public class ExportSouhaitsTests
{
var texte = ExportSouhaits.Texte(
[Souhait(1, "Titre orphelin"), Souhait(2, "Germinal", "Émile Zola")],
[],
null,
Jour);
@@ -72,6 +74,7 @@ public class ExportSouhaitsTests
{
var texte = ExportSouhaits.Texte(
[Souhait(1, "Germinal", "Émile Zola", "Le Livre de poche", "1885", "2253004227", "en poche seulement")],
[],
null,
Jour);
@@ -90,7 +93,7 @@ public class ExportSouhaitsTests
public void Le_csv_decoupe_lIsbn_pour_quExcel_ne_le_prenne_pas_pour_un_nombre()
{
var csv = ExportSouhaits.Csv(
[Souhait(1, "Germinal", "Émile Zola", "Le Livre de poche", "1885", "9782253004226")]);
[Souhait(1, "Germinal", "Émile Zola", "Le Livre de poche", "1885", "9782253004226")], []);
Assert.Contains("978-2-253-00422-6", csv);
Assert.DoesNotContain("9782253004226", csv);
@@ -99,20 +102,20 @@ public class ExportSouhaitsTests
[Fact]
public void Le_texte_le_dit_quand_la_liste_est_vide()
{
var texte = ExportSouhaits.Texte([], "Mathieu", Jour);
var texte = ExportSouhaits.Texte([], [], "Mathieu", Jour);
Assert.Contains("(aucun livre dans la liste)", texte);
Assert.Contains("(aucune envie dans la liste)", texte);
}
[Fact]
public void Le_csv_porte_un_en_tete_et_une_ligne_par_envie()
{
var csv = ExportSouhaits.Csv([Souhait(1, "Germinal", "Émile Zola", "Le Livre de poche", "1885")]);
var csv = ExportSouhaits.Csv([Souhait(1, "Germinal", "Émile Zola", "Le Livre de poche", "1885")], []);
var lignes = csv.Split("\r\n", StringSplitOptions.RemoveEmptyEntries);
Assert.Equal("Rang;Titre;Auteur;Éditeur;Année;ISBN;Note;Ajouté le", lignes[0]);
Assert.Equal("1;Germinal;Émile Zola;Le Livre de poche;1885;;;2026-08-18", lignes[1]);
Assert.Equal("Rang;Type;Titre;Auteur;Éditeur;Année;ISBN / ISSN;Note;Ajouté le", lignes[0]);
Assert.Equal("1;Livre;Germinal;Émile Zola;Le Livre de poche;1885;;;2026-08-18", lignes[1]);
}
/// <summary>
@@ -123,15 +126,15 @@ public class ExportSouhaitsTests
public void Le_csv_echappe_le_separateur_et_les_guillemets()
{
var csv = ExportSouhaits.Csv(
[Souhait(1, "Titre; piégé", note: "il a dit \"oui\"")]);
[Souhait(1, "Titre; piégé", note: "il a dit \"oui\"")], []);
var ligne = csv.Split("\r\n")[1];
Assert.StartsWith("1;\"Titre; piégé\";", ligne);
Assert.StartsWith("1;Livre;\"Titre; piégé\";", ligne);
Assert.Contains("\"il a dit \"\"oui\"\"\"", ligne);
// Huit colonnes une fois l'échappement respecté, pas neuf.
Assert.Equal(8, ColonnesCsv(ligne).Count);
// Neuf colonnes une fois l'échappement respecté, pas dix.
Assert.Equal(9, ColonnesCsv(ligne).Count);
}
/// <summary>
@@ -148,20 +151,20 @@ public class ExportSouhaitsTests
Souhait(3, "Abécédaire", "Émile Zola"),
];
var texte = ExportSouhaits.Texte(liste, null, Jour);
var texte = ExportSouhaits.Texte(liste, [], null, Jour);
Assert.Contains(" - [1] Zorro", texte);
Assert.Contains(" - [2] Abécédaire", texte);
// Le CSV, lui, garde l'ordre : le rang y est croissant ligne après ligne.
var lignes = ExportSouhaits.Csv(liste).Split("\r\n", StringSplitOptions.RemoveEmptyEntries);
Assert.StartsWith("1;Zorro;", lignes[1]);
Assert.StartsWith("2;Abécédaire;", lignes[2]);
var lignes = ExportSouhaits.Csv(liste, []).Split("\r\n", StringSplitOptions.RemoveEmptyEntries);
Assert.StartsWith("1;Livre;Zorro;", lignes[1]);
Assert.StartsWith("2;Livre;Abécédaire;", lignes[2]);
}
[Fact]
public void Le_csv_echappe_les_sauts_de_ligne()
{
var csv = ExportSouhaits.Csv([Souhait(1, "Titre", note: "ligne 1\nligne 2")]);
var csv = ExportSouhaits.Csv([Souhait(1, "Titre", note: "ligne 1\nligne 2")], []);
Assert.Contains("\"ligne 1\nligne 2\"", csv);
}
@@ -173,7 +176,7 @@ public class ExportSouhaitsTests
public void Le_bom_precede_le_csv()
{
var octets = ExportSouhaits.Bom
.Concat(Encoding.UTF8.GetBytes(ExportSouhaits.Csv([Souhait(1, "Émile")])))
.Concat(Encoding.UTF8.GetBytes(ExportSouhaits.Csv([Souhait(1, "Émile")], [])))
.ToArray();
Assert.Equal([0xEF, 0xBB, 0xBF], octets[..3]);
@@ -188,6 +191,78 @@ public class ExportSouhaitsTests
Assert.Equal(mime, ExportSouhaits.TypeMime(format));
}
// ─────────────────────────────────────────────────────────────────────────
// La table sœur : les revues souhaitées doivent traverser les DEUX exports.
// C'est là que le sujet se rate — un fichier emporté sans ses revues ne le dit pas.
// ─────────────────────────────────────────────────────────────────────────
private static RevueSouhaiteeDto Revue(
int id, string titre, string? numero = null, string? issn = null, string? note = null) =>
new()
{
Id = id,
Titre = titre,
Numero = numero,
Issn = issn,
Note = note,
DateAjout = Jour,
};
[Fact]
public void Le_texte_porte_les_revues_dans_une_section_apres_les_livres()
{
var texte = ExportSouhaits.Texte(
[Souhait(1, "Germinal", "Émile Zola")],
[Revue(1, "Médor", "43", "2466-6718"), Revue(2, "XXI")],
"Mathieu",
Jour);
Assert.Contains("1 livre", texte);
Assert.Contains("2 revues", texte);
// ⚠️ Section à part, APRÈS les livres : une revue n'a pas d'auteur, elle n'a donc rien
// à faire dans un fichier groupé par auteur — et surtout pas sous « Auteur non précisé »,
// qui désigne des livres dont l'auteur est simplement inconnu.
Assert.True(texte.IndexOf("Émile Zola", StringComparison.Ordinal)
< texte.IndexOf("Médor", StringComparison.Ordinal));
Assert.Contains(" - [1] Médor n° 43 (ISSN 2466-6718)", texte);
// Sans numéro, on n'invente pas de « n° » : c'est la revue entière qui est souhaitée.
Assert.Contains(" - [2] XXI", texte);
Assert.DoesNotContain("XXI n°", texte);
}
[Fact]
public void Le_texte_porte_les_revues_meme_sans_aucun_livre()
{
var texte = ExportSouhaits.Texte([], [Revue(1, "Médor", "43")], null, Jour);
Assert.DoesNotContain("(aucune envie dans la liste)", texte);
Assert.Contains(" - [1] Médor n° 43", texte);
}
/// <summary>
/// La colonne « Type » n'est pas décorative : sans elle, une revue et un livre deviennent
/// indiscernables dès que le tableur est trié par titre, et la colonne des codes mêle deux
/// numéros de nature différente sans le dire.
/// </summary>
[Fact]
public void Le_csv_distingue_les_revues_des_livres_et_les_range_ensuite()
{
var csv = ExportSouhaits.Csv(
[Souhait(1, "Germinal", "Émile Zola")],
[Revue(1, "Médor", "43", "2466-6718", "au kiosque de la gare")]);
var lignes = csv.Split("\r\n", StringSplitOptions.RemoveEmptyEntries);
Assert.StartsWith("1;Livre;Germinal;", lignes[1]);
Assert.Equal("1;Revue;Médor n° 43;;;;2466-6718;au kiosque de la gare;2026-08-18", lignes[2]);
// Le nombre de colonnes est le même pour les deux natures, sinon le tableau se décale.
Assert.Equal(ColonnesCsv(lignes[1]).Count, ColonnesCsv(lignes[2]).Count);
}
/// <summary>Découpe une ligne CSV en respectant les guillemets (lecteur minimal, pour le test).</summary>
private static List<string> ColonnesCsv(string ligne)
{