Cloud-Native E-commerce Platform

A comprehensive cloud-native e-commerce platform built with microservices architecture, demonstrating modern software engineering practices and cloud technologies.

Features

• Microservices Architecture - Clean separation of concerns with independent deployable services
• Event-Driven Design - Asynchronous communication using RabbitMQ message broker
• Cloud-Native - Kubernetes deployment with Helm charts and Istio service mesh
• Observability - Comprehensive monitoring with Elastic Stack and distributed tracing
• Security - JWT authentication and authorization with Identity Server
• API Gateway - Centralized routing and cross-cutting concerns with Ocelot
• Modern UI - Responsive Angular frontend with Material Design

Architecture Overview

System Architecture

graph TB
    subgraph "Client Layer"
        Web[Web App<br/>Angular 18]
        Mobile[Mobile App<br/>Future]
    end
    
    subgraph "API Gateway"
        Gateway[Ocelot Gateway<br/>:8010]
    end
    
    subgraph "Identity & Security"
        Auth[Identity Server 4<br/>JWT Authentication]
    end
    
    subgraph "Microservices"
        Catalog[Catalog Service<br/>:8000]
        Basket[Basket Service<br/>:8001]
        Discount[Discount Service<br/>:8002]  
        Ordering[Ordering Service<br/>:8003]
    end
    
    subgraph "Data Layer"
        CatalogDB[(MongoDB<br/>Catalog DB)]
        BasketDB[(Redis<br/>Session Store)]
        DiscountDB[(PostgreSQL<br/>Discount DB)]
        OrderDB[(SQL Server<br/>Order DB)]
    end
    
    subgraph "Infrastructure"
        MessageBus[RabbitMQ<br/>Event Bus]
        Monitoring[Elastic Stack<br/>Observability]
    end
    
    Web --> Gateway
    Mobile --> Gateway
    Gateway --> Auth
    Gateway --> Catalog
    Gateway --> Basket
    Gateway --> Discount
    Gateway --> Ordering
    
    Catalog --> CatalogDB
    Basket --> BasketDB
    Discount --> DiscountDB
    Ordering --> OrderDB
    
    Basket --> MessageBus
    Ordering --> MessageBus
    Basket -.->|gRPC| Discount
    
    Catalog --> Monitoring
    Basket --> Monitoring
    Discount --> Monitoring
    Ordering --> Monitoring

Loading

Clean Architecture Pattern

graph TD
    subgraph "Each Microservice follows Clean Architecture"
        API[API Layer<br/>Controllers, Endpoints]
        App[Application Layer<br/>Commands, Queries, Handlers]
        Domain[Domain Layer<br/>Entities, Value Objects, Rules]
        Infra[Infrastructure Layer<br/>Repositories, External Services]
    end
    
    API --> App
    App --> Domain
    App --> Infra
    Infra --> Domain
    
    classDef apiStyle fill:#e3f2fd
    classDef appStyle fill:#f3e5f5  
    classDef domainStyle fill:#e8f5e8
    classDef infraStyle fill:#fff3e0
    
    class API apiStyle
    class App appStyle
    class Domain domainStyle
    class Infra infraStyle

Loading

Quick Start

Prerequisites

• Docker & Docker Compose
• .NET 8 SDK
• Node.js 18+ & npm
• Kubernetes (optional, for K8s deployment)

Local Development

# Clone the repository
git clone https://github.com/sloweyyy/cloud-native-ecommerce-platform.git
cd cloud-native-ecommerce-platform

# Start all services with Docker Compose
docker-compose -f docker-compose.yml -f docker-compose.override.yml up -d 

# Or use the deployment script
./deploy.sh

Access Applications

Service	URL	Description
Web App	http://localhost:4200	Angular Frontend
API Gateway	http://localhost:8010	Ocelot Gateway
Kibana	http://localhost:5601	Log Analytics
RabbitMQ	http://localhost:15672	Message Broker UI
Prometheus	http://localhost:9090	Metrics
Grafana	http://localhost:3000	Dashboards

Tech Stack

Backend Services

• .NET 8 - Modern C# runtime and framework
• ASP.NET Core - Web API framework
• MediatR - CQRS and Mediator pattern implementation
• AutoMapper - Object-to-object mapping
• FluentValidation - Input validation
• Serilog - Structured logging

