Amazon Clone — Distributed E-Commerce Platform A production-grade distributed e-commerce platform built with Java 21 and Spring Boot, implementing microservices architecture with event-driven communication.
┌──────────────────────────────────────────┐
│ API Gateway │
│ (Spring Cloud Gateway :8080) │
│ JWT Auth │ Circuit Breaker │ Rate Limit│
└──────────────┬───────────────────────────┘
│
┌─────────────────┬──────────┴──────────┬────────────────┐
│ │ │ │
┌───────▼──────┐ ┌───────▼──────┐ ┌──────────▼───┐ ┌────────▼──────┐
│ User Service │ │Product Service│ │ Order Service│ │Payment Service│
│ :8081 │ │ :8082 │ │ :8083 │ │ :8084 │
└──────┬───────┘ └──────┬───────┘ └──────┬──────┘ └────────┬──────┘
│ │ │ │
└─────────────────┴──────────────────┴───────────────────┘
│
┌────────────────┬────────────┴────────────┬────────────────┐
│ │ │ │
┌───────▼──────┐ ┌──────▼────────┐ ┌────────────▼──┐ ┌─────────▼──────┐
│ Inventory │ │Notification │ │ Search │ │Service Registry│
│ Service │ │ Service │ │ Service │ │ (Eureka) │
│ :8085 │ │ :8086 │ │ :8087 │ │ :8761 │
└──────────────┘ └───────────────┘ └───────────────┘ └───────────────┘
│
┌─────────────────┬──────────┴──────────┬────────────────┐
│ │ │ │
┌──────▼──────┐ ┌──────▼──────┐ ┌─────────▼──┐ ┌────────▼──────┐
│ PostgreSQL │ │ Redis │ │ Kafka │ │Elasticsearch │
│ (6 DBs) │ │ Cache │ │ (Events) │ │ (Search) │
└─────────────┘ └─────────────┘ └────────────┘ └───────────────┘
Service
Port
Description
Service Registry
8761
Eureka service discovery
Config Server
8888
Centralized configuration
API Gateway
8080
Entry point — auth, routing, LB
User Service
8081
Auth, JWT, user profiles, addresses
Product Service
8082
Catalog, categories, reviews, images
Order Service
8083
Orders, cart (Redis), checkout
Payment Service
8084
Payments, refunds, webhooks
Inventory Service
8085
Stock management, reservations
Notification Service
8086
Email via Kafka consumers
Search Service
8087
Elasticsearch full-text search
Technology
Usage
Java 21
Virtual threads, records, sealed classes
Spring Boot 3.2
Core framework
Spring Security
JWT authentication, method-level auth
Spring Data JPA
Hibernate ORM + PostgreSQL
Spring Cloud Gateway
API Gateway with circuit breakers
Eureka
Service discovery and registration
Redis
Cart storage, caching
Apache Kafka
Event-driven async communication
RabbitMQ
Message queuing
Elasticsearch
Full-text product search
Docker
Containerization
Kubernetes
Orchestration + HPA autoscaling
AWS EKS
Cloud deployment
Jenkins
CI/CD pipeline
GitHub Actions
CI/CD pipeline (alternative)
Prometheus
Metrics collection
Grafana
Metrics dashboards
Flyway
Database migrations
JUnit 5 + Mockito
Testing
Docker Desktop
Java 21
Maven 3.9+
git clone https://github.com/your-org/amazon-clone.git
cd amazon-clone
# Start all infrastructure# Wait for infrastructure to be ready (~30 seconds), then start services# View running services Run Locally (Development) # 1. Start infrastructure only# 2. Build all services# 3. Start services in order* .jar &
sleep 10
java -jar config-server/target/* .jar &
sleep 5
java -jar api-gateway/target/* .jar &
java -jar user-service/target/* .jar &
java -jar product-service/target/* .jar &
java -jar order-service/target/* .jar &
java -jar payment-service/target/* .jar &
java -jar inventory-service/target/* .jar &
java -jar notification-service/target/* .jar &
java -jar search-service/target/* .jar & POST /api/v1/auth/register
POST /api/v1/auth/login
POST /api/v1/auth/refresh
POST /api/v1/auth/logout GET /api/v1/users/me
GET /api/v1/users/{id}
PUT /api/v1/users/{id}
PATCH /api/v1/users/{id}/password
POST /api/v1/users/{id}/addresses
GET /api/v1/users/{id}/addresses
DELETE /api/v1/users/{id}/addresses/{addressId} GET /api/v1/products
GET /api/v1/products/{id}
POST /api/v1/products (SELLER/ADMIN)
PUT /api/v1/products/{id} (SELLER/ADMIN)
DELETE /api/v1/products/{id} (SELLER/ADMIN)
GET /api/v1/products/search?keyword= GET /api/v1/products/filter?categoryId=&minPrice=&maxPrice=&brand= GET /api/v1/products/featured
GET /api/v1/products/{id}/reviews
POST /api/v1/products/{id}/reviews
GET /api/v1/categories
POST /api/v1/categories (ADMIN) POST /api/v1/cart/items
GET /api/v1/cart
PUT /api/v1/cart/items/{productId}
DELETE /api/v1/cart/items/{productId}
DELETE /api/v1/cart
POST /api/v1/orders
GET /api/v1/orders/my
GET /api/v1/orders/{id}
POST /api/v1/orders/{id}/cancel
PATCH /api/v1/orders/{id}/status (ADMIN) POST /api/v1/payments
GET /api/v1/payments/my
GET /api/v1/payments/{id}
GET /api/v1/payments/order/{orderNumber}
POST /api/v1/payments/{id}/refund
POST /api/v1/payments/webhook POST /api/v1/inventory
GET /api/v1/inventory/product/{productId}
PUT /api/v1/inventory/product/{productId}/stock
GET /api/v1/inventory/low-stock
POST /api/v1/inventory/check
POST /api/v1/inventory/reserve
POST /api/v1/inventory/release GET /api/v1/search?q=laptop&categoryId=1&minPrice=100&maxPrice=2000&sortBy=price
GET /api/v1/search/suggest?q=lap
GET /api/v1/search/category/{categoryId}
Topic
Producer
Consumer(s)
user-registered
User Service
Notification Service
user-updated
User Service
—
product-events
Product Service
Search Service, Notification Service
order-events
Order Service
Notification Service
payment-events
Payment Service
Notification Service
payment-order-events
Payment Service
Order Service
inventory-alerts
Inventory Service
Notification Service
# All teststest
# Single servicetest -pl user-service
# With coveragetest jacoco:report -pl user-service
open user-service/target/site/jacoco/index.html# Create namespace and secrets# Deploy infrastructure# Deploy services# Check status# Scale a serviceamazon-clone/
├── pom.xml # Parent POM
├── docker-compose.yml # Local development
├── Jenkinsfile # Jenkins CI/CD
├── .github/workflows/ci-cd.yml # GitHub Actions CI/CD
├── service-registry/ # Eureka Server
├── config-server/ # Spring Cloud Config
├── api-gateway/ # Spring Cloud Gateway
├── user-service/ # Users + Auth + JWT
├── product-service/ # Products + Categories + Reviews
├── order-service/ # Orders + Cart
├── payment-service/ # Payments + Refunds
├── inventory-service/ # Stock + Reservations
├── notification-service/ # Email via Kafka
├── search-service/ # Elasticsearch
├── k8s/ # Kubernetes manifests
├── monitoring/ # Prometheus + Grafana
└── docker/ # Shared Dockerfiles