Gerer les prets : API, ecrans et contrainte en base

L'entite Pret existait depuis le squelette sans jamais etre exploitee. Cette
phase la met en service de bout en bout.

API
- GET  /api/prets/en-cours       ce qui n'est pas a la maison, du plus ancien
                                 au plus recent : on cherche le livre oublie,
                                 pas celui prete hier
- POST /api/livres/{id}/prets    preter
- GET  /api/livres/{id}/prets    historique complet, du plus recent au plus
                                 ancien
- POST /api/prets/{id}/retour    clore le pret sans le supprimer

Un livre deja sorti ne peut pas etre prete une seconde fois. Le service le
verifie et nomme celui qui l'a deja, mais entre sa verification et l'insertion
il reste une fenetre : un index unique PARTIEL (LivreId WHERE DateRetour IS
NULL) la ferme, tout en laissant l'historique accumuler autant de prets clos
que necessaire sur le meme livre.

Les ebooks sont refuses cote API, pas seulement grises dans l'interface : une
fiche n'a pas d'exemplaire a confier.

Les prets sont COMMUNS au foyer, symetrique inverse du statut de lecture. Le
service ne recoit meme pas d'identite, pour qu'on ne puisse pas s'en servir
par inadvertance.

Interface, pensee mobile d'abord
- ecran « Prets en cours » avec bouton « Rendu » a meme la liste
- bloc pret sur la fiche d'un livre : etat courant, action, puis historique
- etiquette « Prete a X » dans le catalogue
- la barre d'actions passe sur deux lignes plutot que de comprimer ses
  libelles maintenant qu'elle compte quatre entrees

Toutes les dates sont en UTC ; le client convertit la date locale du
<input type="date"> avant l'envoi, faute de quoi le pret se decalerait d'un
jour pour la moitie du globe.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
mathieu
2026-08-18 02:45:01 +02:00
co-authored by Claude Opus 5
parent ab878b4d3c
commit 2a3dfb88de
18 changed files with 1656 additions and 13 deletions
+18 -2
View File
@@ -15,8 +15,9 @@ public record AuteurDto
}
/// <summary>
/// Un livre tel qu'exposé par l'API. Volontairement sans la collection <c>Prets</c> :
/// les prêts sont la phase 4.
/// Un livre tel qu'exposé par l'API. Volontairement <b>sans</b> la collection de ses prêts :
/// le catalogue n'a besoin que de savoir si le livre est dehors, et l'historique complet se
/// demande à part (<c>GET /api/livres/{id}/prets</c>) pour ne pas alourdir chaque liste.
/// </summary>
public record LivreDto
{
@@ -53,6 +54,21 @@ public record LivreDto
/// </summary>
public string? AjoutePar { get; init; }
/// <summary>
/// Nom de la personne qui a le livre en ce moment, ou <c>null</c> s'il est à la maison.
/// </summary>
/// <remarks>
/// <b>Commun à tout le foyer</b>, contrairement au statut de lecture : un livre absent l'est
/// pour tout le monde. Renseigné depuis le prêt ouvert du livre — il ne peut y en avoir qu'un.
/// </remarks>
public string? PreteA { get; init; }
/// <summary>Date du prêt en cours, s'il y en a un.</summary>
public DateTime? PreteDepuis { get; init; }
[JsonIgnore]
public bool EstPrete => PreteA is not null;
/// <summary>Auteurs sur une ligne, pour un affichage compact.</summary>
[JsonIgnore]
public string? AuteursAffiches =>
+69
View File
@@ -0,0 +1,69 @@
using System.Text.Json.Serialization;
namespace MaBibli.Shared.Dtos;
/// <summary>
/// Un prêt tel qu'exposé par l'API — en cours ou clos, la table gardant l'historique complet.
/// </summary>
/// <remarks>
/// Les champs <c>Livre*</c> recopient de quoi afficher le livre sans second appel : la vue
/// « prêts en cours » liste des prêts, mais ce que l'utilisateur y cherche est <b>le livre</b>
/// qui n'est plus à la maison.
/// </remarks>
public record PretDto
{
public required int Id { get; init; }
public required int LivreId { get; init; }
/// <summary>Nom de l'emprunteur, texte libre : aucun lien avec les comptes YunoHost.</summary>
public required string Emprunteur { get; init; }
public required DateTime DatePret { get; init; }
/// <summary><c>null</c> tant que le livre n'a pas été rendu.</summary>
public DateTime? DateRetour { get; init; }
public string? LivreTitre { get; init; }
/// <summary>Auteurs du livre sur une ligne, déjà mis en forme par le serveur.</summary>
public string? LivreAuteurs { get; init; }
public string? LivreCoverUrl { get; init; }
[JsonIgnore]
public bool EstEnCours => DateRetour is null;
/// <summary>Nombre de jours écoulés depuis le départ du livre — ou durée totale s'il est rendu.</summary>
[JsonIgnore]
public int JoursEcoules =>
Math.Max(0, (int)((DateRetour ?? DateTime.UtcNow) - DatePret).TotalDays);
}
/// <summary>Charge utile d'un nouveau prêt.</summary>
/// <remarks>
/// Le livre n'y figure pas : il vient de l'URL. On ne prête pas « un livre quelconque », on prête
/// <b>ce</b> livre-ci, depuis sa fiche.
/// </remarks>
public record EnregistrementPret
{
/// <summary>Obligatoire : un prêt sans emprunteur ne se retrouve pas.</summary>
public string Emprunteur { get; set; } = string.Empty;
/// <summary>
/// Date du prêt en UTC. <c>null</c> = maintenant.
/// </summary>
/// <remarks>
/// Modifiable parce qu'on enregistre souvent un prêt <b>après</b> l'avoir fait — « tiens,
/// Paul a mon Zola depuis Noël ». Une date future est en revanche refusée : elle ne
/// correspondrait à rien de constatable.
/// </remarks>
public DateTime? DatePret { get; set; }
}
/// <summary>Charge utile du retour d'un livre.</summary>
public record RetourPret
{
/// <summary>Date du retour en UTC. <c>null</c> = maintenant.</summary>
public DateTime? DateRetour { get; set; }
}