Databases & Storage

• MongoDB - Document database for catalog service
• Redis - In-memory cache for basket service
• PostgreSQL - Relational database for discount service
• SQL Server - Enterprise database for ordering service

Message Broker & Communication

• RabbitMQ - Asynchronous messaging
• gRPC - High-performance RPC framework
• SignalR - Real-time communication

Frontend

• Angular 18 - Modern web framework
• TypeScript - Type-safe JavaScript
• Angular Material - UI component library
• RxJS - Reactive programming
• NgRx - State management (optional)

Infrastructure & DevOps

• Docker - Containerization
• Kubernetes - Container orchestration
• Helm - Kubernetes package manager
• Istio - Service mesh
• Ocelot - API Gateway
• Identity Server 4 - Authentication & authorization

Monitoring & Observability

• Elasticsearch - Search and analytics engine
• Kibana - Data visualization
• Prometheus - Metrics collection
• Grafana - Monitoring dashboards
• Jaeger - Distributed tracing

Business Flow

E-commerce User Journey

journey
    title Customer Shopping Journey
    section Browse Products
      Visit Website: 5: Customer
      View Catalog: 4: Customer, Catalog Service
      Search Products: 4: Customer, Catalog Service
    section Add to Cart
      Select Product: 5: Customer
      Add to Basket: 4: Customer, Basket Service
      Apply Discount: 3: Customer, Discount Service
    section Checkout
      Review Cart: 4: Customer, Basket Service
      Place Order: 5: Customer, Ordering Service
      Payment: 3: Customer, Payment Service
    section Post-Purchase
      Order Confirmation: 5: Customer, Ordering Service
      Track Order: 4: Customer, Ordering Service

Loading

Project Structure

├── Services/                    # Microservices
│   ├── Catalog/                # Product catalog service
│   ├── Basket/                 # Shopping basket service  
│   ├── Discount/               # Discount management service
│   └── Ordering/               # Order processing service
├── client/                     # Angular frontend
├── ApiGateways/                # API gateway
├── Infrastructure/             # Shared libraries
├── Deployments/                # K8s & Helm charts
└── PostmanCollection/          # API testing

Configuration

Environment Variables

# Database Connections
CATALOG_DB=mongodb://localhost:27017/catalog
BASKET_DB=redis://localhost:6379
DISCOUNT_DB=postgresql://localhost:5432/discount
ORDERING_DB=sqlserver://localhost:1433/ordering

# Message Broker
RABBITMQ_URL=amqp://localhost:5672

# Monitoring
ELASTICSEARCH_URL=http://localhost:9200

Testing

# Run unit tests
dotnet test

# Run integration tests
dotnet test --filter Category=Integration

# API testing with Postman collections
newman run PostmanCollection/

Monitoring & Observability

The platform includes comprehensive monitoring capabilities:

• Application Metrics - Custom business metrics via Prometheus
• Infrastructure Monitoring - Container and cluster metrics
• Distributed Tracing - Request tracing across microservices
• Centralized Logging - Structured logs aggregated in Elasticsearch
• Health Checks - Service health monitoring and alerting

Security

• Authentication - JWT tokens via Identity Server 4
• Authorization - Role-based access control
• API Security - Rate limiting and request validation
• Network Security - Service mesh with mTLS
• Data Protection - Encryption at rest and in transit

Deployment

For detailed deployment instructions, please refer to our comprehensive deployment guides:

• Quick Start Guide - Get up and running in minutes
• Complete Deployment Guide - Detailed step-by-step instructions
• Deployment Configuration Guide - Current service configurations and port mappings
• Deployment Scripts:
  • ./deploy.sh - Full deployment with monitoring
  • ./quick-deploy.sh - Minimal deployment for development
  • ./start.sh - Start existing deployment
  • ./cleanup.sh - Clean up all resources

Quick Commands

# One-command deployment (15-20 minutes)
./deploy.sh

# Quick development setup (5 minutes)
./quick-deploy.sh

# Start existing deployment (30 seconds)
./start.sh

# Complete cleanup
./cleanup.sh

Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Setting up the development environment
• Coding standards and guidelines
• Testing requirements
• Pull request process
• Issue reporting guidelines

Also review our Code of Conduct and Security Policy.

License

This project is licensed under the MIT License - see the LICENSE file for details.