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:
@@ -62,9 +62,13 @@ public sealed class ServiceCatalogue(MaBibliDbContext db, IServiceAuteurs auteur
|
||||
|
||||
var livres = await requete.ToListAsync(ct);
|
||||
|
||||
var statuts = await StatutsAsync(livres.Select(l => l.Id).ToList(), utilisateur, ct);
|
||||
var ids = livres.Select(l => l.Id).ToList();
|
||||
var statuts = await StatutsAsync(ids, utilisateur, ct);
|
||||
var prets = await PretsOuvertsAsync(ids, ct);
|
||||
|
||||
return livres.Select(l => Projeter(l, statuts.GetValueOrDefault(l.Id))).ToList();
|
||||
return livres
|
||||
.Select(l => Projeter(l, statuts.GetValueOrDefault(l.Id), prets.GetValueOrDefault(l.Id)))
|
||||
.ToList();
|
||||
}
|
||||
|
||||
public async Task<LivreDto?> ObtenirAsync(int id, string? utilisateur, CancellationToken ct = default)
|
||||
@@ -80,7 +84,8 @@ public sealed class ServiceCatalogue(MaBibliDbContext db, IServiceAuteurs auteur
|
||||
}
|
||||
|
||||
var statuts = await StatutsAsync([id], utilisateur, ct);
|
||||
return Projeter(livre, statuts.GetValueOrDefault(id));
|
||||
var prets = await PretsOuvertsAsync([id], ct);
|
||||
return Projeter(livre, statuts.GetValueOrDefault(id), prets.GetValueOrDefault(id));
|
||||
}
|
||||
|
||||
public async Task<ResultatEcriture> CreerAsync(
|
||||
@@ -198,6 +203,32 @@ public sealed class ServiceCatalogue(MaBibliDbContext db, IServiceAuteurs auteur
|
||||
.ToDictionaryAsync(s => s.LivreId, s => (Statut?)s.Statut, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Prêt en cours de chacun des livres demandés, quand il y en a un.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <b>Aucun paramètre « utilisateur » ici, volontairement</b> : contrairement au statut de
|
||||
/// lecture, un livre absent l'est pour tout le foyer. La question « où est ce livre ? » a une
|
||||
/// seule réponse, la même pour tout le monde.
|
||||
/// <para>
|
||||
/// L'index unique partiel sur <c>Prets</c> garantit qu'il n'y a qu'un prêt ouvert par livre :
|
||||
/// ce dictionnaire ne peut donc pas avoir à départager deux candidats.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
private async Task<Dictionary<int, Pret>> PretsOuvertsAsync(
|
||||
IReadOnlyList<int> livreIds, CancellationToken ct)
|
||||
{
|
||||
if (livreIds.Count == 0)
|
||||
{
|
||||
return [];
|
||||
}
|
||||
|
||||
return await db.Prets
|
||||
.AsNoTracking()
|
||||
.Where(p => p.DateRetour == null && livreIds.Contains(p.LivreId))
|
||||
.ToDictionaryAsync(p => p.LivreId, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Pose, met à jour ou retire le statut de lecture d'une personne pour un livre.
|
||||
/// </summary>
|
||||
@@ -303,7 +334,7 @@ public sealed class ServiceCatalogue(MaBibliDbContext db, IServiceAuteurs auteur
|
||||
private static string? Vide(string? valeur) =>
|
||||
string.IsNullOrWhiteSpace(valeur) ? null : valeur.Trim();
|
||||
|
||||
private static LivreDto Projeter(Livre livre, Statut? statut) => new()
|
||||
private static LivreDto Projeter(Livre livre, Statut? statut, Pret? pretOuvert = null) => new()
|
||||
{
|
||||
Id = livre.Id,
|
||||
Isbn = livre.Isbn,
|
||||
@@ -319,5 +350,7 @@ public sealed class ServiceCatalogue(MaBibliDbContext db, IServiceAuteurs auteur
|
||||
CoverUrl = livre.CoverUrl,
|
||||
DateAjout = livre.DateAjout,
|
||||
AjoutePar = livre.AjoutePar,
|
||||
PreteA = pretOuvert?.Emprunteur,
|
||||
PreteDepuis = pretOuvert?.DatePret,
|
||||
};
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user