Branche fusion : API REST Spring Boot pour le front React

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-12 10:50:45 +02:00
parent ee299e1e19
commit e67de45a3e
17 changed files with 465 additions and 0 deletions
@@ -0,0 +1,50 @@
+# MyLibrary — backend Java
+
+Backend métier du projet librairie (Maxime Lebreton / Marvin Aubert / Patrick Felix-Vimalaratnam).  
+Pendant visuel : dépôt **`2026-DEV-BUT3`** (React).
+
+## Stack
+
+- Java 21, Maven
+- Couche domaine : livres, clients, points de fidélité
+- **API REST** (branche `fusion`) : Spring Boot sur le port **8080**
+
+## Lancer l’API
+
+```bash
+mvn spring-boot:run
+```
+
+Vérifier : [http://localhost:8080/api/health](http://localhost:8080/api/health)
+
+## Endpoints exposés au front
+
+| Méthode | Route | Rôle |
+|---------|-------|------|
+| GET | `/api/health` | Ping |
+| GET | `/api/books` | Liste des livres (format UI) |
+| POST | `/api/books` | Créer un livre |
+| GET | `/api/books/{isbn}` | Détail |
+| DELETE | `/api/books/{isbn}` | Supprimer |
+| POST | `/api/books/{isbn}/read` | Basculer lu / non lu |
+| GET | `/api/users/{uuid}/loyalty-points` | Points fidélité client |
+
+Au démarrage, deux livres démo + un client Marie Dupont (100 pts) sont chargés si le catalogue est vide.
+
+## Brancher le front React
+
+Dans `2026-DEV-BUT3` (branche `fusion`) :
+
+```bash
+cp .env.example .env
+npm install
+npm run dev
+```
+
+Le proxy Vite envoie `/api` vers `localhost:8080`. Commandes, promos, réservations, avis, abo, prêts et groupes restent côté front (local) tant que ces use cases ne sont pas exposés ici.
+
+## Tests unitaires
+
+```bash
+mvn test
+```