CarFlow Booking Service

Service de gestion des réservations de véhicules

📋 Description

Le Booking Service orchestre les réservations : vérification de disponibilité, création de bookings, modifications et annulations. C'est le cœur métier de CarFlow.

🎯 Responsabilités

• Créer et gérer les réservations
• Vérifier la disponibilité des véhicules
• Calculer le prix total (tarif × durée + assurances)
• Modifier/annuler les réservations
• Générer les confirmations de réservation
• Appel au payment-service pour le paiement

🛠️ Stack Technique

• Framework : Spring Boot 3.5.7
• Language : Java 21+
• Base de données : MySQL
• ORM : JPA
• Communication inter-services : REST

📦 Dépendances Principales

🚀 Démarrage

# Build
mvn clean package

# Run
java -jar target/carflow-booking-service-*.jar

# Dev
mvn spring-boot:run

📡 Endpoints Principaux

À compléter :

• GET /api/bookings - Lister les réservations de l'utilisateur
• GET /api/bookings/{id} - Détails d'une réservation
• POST /api/bookings - Créer une nouvelle réservation
• PUT /api/bookings/{id} - Modifier une réservation
• DELETE /api/bookings/{id} - Annuler une réservation
• GET /api/bookings/{id}/confirmation - Télécharger la confirmation PDF
• POST /api/bookings/{id}/validate-availability - Vérifier dispo avant de booker

📊 Modèles de Données

À compléter :

🤝 Communication Externe

À compléter : Appels synchrones/asynchrones aux autres services

• vehicle-service :
• user-service :

🔄 Flux Métier

À compléter : Diagramme des statuts de réservation et transitions

📚 Documentation

👨‍💻 Auteur

Pierrick VIRET Gabriel ALLOZA