# lepariisien/lootopia-project architecture

> Architecture diagram of the GitHub repository lepariisien/lootopia-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lepariisien/lootopia-project
- Repository: https://github.com/lepariisien/lootopia-project

## Overview

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.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Frontend"
        FE["Frontend Web (Angular)"]:::frontend
    end

    subgraph "Backend"
        Gateway["API Gateway\n(port 8080)"]:::microservice
        Eureka["Eureka Server\n(port 8761)"]:::microservice
        Lootopia["Lootopia Service\n(port 8081)"]:::microservice
        Location["Location Service\n(port 8082)"]:::microservice
        Payment["Payment Service\n(port 8083)"]:::microservice
        DB_Loot["PostgreSQL\nlootopia_db"]:::db
        DB_Loc["PostgreSQL\nlocation_db"]:::db
        DB_Pay["PostgreSQL\npayment_db"]:::db
        Mail["Mail Service\n(SMTP)"]:::external
        Maps["Google Maps/OpenStreetMap"]:::external
        Stripe["Stripe API"]:::external
    end

    FE -->|"HTTP/HTTPS"| Gateway
    Gateway -->|"service discovery / routing"| Eureka
    Gateway -->|"REST"| Lootopia
    Gateway -->|"REST"| Location
    Gateway -->|"REST"| Payment
    Lootopia -->|"REST/Feign"| Location
    Lootopia -->|"REST"| Payment
    Lootopia -->|"SMTP"| Mail
    Lootopia -->|"Geo API calls"| Maps
    Payment -->|"Stripe SDK"| Stripe
    Lootopia -->|"JDBC"| DB_Loot
    Location -->|"JDBC"| DB_Loc
    Payment -->|"JDBC"| DB_Pay

    click FE "https://github.com/lepariisien/lootopia-project/tree/main/frontend/"
    click Eureka "https://github.com/lepariisien/lootopia-project/blob/main/backend/eureka/src/main/java/com/lootopia/eureka_server/EurekaServerApplication.java"
    click Gateway "https://github.com/lepariisien/lootopia-project/blob/main/backend/gateway/src/main/java/com/lootopia/api_gateway/ApiGatewayApplication.java"
    click Lootopia "https://github.com/lepariisien/lootopia-project/blob/main/backend/lootopia/src/main/java/com/lootopia/lootopia/LootopiaApplication.java"
    click Location "https://github.com/lepariisien/lootopia-project/blob/main/backend/location/src/main/java/com/location/locationserv/LocationServerApplication.java"
    click Payment "https://github.com/lepariisien/lootopia-project/blob/main/backend/payment/src/main/java/com/lootopia/paymentserv/PaymentApplication.java"

    classDef frontend fill:#add8e6,stroke:#000,color:#000
    classDef microservice fill:#90ee90,stroke:#000,color:#000
    classDef db fill:#ffa500,stroke:#000,color:#000
    classDef external fill:#dda0dd,stroke:#000,color:#000
```
