Créer un abonnement

Reviewed-on: #8

my-library/src/App.jsx

@@ -10,6 +10,8 @@ import BookDetail from './pages/BookDetail';
 import Customers from './pages/Customers';
 import Login from './pages/Login';
 import Reservations from './pages/Reservations';
+import Returns from './pages/Returns';
+import Subscription from './pages/Subscription';
 import { useAuth } from './context/AuthContext';
 
 function RequireAuth({ children }) {
@@ -37,6 +39,8 @@ export default function App() {
         <Route path="reservations" element={<RequireAuth><Reservations /></RequireAuth>} />
         <Route path="profile" element={<RequireAuth><Profile /></RequireAuth>} />
         <Route path="customers" element={<RequireAdmin><Customers /></RequireAdmin>} />
+        <Route path="returns" element={<RequireAdmin><Returns /></RequireAdmin>} />
+        <Route path="subscription" element={<RequireAuth><Subscription /></RequireAuth>} />
         <Route path="*" element={<NotFound />} />
       </Route>
     </Routes>

my-library/src/api/orders.js

@@ -0,0 +1,5 @@
+import client from './client';
+
+export function createOrder(order) {
+  return client.post('/api/orders', order);
+}

my-library/src/components/Navbar.jsx

@@ -20,8 +20,10 @@ export default function Navbar() {
         <li><Link to="/books">Catalogue</Link></li>
         {user && <li><Link to="/orders">Commandes</Link></li>}
         {user?.role === 'user' && <li><Link to="/reservations">Mes réservations</Link></li>}
+        {user?.role === 'user' && <li><Link to="/subscription">Mon abonnement</Link></li>}
         {user && <li><Link to="/profile">Mon compte</Link></li>}
         {user?.role === 'admin' && <li><Link to="/customers">Clients</Link></li>}
+        {user?.role === 'admin' && <li><Link to="/returns">Retours</Link></li>}
       </ul>
 
       <div className="navbar__actions">

my-library/src/context/ReturnContext.js

@@ -0,0 +1,36 @@
+import { createContext, useContext, useState } from 'react';
+
+const ReturnContext = createContext(null);
+
+export function ReturnProvider({ children }) {
+  const [returns, setReturns] = useState(() => {
+    const saved = localStorage.getItem('returns');
+    return saved ? JSON.parse(saved) : [];
+  });
+
+  function addReturn(bookId, bookTitle, customerPhone, reason) {
+    const bookReturn = {
+      returnId: crypto.randomUUID(),
+      bookId,
+      bookTitle,
+      customerPhone,
+      reason,
+      status: 'PROCESSED',
+      returnedAt: new Date().toISOString(),
+    };
+    const updated = [...returns, bookReturn];
+    setReturns(updated);
+    localStorage.setItem('returns', JSON.stringify(updated));
+    return bookReturn;
+  }
+
+  return (
+    <ReturnContext.Provider value={{ returns, addReturn }}>
+      {children}
+    </ReturnContext.Provider>
+  );
+}
+
+export function useReturns() {
+  return useContext(ReturnContext);
+}

my-library/src/context/ReviewContext.js

@@ -0,0 +1,40 @@
+import { createContext, useContext, useState } from 'react';
+
+const ReviewContext = createContext(null);
+
+export function ReviewProvider({ children }) {
+  const [reviews, setReviews] = useState(() => {
+    const saved = localStorage.getItem('reviews');
+    return saved ? JSON.parse(saved) : [];
+  });
+
+  function addReview(bookId, bookTitle, username, rating, comment) {
+    const review = {
+      reviewId: crypto.randomUUID(),
+      bookId,
+      bookTitle,
+      username,
+      rating,
+      comment,
+      createdAt: new Date().toISOString(),
+    };
+    const updated = [...reviews, review];
+    setReviews(updated);
+    localStorage.setItem('reviews', JSON.stringify(updated));
+    return review;
+  }
+
+  function getReviewsByBook(bookId) {
+    return reviews.filter(r => String(r.bookId) === String(bookId));
+  }
+
+  return (
+    <ReviewContext.Provider value={{ reviews, addReview, getReviewsByBook }}>
+      {children}
+    </ReviewContext.Provider>
+  );
+}
+
+export function useReviews() {
+  return useContext(ReviewContext);
+}

my-library/src/context/SubscriptionContext.js

@@ -0,0 +1,50 @@
+import { createContext, useContext, useState } from 'react';
+
+const SubscriptionContext = createContext(null);
+
+const PLANS = [
+  { id: 'basic', name: 'Basic', price: 9.99, description: '2 livres par mois' },
+  { id: 'standard', name: 'Standard', price: 14.99, description: '5 livres par mois' },
+  { id: 'premium', name: 'Premium', price: 24.99, description: 'Livres illimités par mois' },
+];
+
+export { PLANS };
+
+export function SubscriptionProvider({ children }) {
+  const [subscription, setSubscription] = useState(() => {
+    const saved = localStorage.getItem('subscription');
+    return saved ? JSON.parse(saved) : null;
+  });
+
+  function subscribe(planId, phoneNumber) {
+    const plan = PLANS.find(p => p.id === planId);
+    const newSubscription = {
+      subscriptionId: crypto.randomUUID(),
+      planId,
+      planName: plan.name,
+      price: plan.price,
+      phoneNumber,
+      status: 'ACTIVE',
+      startDate: new Date().toISOString(),
+    };
+    setSubscription(newSubscription);
+    localStorage.setItem('subscription', JSON.stringify(newSubscription));
+    return newSubscription;
+  }
+
+  function cancelSubscription() {
+    const updated = { ...subscription, status: 'CANCELLED' };
+    setSubscription(updated);
+    localStorage.setItem('subscription', JSON.stringify(updated));
+  }
+
+  return (
+    <SubscriptionContext.Provider value={{ subscription, subscribe, cancelSubscription, PLANS }}>
+      {children}
+    </SubscriptionContext.Provider>
+  );
+}
+
+export function useSubscription() {
+  return useContext(SubscriptionContext);
+}

my-library/src/index.js

@@ -3,6 +3,9 @@ import ReactDOM from 'react-dom/client';
 import { BrowserRouter } from 'react-router-dom';
 import { AuthProvider } from './context/AuthContext';
 import { ReservationProvider } from './context/ReservationContext';
+import { ReviewProvider } from './context/ReviewContext';
+import { ReturnProvider } from './context/ReturnContext';
+import { SubscriptionProvider } from './context/SubscriptionContext';
 import App from './App';
 import './styles/global.css';
 
@@ -12,7 +15,13 @@ root.render(
     <BrowserRouter>
       <AuthProvider>
         <ReservationProvider>
+          <ReviewProvider>
+            <ReturnProvider>
+              <SubscriptionProvider>
                 <App />
+              </SubscriptionProvider>
+            </ReturnProvider>
+          </ReviewProvider>
         </ReservationProvider>
       </AuthProvider>
     </BrowserRouter>

my-library/src/pages/BookDetail.jsx

@@ -3,10 +3,17 @@ import { useParams, Link } from 'react-router-dom';
 import { getBookById } from '../api/books';
 import { useAuth } from '../context/AuthContext';
 import { useReservations } from '../context/ReservationContext';
+import { useReviews } from '../context/ReviewContext';
+import { useSubscription } from '../context/SubscriptionContext';
 
 export default function BookDetail() {
   const { user } = useAuth();
-  const { addReservation } = useReservations();
+  const { subscription } = useSubscription();
+  const { addReservation, reservations } = useReservations();
+  const { addReview, getReviewsByBook } = useReviews();
+  const [rating, setRating] = useState(5);
+  const [comment, setComment] = useState('');
+  const [reviewStatus, setReviewStatus] = useState(null);
   const { bookId } = useParams();
   const [book, setBook] = useState(null);
   const [loading, setLoading] = useState(true);
@@ -23,6 +30,14 @@ export default function BookDetail() {
     setPhoneNumber('');
   }
 
+  function handleReview(e) {
+    e.preventDefault();
+    addReview(book.isbn, book.title, user.username, Number(rating), comment);
+    setReviewStatus({ success: true, message: 'Avis publié avec succès !' });
+    setComment('');
+    setRating(5);
+  }
+
   if (loading) return <main><p>Chargement…</p></main>;
   if (error) return <main><p>{error}</p><Link to="/books">← Retour au catalogue</Link></main>;
 
@@ -40,8 +55,81 @@ export default function BookDetail() {
       <p>Catégories : {book.categories?.join(', ')}</p>
       {book.description && <p>{book.description}</p>}
 
-      {user?.role === 'user' && <section>
+      <section>
+        <h2>Avis des lecteurs</h2>
+        {getReviewsByBook(book.isbn).length === 0 ? (
+          <p>Aucun avis pour le moment.</p>
+        ) : (
+          <ul>
+            {getReviewsByBook(book.isbn).map(r => (
+              <li key={r.reviewId}>
+                <strong>{r.username}</strong> — {'*'.repeat(r.rating)}
+                <br />
+                {r.comment}
+                <br />
+                <small>{new Date(r.createdAt).toLocaleDateString('fr-FR')}</small>
+              </li>
+            ))}
+          </ul>
+        )}
+        {user?.role === 'user' && (
+          <form onSubmit={handleReview}>
+            <h3>Laisser un avis</h3>
+            <label>
+              Note :
+              <select value={rating} onChange={e => setRating(e.target.value)}>
+                <option value={1}>*</option>
+                <option value={2}>**</option>
+                <option value={3}>***</option>
+                <option value={4}>****</option>
+                <option value={5}>*****</option>
+              </select>
+            </label>
+            <label>
+              Commentaire :
+              <textarea value={comment} onChange={e => setComment(e.target.value)} required />
+            </label>
+            <button type="submit">Publier l'avis</button>
+          </form>
+        )}
+        {reviewStatus && (
+          <p style={{ color: reviewStatus.success ? 'green' : 'red' }}>
+            {reviewStatus.message}
+          </p>
+        )}
+      </section>
+
+      {user?.role === 'user' && (
+        <section>
           <h2>Réserver ce livre</h2>
+          {!subscription || subscription.status !== 'ACTIVE' ? (
+            <p>
+              Vous devez avoir un abonnement actif pour réserver un livre.{' '}
+              <Link to="/subscription">S'abonner</Link>
+            </p>
+          ) : (() => {
+            const QUOTAS = { basic: 2, standard: 5, premium: Infinity };
+            const quota = QUOTAS[subscription.planId];
+            const thisMonthStart = new Date();
+            thisMonthStart.setDate(1);
+            thisMonthStart.setHours(0, 0, 0, 0);
+            const usedThisMonth = reservations.filter(r =>
+              new Date(r.reservedAt) >= thisMonthStart
+            ).length;
+            const remaining = quota - usedThisMonth;
+
+            if (remaining <= 0) {
+              return (
+                <p style={{ color: 'orange' }}>
+                  Vous avez atteint votre quota de {quota} réservation(s) ce mois-ci.
+                  <Link to="/subscription"> Passer au plan supérieur</Link>
+                </p>
+              );
+            }
+
+            return (
+              <>
+                <p>Réservations restantes ce mois : <strong>{remaining === Infinity ? 'illimitées' : remaining}</strong></p>
                 <form onSubmit={handleReservation}>
                   <label>
                     Numéro de téléphone :
@@ -60,7 +148,11 @@ export default function BookDetail() {
                     {reservationStatus.message}
                   </p>
                 )}
-      </section>}
+              </>
+            );
+          })()}
+        </section>
+      )}
     </main>
   );
 }

my-library/src/pages/Orders.jsx

@@ -1,3 +1,91 @@
+import { useState } from 'react';
+import { createOrder } from '../api/orders';
+
 export default function Orders() {
-  return <main><h1>Mes commandes</h1></main>;
+  const [customerId, setCustomerId] = useState('');
+  const [paymentMethod, setPaymentMethod] = useState('CREDIT_CARD');
+  const [address, setAddress] = useState({ street: '', city: '', postalCode: '', country: '' });
+  const [lines, setLines] = useState([{ bookId: '', quantity: 1 }]);
+  const [message, setMessage] = useState(null);
+  const [submitting, setSubmitting] = useState(false);
+
+  function handleAddressChange(e) {
+    const { name, value } = e.target;
+    setAddress((prev) => ({ ...prev, [name]: value }));
+  }
+
+  function handleLineChange(index, field, value) {
+    setLines((prev) => prev.map((line, i) => (i === index ? { ...line, [field]: value } : line)));
+  }
+  function addLine() {
+    setLines((prev) => [...prev, { bookId: '', quantity: 1 }]);
+  }
+  function removeLine(index) {
+    setLines((prev) => prev.filter((_, i) => i !== index));
+  }
+
+  function handleSubmit(e) {
+    e.preventDefault();
+    setSubmitting(true);
+    setMessage(null);
+
+    const payload = {
+      customerId,
+      paymentMethod,
+      address,
+      orderLineDtos: lines.map((line) => ({
+        bookId: Number(line.bookId),
+        quantity: Number(line.quantity),
+      })),
+    };
+
+    createOrder(payload)
+      .then((response) => setMessage('Commande créée'))
+      .catch((error) => {
+        console.error(error);
+        setMessage(error.response?.data?.message || 'Erreur lors de la commande.');
+      })
+      .finally(() => setSubmitting(false));
+  }
+
+  return (
+    <main>
+      <h1>Passer une commande</h1>
+      <form onSubmit={handleSubmit}>
+        <label>ID client
+          <input value={customerId} onChange={(e) => setCustomerId(e.target.value)} required />
+        </label>
+
+        <h2>Livres</h2>
+        {lines.map((line, index) => (
+          <div key={index}>
+            <input type="number" placeholder="ISBN du livre" value={line.bookId}
+              onChange={(e) => handleLineChange(index, 'bookId', e.target.value)} required />
+            <input type="number" placeholder="Quantité" value={line.quantity}
+              onChange={(e) => handleLineChange(index, 'quantity', e.target.value)} required />
+            {lines.length > 1 && (
+              <button type="button" onClick={() => removeLine(index)}>Retirer</button>
+            )}
+          </div>
+        ))}
+        <button type="button" onClick={addLine}>+ Ajouter un livre</button>
+
+        <h2>Adresse de livraison</h2>
+        <input name="street" placeholder="Rue" value={address.street} onChange={handleAddressChange} required />
+        <input name="city" placeholder="Ville" value={address.city} onChange={handleAddressChange} required />
+        <input name="postalCode" placeholder="Code postal" value={address.postalCode} onChange={handleAddressChange} required />
+        <input name="country" placeholder="Pays" value={address.country} onChange={handleAddressChange} required />
+
+        <h2>Paiement</h2>
+        <select value={paymentMethod} onChange={(e) => setPaymentMethod(e.target.value)}>
+          <option value="CREDIT_CARD">Carte bancaire</option>
+        </select>
+
+        <button type="submit" disabled={submitting}>
+          {submitting ? 'Envoi…' : 'Valider la commande'}
+        </button>
+      </form>
+      {message && <p>{message}</p>}
+    </main>
+  );
 }

my-library/src/pages/Returns.jsx

@@ -0,0 +1,96 @@
+import { useState } from 'react';
+import { useReturns } from '../context/ReturnContext';
+import { getBooks } from '../api/books';
+import { useEffect } from 'react';
+
+export default function Returns() {
+  const { returns, addReturn } = useReturns();
+  const [books, setBooks] = useState([]);
+  const [form, setForm] = useState({ bookId: '', customerPhone: '', reason: '' });
+  const [message, setMessage] = useState(null);
+
+  useEffect(() => {
+    getBooks(0, 100).then(res => setBooks(res.data.content)).catch(console.error);
+  }, []);
+
+  function handleChange(e) {
+    const { name, value } = e.target;
+    setForm(f => ({ ...f, [name]: value }));
+  }
+
+  function handleSubmit(e) {
+    e.preventDefault();
+    const book = books.find(b => String(b.isbn) === String(form.bookId));
+    const bookTitle = book ? book.title : form.bookId;
+    addReturn(form.bookId, bookTitle, form.customerPhone, form.reason);
+    setMessage({ success: true, text: 'Retour enregistré avec succès !' });
+    setForm({ bookId: '', customerPhone: '', reason: '' });
+  }
+
+  return (
+    <main>
+      <h1>Gestion des retours</h1>
+
+      <section>
+        <h2>Enregistrer un retour</h2>
+        <form onSubmit={handleSubmit}>
+          <label>
+            Livre :
+            <select name="bookId" value={form.bookId} onChange={handleChange} required>
+              <option value="">-- Choisir un livre --</option>
+              {books.map(b => (
+                <option key={b.isbn} value={b.isbn}>{b.title} — {b.author}</option>
+              ))}
+            </select>
+          </label>
+          <label>
+            Téléphone du client :
+            <input
+              name="customerPhone"
+              type="tel"
+              value={form.customerPhone}
+              onChange={handleChange}
+              placeholder="0612345678"
+              required
+            />
+          </label>
+          <label>
+            Motif :
+            <textarea
+              name="reason"
+              value={form.reason}
+              onChange={handleChange}
+              placeholder="Motif du retour..."
+              required
+            />
+          </label>
+          <button type="submit">Enregistrer le retour</button>
+        </form>
+        {message && <p style={{ color: message.success ? 'green' : 'red' }}>{message.text}</p>}
+      </section>
+
+      <section>
+        <h2>Historique des retours</h2>
+        {returns.length === 0 ? (
+          <p>Aucun retour enregistré.</p>
+        ) : (
+          <ul>
+            {returns.map(r => (
+              <li key={r.returnId}>
+                <strong>{r.bookTitle}</strong>
+                <br />
+                Client : {r.customerPhone}
+                <br />
+                Motif : {r.reason}
+                <br />
+                Statut : {r.status}
+                <br />
+                <small>{new Date(r.returnedAt).toLocaleDateString('fr-FR')}</small>
+              </li>
+            ))}
+          </ul>
+        )}
+      </section>
+    </main>
+  );
+}

my-library/src/pages/Subscription.jsx

@@ -0,0 +1,74 @@
+import { useState } from 'react';
+import { useSubscription } from '../context/SubscriptionContext';
+
+export default function Subscription() {
+  const { subscription, subscribe, cancelSubscription, PLANS } = useSubscription();
+  const [selectedPlan, setSelectedPlan] = useState('basic');
+  const [phoneNumber, setPhoneNumber] = useState('');
+  const [message, setMessage] = useState(null);
+
+  function handleSubscribe(e) {
+    e.preventDefault();
+    subscribe(selectedPlan, phoneNumber);
+    setMessage({ success: true, text: 'Abonnement créé avec succès !' });
+    setPhoneNumber('');
+  }
+
+  function handleCancel() {
+    cancelSubscription();
+    setMessage({ success: false, text: 'Abonnement annulé.' });
+  }
+
+  return (
+    <main>
+      <h1>Mon abonnement</h1>
+
+      {subscription && subscription.status === 'ACTIVE' ? (
+        <section>
+          <h2>Abonnement actif</h2>
+          <p>Plan : <strong>{subscription.planName}</strong></p>
+          <p>Prix : <strong>{subscription.price} € / mois</strong></p>
+          <p>Téléphone : {subscription.phoneNumber}</p>
+          <p>Depuis le : {new Date(subscription.startDate).toLocaleDateString('fr-FR')}</p>
+          <p>Statut : <strong style={{ color: 'green' }}>{subscription.status}</strong></p>
+          <button onClick={handleCancel}>Annuler l'abonnement</button>
+        </section>
+      ) : (
+        <section>
+          <h2>Choisir un abonnement</h2>
+          <form onSubmit={handleSubscribe}>
+            <div>
+              {PLANS.map(plan => (
+                <label key={plan.id} style={{ display: 'block', marginBottom: '8px' }}>
+                  <input
+                    type="radio"
+                    name="plan"
+                    value={plan.id}
+                    checked={selectedPlan === plan.id}
+                    onChange={() => setSelectedPlan(plan.id)}
+                  />
+                  {' '}<strong>{plan.name}</strong> , {plan.price} € / mois , {plan.description}
+                </label>
+              ))}
+            </div>
+            <label>
+              Numéro de téléphone :
+              <input
+                type="tel"
+                value={phoneNumber}
+                onChange={e => setPhoneNumber(e.target.value)}
+                placeholder="0612345678"
+                required
+              />
+            </label>
+            <button type="submit">S'abonner</button>
+          </form>
+        </section>
+      )}
+
+      {message && (
+        <p style={{ color: message.success ? 'green' : 'red' }}>{message.text}</p>
+      )}
+    </main>
+  );
+}

mylibrary/README.md

@@ -0,0 +1,78 @@
+# mylibrary — back-end Java (méthode BDD)
+
+Back-end du projet **2026-DEV-BUT3**. Reproduit, en Java pur, le cœur métier
+de l'API consommée par le front React `my-library/`.
+
+## Méthode
+
+Conformément au cours `maintenanceApplicativeCours1.pdf` (Behavior-Driven
+Development), pour chaque comportement on :
+
+1. Écrit le scénario attendu (en Gherkin / `.feature` ou en `@DisplayName` JUnit)
+2. Écrit le test qui le vérifie
+3. Implémente le code qui fait passer le test
+
+## Structure (calquée sur le module `customer` fourni par le prof)
+
+```
+src/main/java/fr/iut_fbleau/but3/dev62/mylibrary/
+├─ customer/        Module fourni par l'enseignant (intact)
+│  ├─ CustomerInfo.java   record d'entrée
+│  ├─ CustomerDTO.java    DTO de sortie
+│  ├─ entity/             Customer (objet métier, règles fidélité)
+│  ├─ exception/          Exceptions métier
+│  ├─ converter/          Mapping Info <-> entity <-> DTO
+│  ├─ validator/          Règles de validation
+│  ├─ repository/         Stockage en mémoire (List)
+│  └─ usecase/            Cas d'usage (orchestration)
+└─ book/             Module développé en miroir (notre travail)
+   └─ … (mêmes sous-paquets, même découpage)
+
+src/test/java/.../mylibrary/
+├─ customer/         Tests JUnit fournis par l'enseignant
+├─ book/             Tests JUnit que nous avons écrits
+└─ features/
+   ├─ RunCucumberTest.java         (du prof, intact)
+   ├─ client/CustomerSteps.java    (du prof, intact)
+   ├─ book/BookSteps.java          (notre travail)
+   └─ resources/features/
+      ├─ client.feature            (du prof, intact)
+      └─ book.feature              (notre travail)
+```
+
+## Dépendances
+
+Strictement les mêmes que dans le template du prof :
+
+- JUnit 5 (jupiter-api, params, engine + platform-suite, platform-engine, platform-launcher)
+- Mockito (core, junit-jupiter)
+- Cucumber (cucumber-java, cucumber-junit-platform-engine)
+- Lombok
+
+## Build & test
+
+Pré-requis : **JDK 21** + **Maven 3.9+**
+
+```bash
+mvn -f mylibrary test
+```
+
+Cette commande exécute :
+
+- les tests unitaires JUnit (entity, validator, converter, repository, usecase, exceptions)
+- les scénarios Cucumber (`client.feature` + `book.feature`) via `RunCucumberTest`
+
+## Périmètre couvert
+
+Conformément à la consigne (« reproduire le strict nécessaire pour démontrer
+la maîtrise »), l'API se limite aux deux domaines présents dans le swagger
+qui structurent l'app React :
+
+- **Catalogue** (`book`) : enregistrer, consulter par ISBN, lister tous les livres,
+  refuser ISBN dupliqué, refuser un livre invalide, gérer le stock.
+- **Comptes clients** (`customer`) : enregistrer, consulter par téléphone, mettre
+  à jour, supprimer, ajouter / retirer des points de fidélité (module fourni).
+
+L'exposition HTTP réelle utilisée par les développeurs front est l'API du prof
+(`mylibrary-0.0.1-SNAPSHOT.jar`) ; ce module sert à démontrer la maîtrise
+de la **conception métier en BDD/TDD**.

mylibrary/src/main/java/fr/iut_fbleau/but3/dev62/mylibrary/book/usecase/BookUseCase.java

@@ -0,0 +1,46 @@
+package fr.iut_fbleau.but3.dev62.mylibrary.book.usecase;
+
+import fr.iut_fbleau.but3.dev62.mylibrary.book.BookDTO;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.BookInfo;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.converter.BookConverter;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.entity.Book;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.BookAlreadyExistsException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.BookNotFoundException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.NotValidBookException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.repository.BookRepository;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.validator.BookValidator;
+import java.util.List;
+import java.util.Optional;
+
+public final class BookUseCase {
+
+  private final BookRepository bookRepository;
+
+  public BookUseCase(BookRepository bookRepository) {
+    this.bookRepository = bookRepository;
+  }
+
+  public long registerBook(BookInfo bookInfo) throws NotValidBookException, BookAlreadyExistsException {
+    BookValidator.validate(bookInfo);
+    if (bookRepository.existsByIsbn(bookInfo.isbn())) {
+      throw new BookAlreadyExistsException(bookInfo.isbn());
+    }
+    Book toRegister = BookConverter.toDomain(bookInfo);
+    Book registered = bookRepository.save(toRegister);
+    return registered.getIsbn();
+  }
+
+  public BookDTO getBookByIsbn(long isbn) throws BookNotFoundException {
+    Optional<Book> optional = bookRepository.findByIsbn(isbn);
+    if (optional.isEmpty()) {
+      throw new BookNotFoundException(isbn);
+    }
+    return BookConverter.toDTO(optional.get());
+  }
+
+  public List<BookDTO> getAllBooks() {
+    return bookRepository.findAll().stream()
+        .map(BookConverter::toDTO)
+        .toList();
+  }
+}

mylibrary/src/test/java/fr/iut_fbleau/but3/dev62/mylibrary/book/usecase/BookUseCaseTest.java

@@ -0,0 +1,152 @@
+package fr.iut_fbleau.but3.dev62.mylibrary.book.usecase;
+
+import fr.iut_fbleau.but3.dev62.mylibrary.book.BookDTO;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.BookInfo;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.entity.Book;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.entity.Category;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.BookAlreadyExistsException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.BookNotFoundException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.NotValidBookException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.repository.BookRepository;
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Optional;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.*;
+
+@ExtendWith(MockitoExtension.class)
+class BookUseCaseTest {
+
+  @Mock
+  private BookRepository bookRepository;
+
+  @InjectMocks
+  private BookUseCase bookUseCase;
+
+  private BookInfo validInfo;
+  private Book validBook;
+
+  @BeforeEach
+  void setUp() {
+    validInfo = new BookInfo(
+        9780321125217L,
+        "DDD",
+        "Evans",
+        "Addison-Wesley",
+        LocalDate.of(2003, 8, 22),
+        54.99,
+        10,
+        List.of(Category.SCIENCE),
+        "desc",
+        "EN"
+    );
+    validBook = Book.builder()
+        .isbn(validInfo.isbn())
+        .title(validInfo.title())
+        .author(validInfo.author())
+        .publisher(validInfo.publisher())
+        .publicationDate(validInfo.publicationDate())
+        .price(validInfo.price())
+        .quantity(validInfo.quantity())
+        .categories(validInfo.categories())
+        .description(validInfo.description())
+        .language(validInfo.language())
+        .build();
+  }
+
+  @Nested
+  @DisplayName("registerBook tests")
+  class RegisterTests {
+
+    @Test
+    @DisplayName("Should register a new book and return its ISBN")
+    void testRegisterBook() throws NotValidBookException, BookAlreadyExistsException {
+      when(bookRepository.existsByIsbn(validInfo.isbn())).thenReturn(false);
+      when(bookRepository.save(any(Book.class))).thenReturn(validBook);
+
+      long isbn = bookUseCase.registerBook(validInfo);
+
+      assertEquals(validInfo.isbn(), isbn);
+      verify(bookRepository).existsByIsbn(validInfo.isbn());
+      verify(bookRepository).save(any(Book.class));
+    }
+
+    @Test
+    @DisplayName("Should reject invalid book information without touching the repository")
+    void testRegisterInvalidBook() {
+      BookInfo invalid = new BookInfo(0L, "", "", "", null, -1, -1, null, "", "");
+      assertThrows(NotValidBookException.class, () -> bookUseCase.registerBook(invalid));
+      verifyNoInteractions(bookRepository);
+    }
+
+    @Test
+    @DisplayName("Should reject duplicate ISBN")
+    void testRegisterDuplicate() {
+      when(bookRepository.existsByIsbn(validInfo.isbn())).thenReturn(true);
+      assertThrows(BookAlreadyExistsException.class, () -> bookUseCase.registerBook(validInfo));
+      verify(bookRepository).existsByIsbn(validInfo.isbn());
+      verify(bookRepository, never()).save(any(Book.class));
+    }
+  }
+
+  @Nested
+  @DisplayName("getBookByIsbn tests")
+  class GetByIdTests {
+
+    @Test
+    @DisplayName("Should return the BookDTO when ISBN exists")
+    void testGetById() throws BookNotFoundException {
+      when(bookRepository.findByIsbn(validInfo.isbn())).thenReturn(Optional.of(validBook));
+
+      BookDTO dto = bookUseCase.getBookByIsbn(validInfo.isbn());
+
+      assertEquals(validInfo.isbn(), dto.getIsbn());
+      assertEquals(validInfo.title(), dto.getTitle());
+    }
+
+    @Test
+    @DisplayName("Should throw when ISBN does not exist")
+    void testGetByIdNotFound() {
+      when(bookRepository.findByIsbn(99L)).thenReturn(Optional.empty());
+      assertThrows(BookNotFoundException.class, () -> bookUseCase.getBookByIsbn(99L));
+    }
+  }
+
+  @Nested
+  @DisplayName("getAllBooks tests")
+  class GetAllBooksTests {
+
+    @Test
+    @DisplayName("Should map every book returned by the repository to a DTO")
+    void testGetAllBooks() {
+      when(bookRepository.findAll()).thenReturn(List.of(validBook));
+
+      List<BookDTO> result = bookUseCase.getAllBooks();
+
+      assertEquals(1, result.size());
+      assertEquals(validBook.getIsbn(), result.getFirst().getIsbn());
+      assertEquals(validBook.getTitle(), result.getFirst().getTitle());
+      verify(bookRepository).findAll();
+    }
+
+    @Test
+    @DisplayName("Should return an empty list when no book is stored")
+    void testGetAllBooksWhenEmpty() {
+      when(bookRepository.findAll()).thenReturn(List.of());
+
+      List<BookDTO> result = bookUseCase.getAllBooks();
+
+      assertTrue(result.isEmpty());
+    }
+  }
+}

mylibrary/src/test/java/fr/iut_fbleau/but3/dev62/mylibrary/features/book/BookSteps.java

@@ -0,0 +1,106 @@
+package fr.iut_fbleau.but3.dev62.mylibrary.features.book;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
+import fr.iut_fbleau.but3.dev62.mylibrary.book.BookDTO;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.BookInfo;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.entity.Category;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.BookAlreadyExistsException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.BookNotFoundException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.NotValidBookException;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.repository.BookRepository;
+import fr.iut_fbleau.but3.dev62.mylibrary.book.usecase.BookUseCase;
+import io.cucumber.datatable.DataTable;
+import io.cucumber.java.en.And;
+import io.cucumber.java.en.Given;
+import io.cucumber.java.en.Then;
+import io.cucumber.java.en.When;
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Map;
+
+public class BookSteps {
+
+  private final BookRepository bookRepository = new BookRepository();
+  private final BookUseCase bookUseCase = new BookUseCase(bookRepository);
+
+  private long lastRegisteredIsbn;
+  private BookDTO retrievedBook;
+  private List<BookDTO> allBooks;
+  private Exception lastException;
+
+  @Given("the catalog has the following books:")
+  public void theCatalogHasTheFollowingBooks(DataTable dataTable) throws NotValidBookException, BookAlreadyExistsException {
+    bookRepository.deleteAll();
+    for (Map<String, String> row : dataTable.asMaps(String.class, String.class)) {
+      bookUseCase.registerBook(toBookInfo(row));
+    }
+  }
+
+  @When("I register a new book with the following information:")
+  public void iRegisterANewBook(DataTable dataTable) throws NotValidBookException, BookAlreadyExistsException {
+    Map<String, String> row = dataTable.asMaps(String.class, String.class).getFirst();
+    lastRegisteredIsbn = bookUseCase.registerBook(toBookInfo(row));
+  }
+
+  @When("I try to register a new book with the following information:")
+  public void iTryToRegisterANewBook(DataTable dataTable) {
+    Map<String, String> row = dataTable.asMaps(String.class, String.class).getFirst();
+    lastException = assertThrows(Exception.class, () -> bookUseCase.registerBook(toBookInfo(row)));
+  }
+
+  @When("I request the book with isbn {long}")
+  public void iRequestTheBook(long isbn) throws BookNotFoundException {
+    retrievedBook = bookUseCase.getBookByIsbn(isbn);
+  }
+
+  @When("I list all books")
+  public void iListAllBooks() {
+    allBooks = bookUseCase.getAllBooks();
+  }
+
+  @Then("the book is created")
+  public void theBookIsCreated() {
+    assertNotNull(lastRegisteredIsbn);
+  }
+
+  @And("the catalog now has {int} book(s)")
+  public void theCatalogNowHasNBooks(int expected) {
+    assertEquals(expected, bookRepository.findAll().size());
+  }
+
+  @Then("the registration fails with a {string}")
+  public void theRegistrationFailsWith(String exceptionSimpleName) {
+    assertNotNull(lastException);
+    assertEquals(exceptionSimpleName, lastException.getClass().getSimpleName());
+  }
+
+  @Then("I receive a book whose title is {string}")
+  public void iReceiveABookWhoseTitleIs(String title) {
+    assertNotNull(retrievedBook);
+    assertEquals(title, retrievedBook.getTitle());
+  }
+
+  @Then("I receive {int} book(s)")
+  public void iReceiveNBooks(int expected) {
+    assertNotNull(allBooks);
+    assertEquals(expected, allBooks.size());
+  }
+
+  private static BookInfo toBookInfo(Map<String, String> row) {
+    return new BookInfo(
+        Long.parseLong(row.get("isbn")),
+        row.get("titre"),
+        row.get("auteur"),
+        row.get("editeur"),
+        LocalDate.parse(row.get("datePublication")),
+        Double.parseDouble(row.get("prix")),
+        Integer.parseInt(row.get("stock")),
+        List.of(Category.valueOf(row.get("categorie"))),
+        "",
+        row.get("langue")
+    );
+  }
+}

mylibrary/src/test/resources/features/book.feature

@@ -0,0 +1,40 @@
+# language: en
+
+Feature: Manage book catalog
+
+  Scenario: Register a new book in the catalog
+    When I register a new book with the following information:
+      | isbn          | titre    | auteur  | editeur | datePublication | prix  | stock | categorie | langue |
+      | 9780321125217 | DDD      | Evans   | AW      | 2003-08-22      | 54.99 | 10    | SCIENCE   | EN     |
+    Then the book is created
+    And the catalog now has 1 book
+
+  Scenario: Reject duplicate ISBN
+    Given the catalog has the following books:
+      | isbn          | titre    | auteur  | editeur | datePublication | prix  | stock | categorie | langue |
+      | 9780321125217 | DDD      | Evans   | AW      | 2003-08-22      | 54.99 | 10    | SCIENCE   | EN     |
+    When I try to register a new book with the following information:
+      | isbn          | titre    | auteur  | editeur | datePublication | prix  | stock | categorie | langue |
+      | 9780321125217 | DDD copy | Evans   | AW      | 2003-08-22      | 54.99 | 10    | SCIENCE   | EN     |
+    Then the registration fails with a "BookAlreadyExistsException"
+
+  Scenario: Reject invalid book information
+    When I try to register a new book with the following information:
+      | isbn          | titre | auteur | editeur | datePublication | prix | stock | categorie | langue |
+      | 9780321125217 |       | Evans  | AW      | 2003-08-22      | 0    | -1    | SCIENCE   | EN     |
+    Then the registration fails with a "NotValidBookException"
+
+  Scenario: Retrieve a book by its ISBN
+    Given the catalog has the following books:
+      | isbn          | titre    | auteur  | editeur | datePublication | prix  | stock | categorie | langue |
+      | 9780321125217 | DDD      | Evans   | AW      | 2003-08-22      | 54.99 | 10    | SCIENCE   | EN     |
+    When I request the book with isbn 9780321125217
+    Then I receive a book whose title is "DDD"
+
+  Scenario: List all books in the catalog
+    Given the catalog has the following books:
+      | isbn          | titre    | auteur  | editeur | datePublication | prix  | stock | categorie | langue |
+      | 9780321125217 | DDD      | Evans   | AW      | 2003-08-22      | 54.99 | 10    | SCIENCE   | EN     |
+      | 9780132350884 | Clean    | Martin  | PH      | 2008-08-01      | 30.00 | 5     | SCIENCE   | EN     |
+    When I list all books
+    Then I receive 2 books