Documentation TravelsAPI
À propos
TravelsAPI est une API REST Spring Boot dédiée à la gestion des voyages dans la plateforme Zorni. Cette API permet aux établissements de gérer leurs offres de voyages et aux utilisateurs de réserver des voyages.
Table des matières
Architecture
- Architecture technique
- Architecture fonctionnelle
- Schéma de base de données
- Diagrammes UML
- Points d'accès API
Guides
Fonctionnalités principales
Gestion des voyages
- Création et modification des voyages
- Gestion des programmes de voyage
- Configuration des tarifs et options
- Gestion des disponibilités
Publication des voyages
- Publication/dépublication des voyages
- Gestion des dates de voyage
- Configuration des places disponibles
- Prix dynamiques par catégorie d'âge
Réservations
- Gestion des réservations
- Calcul dynamique des prix
- Gestion des options et activités
- Suivi des statuts de réservation
Avis et opinions
- Gestion des avis clients
- Système de notation
- Modération des commentaires
Architecture
Composants principaux
- Services de gestion des voyages (TripsService)
- Services de publication (TripPublicationsService)
- Services de réservation (TripReservationsService)
- Services d'avis (TripOpinionsService)
- Services communs (CommonServices)
Technologies utilisées
- Java 21
- Spring Boot 3.4.5
- Spring Cloud
- PostgreSQL
- Maven
- HashiCorp Vault
- MapStruct
- Docker
Sécurité et configuration
- Authentification via tokens
- Validation des établissements
- Configuration centralisée via Vault
- Audit des modifications