Files
mabibli/MaBibli.Shared/Dtos/RevueDto.cs
T
mathieuandClaude Opus 5 1d35dc06f4 Donne aux numéros de revue leur couverture et leur une, et un tiret à l'ISSN
L'ISSN est désormais rangé sous sa forme à tiret, et pas seulement affiché ainsi.
C'est le seul endroit où le projet s'écarte de « la valeur stockée reste nue »,
et il y a une raison : le code-barres produit déjà un ISSN à tiret, et la BnF
interroge `bib.issn` avec le tiret. Un ISSN tapé « 24666718 » ne se rapprochait
donc de rien, et le scan suivant créait une seconde fiche à côté. La canonisation
a lieu avant la recherche, pas seulement à l'écriture. Les champs de saisie, eux,
gardent la valeur tapée : découper à la frappe se battrait avec le curseur.

`ServiceRenormalisation` rattrape les ISSN existants — par un passage dédié, le
mécanisme générique confondant tous les NULL en une seule clé, alors que
l'unicité est ici un index partiel. Une fiche dont la forme canonique est déjà
prise garde la sienne : le serveur doit démarrer.

La couverture d'un numéro est une URL collée, jamais une photo : aucune source ne
peut la fournir, l'ISSN désignant la revue et non la parution, et le projet ne
stocke aucun fichier. Le garde du relais de couvertures a donc été étendu aux
numéros — l'oublier n'aurait produit aucune erreur visible, seulement une image
présente en ligne et absente hors-ligne.

Les articles à la une vivent dans une table à part et non dans `Theme` : un thème
est un vocabulaire qu'on réutilise, un titre d'article est unique à sa parution.
Rien ne se partage, donc pas de n-n — une simple clé étrangère vers le numéro.
Ils se saisissent au point-virgule seul : « Ukraine, deux ans après » serait
coupé en deux par la virgule.

Un PUT sur le numéro était indispensable : on note un numéro le jour où on le
range et on en recopie le sommaire plus tard. Sans lui, couverture et une
n'auraient existé qu'à la création, c'est-à-dire jamais.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-21 11:25:29 +02:00

92 lines
3.0 KiB
C#

using System.Text.Json.Serialization;
using MaBibli.Shared.Textes;
namespace MaBibli.Shared.Dtos;
/// <summary>
/// Une revue et les numéros qu'on en possède.
/// </summary>
/// <remarks>
/// Comme pour les séries, <b>une seule lecture rend tout</b> : la liste des revues sert aussi
/// le détail de chacune, ce qui donne un unique instantané hors-ligne à tenir à jour.
/// </remarks>
public record RevueDto
{
public required int Id { get; init; }
public required string Titre { get; init; }
/// <summary>ISSN à tiret, quand il est connu. Identifiant de la <b>revue</b>, jamais un ISBN.</summary>
public string? Issn { get; init; }
public string? Editeur { get; init; }
public string? AjoutePar { get; init; }
/// <summary>Numéros possédés, du plus récent au plus ancien.</summary>
public IReadOnlyList<NumeroRevueDto> Numeros { get; init; } = [];
}
/// <summary>Un numéro possédé. Recensé seulement : ni prêt, ni statut de lecture.</summary>
public record NumeroRevueDto
{
public required int Id { get; init; }
public required string Numero { get; init; }
public DateTime? DateParution { get; init; }
public string? Note { get; init; }
/// <summary>Couverture du numéro, quand une URL a été collée. Aucune source ne la fournit.</summary>
public string? CoverUrl { get; init; }
/// <summary>Articles annoncés à la une, dans l'ordre de saisie.</summary>
public IReadOnlyList<string> Articles { get; init; } = [];
}
/// <summary>Charge utile de création ou de modification d'une revue.</summary>
public record EnregistrementRevue
{
public string Titre { get; set; } = string.Empty;
public string? Issn { get; set; }
public string? Editeur { get; set; }
}
/// <summary>Charge utile d'ajout ou de modification d'un numéro.</summary>
public record AjoutNumeroRevue
{
/// <summary>Obligatoire : deux numéros sans numéro seraient indiscernables.</summary>
public string Numero { get; set; } = string.Empty;
public DateTime? DateParution { get; set; }
public string? Note { get; set; }
/// <summary>
/// URL d'une image de couverture. <b>Aucune source ne peut la fournir</b> — l'ISSN désigne
/// la revue, pas la parution : elle est collée à la main, ou absente.
/// </summary>
public string? CoverUrl { get; set; }
/// <summary>Articles à la une, dans l'ordre de la couverture.</summary>
public List<string> Articles { get; set; } = [];
/// <summary>
/// Vue « une seule ligne » des <see cref="Articles"/>, pour un champ de saisie simple.
/// </summary>
/// <remarks>
/// ⚠️ Séparateur : le <b>point-virgule</b> seul, contrairement aux thèmes d'un livre. Un
/// titre d'article contient souvent une virgule (« Ukraine, deux ans après »), qui le
/// couperait en deux.
/// </remarks>
[JsonIgnore]
public string? ArticlesTexte
{
get => Articles.Count == 0 ? null : ListeSaisie.Joindre(Articles);
set => Articles = ListeSaisie.Decouper(value, virguleAussi: false);
}
}