# mag1305/ecommerce-microservice-backend-app architecture

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

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

## Overview

##### Project type and purpose
- This is a cloud-native, Spring Boot–based microservices backend for an e-commerce system.
- It implements 10 µServices (user, product, favourite, order, shipping, payment) plus supporting services (service-discovery, cloud-config, api-gateway, proxy-client) and uses Docker, Kubernetes, Eureka, Config Server, Zipkin, Prometheus, MySQL/H2, Kafka.

##### File structure
- Top-level modules:
– service-discovery (Eureka registry)
– cloud-config (centralized configuration)
– api-gateway (Spring Cloud Gateway or Zuul)
– proxy-client (authentication/authorization proxy)
– user-service, product-service, favourite-service, order-service, shipping-service, payment-service (domain µServices)
- Shared POM and wrapper files for Maven across modules.
- k8s folder contains Kubernetes manifests for each service.

##### README for additional insights
- Confirms Spring Cloud design patterns: discovery, config, gateway, circuit breakers, reactive programming, TDD, logging/monitoring (Zipkin, Prometheus).
- Describes runtime landscape: Docker Compose (Kafka, Zipkin, DB) and planned Kubernetes deployment.

##### Elements
– Clear, concise labels for every component (e.g., “user-service”, “api-gateway”)
- Edge/Ingress (proxy-client, api-gateway)
- Control Plane (service-discovery, cloud-config)
- Domain µServices (user, product, order, etc.)
- Infrastructure (K8s cluster boundary)

##### Detailed capture of essential elements
- Inside it, group the µServices and infrastructure services in separate sub-zones.
- External clients outside the boundary at the top or left.
- Optionally number the interaction steps to reflect request sequence.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External
    ExternalClients["External Clients (Browsers, Mobile Apps)"]:::edge

    %% Kubernetes Cluster
    subgraph "Kubernetes Cluster"
        direction TB

        subgraph "Edge Services"
            proxy["proxy-client\n(AuthN/AuthZ)"]:::edge
            gateway["api-gateway\n(Spring Cloud Gateway)"]:::edge
        end

        subgraph "Control Plane"
            config["cloud-config\n(Config Server)"]:::control
            discovery["service-discovery\n(Eureka Registry)"]:::control
        end

        subgraph "Domain Microservices"
            user["user-service"]:::service
            userdb["user DB\n(MySQL/H2)"]:::db
            product["product-service"]:::service
            productdb["product DB"]:::db
            favourite["favourite-service"]:::service
            favouritedb["favourite DB"]:::db
            order["order-service"]:::service
            orderdb["order DB"]:::db
            shipping["shipping-service"]:::service
            shippingdb["shipping DB"]:::db
            payment["payment-service"]:::service
            paymentdb["payment DB"]:::db
        end

        subgraph "Infrastructure Services"
            kafka["Kafka"]:::messaging
            zipkin["Zipkin"]:::monitoring
            prometheus["Prometheus"]:::monitoring
        end
    end

    %% Artifacts
    subgraph "Artifacts & CI/CD"
        compose["Docker Compose (compose.yml)"]:::infra
        k8sManifests["Kubernetes Manifests (k8s/)"]:::infra
        architecture["app-architecture.drawio"]:::infra
        erd["ecommerce-ERD.drawio"]:::infra
        ci1[".github/workflows/user-service/build-test-deploy.yml"]:::infra
        ci2["azure-pipelines.yml"]:::infra
    end

    %% Connections - Edge Flow
    ExternalClients -->|"HTTP Login/Auth"| proxy
    proxy -->|"JWT Issued"| gateway

    %% API Gateway Routing
    gateway -->|"Service Discovery Lookup"| discovery
    gateway -->|"REST Requests"| user
    gateway -->|"REST Requests"| product
    gateway -->|"REST Requests"| favourite
    gateway -->|"REST Requests"| order
    gateway -->|"REST Requests"| shipping
    gateway -->|"REST Requests"| payment

    %% Configuration & Discovery
    config -->|"Config Fetch on Startup"| discovery
    config -->|"Config Fetch on Startup"| user
    config -->|"Config Fetch on Startup"| product
    config -->|"Config Fetch on Startup"| favourite
    config -->|"Config Fetch on Startup"| order
    config -->|"Config Fetch on Startup"| shipping
    config -->|"Config Fetch on Startup"| payment
    discovery -->|"Registration & Discovery"| user
    discovery -->|"Registration & Discovery"| product
    discovery -->|"Registration & Discovery"| favourite
    discovery -->|"Registration & Discovery"| order
    discovery -->|"Registration & Discovery"| shipping
    discovery -->|"Registration & Discovery"| payment

    %% Synchronous Service Calls
    order -->|"REST Feign Client"| user
    order -->|"REST Feign Client"| product

    %% Asynchronous Events
    order -->|"order-created Event"| kafka
    kafka -->|"Consumes order-created"| payment
    kafka -->|"Consumes order-created"| shipping

    %% Monitoring & Tracing
    user --> zipkin
    product --> zipkin
    favourite --> zipkin
    order --> zipkin
    shipping --> zipkin
    payment --> zipkin
    gateway --> zipkin
    proxy --> zipkin
    discovery --> zipkin
    config --> zipkin

    user --> prometheus
    product --> prometheus
    favourite --> prometheus
    order --> prometheus
    shipping --> prometheus
    payment --> prometheus
    gateway --> prometheus
    proxy --> prometheus
    discovery --> prometheus
    config --> prometheus

    %% CI/CD & Artifacts Links
    compose --- k8sManifests
    k8sManifests --- architecture
    architecture --- erd
    ci1 --- ci2

    %% Click Events
    click proxy "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/proxy-client/"
    click gateway "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/api-gateway/"
    click discovery "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/service-discovery/"
    click config "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/cloud-config/"
    click user "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/user-service/"
    click product "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/product-service/"
    click favourite "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/favourite-service/"
    click order "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/order-service/"
    click shipping "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/shipping-service/"
    click payment "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/payment-service/"
    click k8sManifests "https://github.com/mag1305/ecommerce-microservice-backend-app/tree/master/k8s/"
    click architecture "https://github.com/mag1305/ecommerce-microservice-backend-app/blob/master/app-architecture.drawio"
    click erd "https://github.com/mag1305/ecommerce-microservice-backend-app/blob/master/ecommerce-ERD.drawio"
    click ci1 "https://github.com/mag1305/ecommerce-microservice-backend-app/blob/master/.github/workflows/user-service/build-test-deploy.yml"
    click ci2 "https://github.com/mag1305/ecommerce-microservice-backend-app/blob/master/azure-pipelines.yml"

    %% Styles
    classDef edge fill:#FFDD57,stroke:#333,stroke-width:1px
    classDef control fill:#57C7FF,stroke:#333,stroke-width:1px
    classDef service fill:#A3BE8C,stroke:#333,stroke-width:1px
    classDef db fill:#D08770,stroke:#333,stroke-width:1px
    classDef messaging fill:#B48EAD,stroke:#333,stroke-width:1px
    classDef monitoring fill:#88C0D0,stroke:#333,stroke-width:1px
    classDef infra fill:#EBCB8B,stroke:#333,stroke-width:1px
```
