# selimhorri/ecommerce-microservice-backend-app architecture

> Architecture diagram of the GitHub repository selimhorri/ecommerce-microservice-backend-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/selimhorri/ecommerce-microservice-backend-app
- Repository: https://github.com/selimhorri/ecommerce-microservice-backend-app

## Overview

##### Project Type & Purpose
- This is a cloud-native, Spring Boot & Spring Cloud–based microservices backend for an e-commerce application.
- It implements key microservices patterns: API gateway, service discovery (Eureka), centralized config, circuit breakers (Resilience4j), event-driven messaging (Kafka), and observability (Zipkin, Prometheus, ELK).

##### File Structure Analysis
- Top-level modules under the parent POM:
- api-gateway (routes external traffic)
- proxy-client (authentication/authorization service)
- service-discovery (Eureka registry)
- cloud-config (centralized config server)
- user-service, product-service, favourite-service, order-service, shipping-service, payment-service (domain microservices)
- Each microservice has its own Dockerfile, compose.yml, application-{dev,stage,prod}.yml, database migrations, and system.properties.
- Root compose.yml brings up all services plus Kafka and Zipkin.
- K8s folder contains Kubernetes manifests for each component.
- CI/CD workflows under .github/workflows for each service and environment.

##### README Insights
- Describes a 10-service landscape with Kafka as messaging backbone, Docker Compose for local dev, and plans to migrate to Kubernetes.
- Illustrates system boundary: external clients → API Gateway → proxy-client (OAuth2) → microservices → databases.
- Highlights use of Spring Boot Actuator metrics (Prometheus), Zipkin tracing, and ELK for logging.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Clients
    subgraph "External Clients"
        direction TB
        WebClient["Web Client"]:::external
        MobileClient["Mobile Client"]:::external
    end

    %% Infrastructure Layer
    subgraph "Infrastructure"
        direction TB
        APIGateway["API Gateway (Spring Cloud Gateway)"]:::infra
        AuthService["Authentication Service (proxy-client)"]:::infra
        ServiceDiscovery["Service Discovery (Eureka)"]:::infra
        ConfigServer["Config Server (cloud-config)"]:::infra
    end

    %% Domain Microservices
    subgraph "Domain Microservices"
        direction TB
        UserService["User Service"]:::service
        ProductService["Product Service"]:::service
        FavouriteService["Favourite Service"]:::service
        OrderService["Order Service"]:::service
        ShippingService["Shipping Service"]:::service
        PaymentService["Payment Service"]:::service
    end

    %% Messaging
    subgraph "Messaging"
        direction TB
        Kafka["Kafka"]:::messaging
    end

    %% Observability
    subgraph "Observability"
        direction TB
        Zipkin["Zipkin"]:::obs
        Prometheus["Prometheus"]:::obs
        ELK["ELK Stack"]:::obs
    end

    %% Databases
    subgraph "Databases"
        direction TB
        UserDB["User DB"]:::db
        ProductDB["Product DB"]:::db
        FavouriteDB["Favourite DB"]:::db
        OrderDB["Order DB"]:::db
        ShippingDB["Shipping DB"]:::db
        PaymentDB["Payment DB"]:::db
    end

    %% Connections - Client to Gateway
    WebClient -->|"HTTPS"| APIGateway
    MobileClient -->|"HTTPS"| APIGateway

    %% Gateway to Auth and Services
    APIGateway -->|"OAuth2 token validation"| AuthService
    APIGateway -->|"Route via Eureka"| UserService
    APIGateway -->|"Route via Eureka"| ProductService
    APIGateway -->|"Route via Eureka"| FavouriteService
    APIGateway -->|"Route via Eureka"| OrderService
    APIGateway -->|"Route via Eureka"| ShippingService
    APIGateway -->|"Route via Eureka"| PaymentService

    %% Service Discovery and Config pulls
    UserService -->|"register & discover"| ServiceDiscovery
    ProductService -->|"register & discover"| ServiceDiscovery
    FavouriteService -->|"register & discover"| ServiceDiscovery
    OrderService -->|"register & discover"| ServiceDiscovery
    ShippingService -->|"register & discover"| ServiceDiscovery
    PaymentService -->|"register & discover"| ServiceDiscovery

    UserService -->|"config pull"| ConfigServer
    ProductService -->|"config pull"| ConfigServer
    FavouriteService -->|"config pull"| ConfigServer
    OrderService -->|"config pull"| ConfigServer
    ShippingService -->|"config pull"| ConfigServer
    PaymentService -->|"config pull"| ConfigServer

    %% Synchronous and Asynchronous interactions
    OrderService -->|"publish order-placed"| Kafka
    PaymentService -->|"subscribe order-placed"| Kafka
    ShippingService -->|"subscribe order-placed"| Kafka

    %% Database operations
    UserService -->|"read/write"| UserDB
    ProductService -->|"read/write"| ProductDB
    FavouriteService -->|"read/write"| FavouriteDB
    OrderService -->|"read/write"| OrderDB
    ShippingService -->|"read/write"| ShippingDB
    PaymentService -->|"read/write"| PaymentDB

    %% Observability flows
    UserService -->|"traces/metrics/logs"| Zipkin
    ProductService -->|"traces/metrics/logs"| Zipkin
    FavouriteService -->|"traces/metrics/logs"| Zipkin
    OrderService -->|"traces/metrics/logs"| Zipkin
    ShippingService -->|"traces/metrics/logs"| Zipkin
    PaymentService -->|"traces/metrics/logs"| Zipkin

    UserService -->|"metrics"| Prometheus
    ProductService -->|"metrics"| Prometheus
    FavouriteService -->|"metrics"| Prometheus
    OrderService -->|"metrics"| Prometheus
    ShippingService -->|"metrics"| Prometheus
    PaymentService -->|"metrics"| Prometheus

    UserService -->|"logs"| ELK
    ProductService -->|"logs"| ELK
    FavouriteService -->|"logs"| ELK
    OrderService -->|"logs"| ELK
    ShippingService -->|"logs"| ELK
    PaymentService -->|"logs"| ELK

    %% Click Events
    click APIGateway "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/api-gateway/"
    click AuthService "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/proxy-client/"
    click ServiceDiscovery "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/service-discovery/"
    click ConfigServer "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/cloud-config/"
    click UserService "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/user-service/"
    click ProductService "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/product-service/"
    click FavouriteService "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/favourite-service/"
    click OrderService "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/order-service/"
    click ShippingService "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/shipping-service/"
    click PaymentService "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/payment-service/"
    click Kafka "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/compose.yml"
    click Zipkin "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/compose.yml"
    click Prometheus "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/.github/workflows/"
    click ELK "https://github.com/selimhorri/ecommerce-microservice-backend-app/tree/master/.github/workflows/"
    click WebClient "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/app-architecture.drawio"
    click MobileClient "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/app-architecture.drawio"
    click UserDB "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/ecommerce-ERD.drawio"
    click ProductDB "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/ecommerce-ERD.drawio"
    click FavouriteDB "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/ecommerce-ERD.drawio"
    click OrderDB "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/ecommerce-ERD.drawio"
    click ShippingDB "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/ecommerce-ERD.drawio"
    click PaymentDB "https://github.com/selimhorri/ecommerce-microservice-backend-app/blob/master/ecommerce-ERD.drawio"

    %% Styles
    classDef external fill:#f9f,stroke:#333,stroke-width:1px
    classDef infra fill:#bbdefb,stroke:#1e88e5,stroke-width:2px
    classDef service fill:#c8e6c9,stroke:#388e3c,stroke-width:2px
    classDef messaging fill:#ffe0b2,stroke:#ef6c00,stroke-width:2px
    classDef obs fill:#e1bee7,stroke:#8e24aa,stroke-width:2px
    classDef db fill:#eeeeee,stroke:#666666,stroke-width:1px,stroke-dasharray: 5 5
```
