How lepariisien/lootopia-project works
Pour représenter au mieux l’architecture de Lootopia en diagramme système, nous allons la scinder en deux grands blocs : Frontend et Backend (microservices). Voici comment procéder étape par étape :
Identifier les composants principaux
a. Frontend Web (Angular)
b. Mobile (Flutter) – optionnel si vous dessinez aussi la partie mobile
c. Backend
• Service de découverte : Eureka Server
• Passerelle d’API : API Gateway
• Microservice principal (« Lootopia Service »)
• Microservice Localisation (« Location Service »)
• Microservice Paiement (« Payment Service »)
• Base(s) de données PostgreSQL
• Services externes : Google Maps/OpenStreetMap, Stripe, SMTP (mail)
Schématiser les relations et flux
a. Le navigateur (ou l’app mobile) envoie les requêtes HTTP/HTTPS → API Gateway.
b. L’API Gateway interroge le Eureka Server pour découvrir l’adresse des microservices.
c. L’API Gateway achemine la requête vers le microservice concerné (Lootopia, Location, Payment).
d. Chaque microservice gère son propre schéma de données dans PostgreSQL (ou dans un schéma partagé si vous préférez).
e. Le microservice Lootopia peut appeler le Location Service via REST et / ou un client Feign (ex. LocationServClient).
f. Le microservice Lootopia appelle le Payment Service via REST (pour initier un paiement Stripe).
g. Les microservices peuvent émettre des mails via un service SMTP externe ou un service de mail (MailService).
h. Les appels à l’API de géolocalisation / RA (Google Maps, OpenStreetMap) partent directement des microservices ou du frontend selon le design.
Mettre en évidence les patterns architecturaux
• Microservices + découplage service par domaine (authentification, chasse au trésor, localisation, paiement)
• Service Discovery (Eureka)
• API Gateway (centralisation de la couche d’entrée : routage, sécurité, CORS, Swagger)
• Sécurité : JwtAuthenticationFilter, SecurityConfig dans Lootopia Service
• Communication synchrone REST entre microservices
• Bases de données découplées (pattern database per service)
Technologies à annoter
• Angular (Frontend Web)
• Flutter (Mobile)
• Spring Boot + Spring Cloud (Eureka, Gateway, services)
• PostgreSQL
• Stripe SDK (Payment Service)
• Google Maps / OpenStreetMap SDK
• SMTP / MailService
Conseils de représentation
■ Bleu pour les composants frontend
■ Vert pour les microservices backend
■ Orange pour les bases de données
■ Violet pour les services externes
• Flèches directionnelles claires pour indiquer le flux de requêtes et de données
• Étiqueter chaque flèche (ex. “REST GET /hunts”, “JWT token”)
• Mentionner sous chaque microservice son port par défaut ou son nom d’application (ex. gateway: 8080, lootopia-service: 8081, etc.)
• Ajouter une légende pour expliquer les formes (cylindre = base de données, nuage = service externe, rectangle = application)
Exemple de découpage visuel
[ Frontend Web (Angular) ] ->
[ API Gateway ] <-> [ Eureka Server ]
|-> [ Lootopia Service ] -> [ PostgreSQL – lootopia-db ]
|-> [ Location Service ] -> [ PostgreSQL – location-db ]
|-> [ Payment Service ] -> [ PostgreSQL – payment-db ]
|-> [ Mail SMTP / SendGrid ]
|-> [ Google Maps / OpenStreetMap ]
|-> [ Stripe API ]
En suivant ces recommandations, vous couvrirez tous les services backend mentionnés sans détailler chaque fichier, tout en ayant une vue d’ensemble très claire de l’architecture front-to-back de Lootopia.
N’oubliez pas : un bon diagramme est lisible, correctement légendé et fait ressortir les interactions clés.