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
@@ -111,6 +111,59 @@ public sealed class ServiceLivresApi(HttpClient http)
return reponse.IsSuccessStatusCode ? null : await MessageErreurAsync(reponse, ct);
}
/// <summary>Les livres actuellement dehors, du prêt le plus ancien au plus récent.</summary>
public async Task<IReadOnlyList<PretDto>> ListerPretsEnCoursAsync(CancellationToken ct = default) =>
await http.GetFromJsonAsync<List<PretDto>>("api/prets/en-cours", Json, ct) ?? [];
/// <summary>
/// Historique complet des prêts d'un livre, du plus récent au plus ancien.
/// </summary>
/// <remarks>Liste vide = jamais prêté ; <c>null</c> = livre inconnu.</remarks>
public async Task<IReadOnlyList<PretDto>?> ListerPretsLivreAsync(int livreId, CancellationToken ct = default)
{
var reponse = await http.GetAsync($"api/livres/{livreId}/prets", ct);
return reponse.StatusCode == HttpStatusCode.NotFound
? null
: await LireAsync<List<PretDto>>(reponse, ct);
}
/// <summary>
/// Prête un livre. <paramref name="datePret"/> est une date <b>locale</b>, convertie ici en
/// UTC : tout ce que l'API stocke est en UTC, comme le reste des dates du projet.
/// </summary>
public async Task<ResultatApi<PretDto>> PreterAsync(
int livreId, string emprunteur, DateTime? datePret = null, CancellationToken ct = default)
{
var saisie = new EnregistrementPret
{
Emprunteur = emprunteur,
DatePret = EnUtc(datePret),
};
var reponse = await http.PostAsJsonAsync($"api/livres/{livreId}/prets", saisie, Json, ct);
return await InterpreterAsync<PretDto>(reponse, ct);
}
/// <summary>Clôt un prêt. Le prêt n'est pas supprimé : il devient l'historique du livre.</summary>
public async Task<ResultatApi<PretDto>> RendreAsync(
int pretId, DateTime? dateRetour = null, CancellationToken ct = default)
{
var reponse = await http.PostAsJsonAsync(
$"api/prets/{pretId}/retour", new RetourPret { DateRetour = EnUtc(dateRetour) }, Json, ct);
return await InterpreterAsync<PretDto>(reponse, ct);
}
/// <summary>
/// Convertit une date issue d'un &lt;input type="date"&gt; en instant UTC.
/// </summary>
/// <remarks>
/// Le navigateur produit une date sans fuseau (minuit, « Unspecified ») : l'envoyer telle
/// quelle décalerait le prêt d'un jour pour la moitié du globe. On la déclare locale avant
/// de la convertir, ce qui est bien ce que l'utilisateur voulait dire en la choisissant.
/// </remarks>
private static DateTime? EnUtc(DateTime? date) =>
date is null ? null : DateTime.SpecifyKind(date.Value, DateTimeKind.Local).ToUniversalTime();
public async Task<string?> SupprimerAsync(int id, CancellationToken ct = default)
{
var reponse = await http.DeleteAsync($"api/livres/{id}", ct);