Skip to content

yashdotdev13/intelligent-supply-chain

Repository files navigation

Intelligent Supply Chain Platform ๐Ÿš€

A cloud-native, event-driven microservices platform built to simulate how modern distributed supply chain systems operate internally.

This project focuses on:

  • Distributed Systems
  • Event-Driven Architecture
  • Kubernetes Orchestration
  • Cloud Deployment on AWS EKS
  • Observability & Monitoring
  • Production-style Infrastructure

The platform was first deployed locally using Minikube for Kubernetes testing/debugging and later deployed on AWS EKS.


๐Ÿ“Œ Architecture Overview

Core Components

  • Spring Boot Microservices
  • Apache Kafka Event Streaming
  • PostgreSQL Database per Service
  • Eureka Service Discovery
  • API Gateway
  • Dockerized Infrastructure
  • Kubernetes Deployments
  • AWS EKS Deployment
  • Helm Packaging
  • Prometheus Monitoring
  • Grafana Dashboards
  • Zipkin Distributed Tracing

๐Ÿงฉ Microservices

Screenshot 2026-05-22 115356.png

Service Responsibility
User Service Manages users
Order Service Creates and manages orders
Inventory Service Handles product inventory
Payment Service Processes payments
Shipment Service Manages shipment workflows
Return Service Handles product returns
API Gateway Central entry point
Discovery Server Eureka-based service discovery

โšก Event-Driven Workflow

Client Request
      โ†“
API Gateway
      โ†“
Order Service
      โ†“
Kafka Event: OrderCreatedEvent
      โ†“
Payment Service
      โ†“
Kafka Event: PaymentProcessedEvent
      โ†“
Shipment Service

๐Ÿ› ๏ธ Tech Stack

Backend

  • Java 21
  • Spring Boot
  • Spring Cloud
  • Spring Data JPA
  • Spring Cloud Gateway
  • Eureka Discovery Server

Messaging

  • Apache Kafka

Database

  • PostgreSQL

DevOps & Cloud

  • Docker
  • Kubernetes
  • Minikube
  • AWS EKS
  • Helm

Observability

  • Prometheus
  • Grafana
  • Zipkin

โ˜๏ธ Kubernetes Deployment

2nd int.png

Local Deployment

  • Minikube
  • Kubernetes Services
  • Ingress
  • Configurations & Secrets

1st int.png

Cloud Deployment

  • AWS EKS Cluster
  • AWS LoadBalancer
  • Kubernetes Deployments
  • Service Networking
  • Public Access via AWS ELB

๐Ÿ“Š Observability Stack

Prometheus

  • JVM Metrics
  • Request Monitoring
  • CPU & Memory Metrics

Grafana

  • Dashboard Visualization
  • Service Monitoring
  • Infrastructure Metrics

Zipkin

  • Distributed Tracing
  • Request Flow Visualization
  • Inter-service Communication Tracking

โ˜ธ๏ธ Kubernetes Features Used

  • Deployments
  • Services
  • Namespaces
  • ConfigMaps
  • Secrets
  • Ingress
  • LoadBalancer
  • Helm Charts
  • Pod Networking
  • Service Discovery

๐Ÿ“‚ Project Structure

intelligent-supply-chain/
โ”‚
โ”œโ”€โ”€ api-gateway/
โ”œโ”€โ”€ discovery-server/
โ”œโ”€โ”€ user-service/
โ”œโ”€โ”€ order-service/
โ”œโ”€โ”€ inventory-service/
โ”œโ”€โ”€ payment-service/
โ”œโ”€โ”€ shipment-service/
โ”œโ”€โ”€ return-service/
โ”œโ”€โ”€ shared-kafka-events/
โ”‚
โ”œโ”€โ”€ k8s/
โ”œโ”€โ”€ intelligent-supply-chain-chart/
โ””โ”€โ”€ screenshots/

architectureInit.png


๐Ÿš€ Running the Project

Clone Repository

git clone https://github.com/98001yash/intelligent-supply-chain.git
cd intelligent-supply-chain

Docker Compose

docker-compose up -d

Minikube Deployment

minikube start
minikube addons enable ingress
kubectl apply -R -f k8s/

AWS EKS Deployment

aws configure
eksctl create cluster \
--name intelligent-supply-chain \
--region ap-south-1 \
--nodegroup-name workers \
--node-type t3.medium \
--nodes 2
kubectl apply -R -f k8s/

๐Ÿ“ˆ Observability Access

Grafana

kubectl port-forward svc/grafana 3000:3000 -n intelligent-supply-chain

Zipkin

kubectl port-forward svc/zipkin 9411:9411 -n intelligent-supply-chain

Eureka Dashboard

kubectl port-forward svc/discovery-server 8761:8761 -n intelligent-supply-chain

๐Ÿ”ฅ Key Learnings

This project provided hands-on experience with:

  • Distributed Systems Architecture
  • Event-Driven Communication
  • Kafka-based Workflows
  • Kubernetes Networking
  • AWS EKS Infrastructure
  • Dockerized Deployments
  • Observability Engineering
  • Distributed Tracing
  • Cloud-native System Design
  • Microservices Communication
  • Debugging Production-style Failures

๐Ÿ”ฎ Future Improvements

  • AI-driven anomaly detection
  • Predictive inventory intelligence
  • Real-time analytics
  • Advanced scaling experiments
  • CI/CD automation
  • Security hardening

๐Ÿ“Ž GitHub Repository

Repository: https://github.com/98001yash/intelligent-supply-chain


๐Ÿ™Œ Final Note

This project was built to deeply understand how modern distributed systems, Kubernetes infrastructure, observability tooling, and event-driven microservices work together in real production-style environments.

About

AI-powered supply chain platform for demand forecasting, inventory optimization, logistics planning and real-time operational analytics.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors