A modern, cloud-native e-commerce platform built with microservices architecture, demonstrating best practices in distributed systems design.

• Overview
• Architecture
• Features
• Tech Stack
• Prerequisites
• Getting Started
• Project Structure
• Development
• API Documentation
• Contributing
• License

GigaShop is a full-featured e-commerce platform built using microservices architecture. It demonstrates modern software development practices including:

• Microservices Architecture: Independent, scalable services
• Event-Driven Communication: Using RabbitMQ for async messaging
• API Gateway Pattern: YARP-based gateway for unified API access
• CQRS & Clean Architecture: Separation of concerns and maintainable code
• Containerization: Docker-based deployment
• Modern Frontend: React with TypeScript and shadcn/ui components

The application consists of the following microservices:

┌─────────────┐ │ Web UI │ (React + Vite + TypeScript) └──────┬──────┘ │ ┌──────▼──────────────┐ │ YARP API Gateway │ └──────┬──────────────┘ │ ├─────────────┬─────────────┬─────────────┐ │ │ │ │ ┌──────▼──────┐ ┌───▼────┐ ┌──────▼──────┐ ┌───▼────────┐ │ Catalog │ │ Basket │ │ Order │ │ Discount │ │ Service │ │ Service│ │ Service │ │ Service │ │ (PostgreSQL)│ │(Redis) │ │(SQL Server) │ │ (gRPC) │ └─────────────┘ └────────┘ └─────────────┘ └────────────┘ │ │ │ └─────────────┴─────────────┘ │ ┌──────▼──────┐ │ RabbitMQ │ │(Message Bus)│ └─────────────┘ 

• Catalog Service: Product catalog management with PostgreSQL
• Basket Service: Shopping cart with Redis cache
• Order Service: Order processing with SQL Server (CQRS pattern)
• Discount Service: Discount calculations via gRPC
• API Gateway: YARP reverse proxy for routing and aggregation
• Web UI: React-based customer-facing application

• 🛍️ Product browsing and search
• 🛒 Shopping cart management
• 💳 Order processing and tracking
• 🎫 Discount and coupon system
• 🔄 Real-time inventory updates
• 📱 Responsive web interface
• 🔐 Secure API gateway
• 📊 Event-driven architecture
• 🐳 Containerized deployment

• .NET 8: Latest LTS version of .NET
• ASP.NET Core: Web API framework
• Entity Framework Core: ORM for data access
• MediatR: CQRS and mediator pattern
• Carter: Minimal API endpoints
• Mapster: Object mapping
• FluentValidation: Input validation
• YARP: Reverse proxy and API gateway
• gRPC: High-performance RPC framework

• React 18: UI library
• TypeScript: Type-safe JavaScript
• Vite: Build tool and dev server
• TailwindCSS: Utility-first CSS
• shadcn/ui: Component library
• React Router: Client-side routing
• TanStack Query: Data fetching and caching
• React Hook Form: Form management
• Zod: Schema validation

• Docker & Docker Compose: Containerization
• PostgreSQL: Catalog and Basket databases
• SQL Server: Order database
• Redis: Distributed cache
• RabbitMQ: Message broker

Before you begin, ensure you have the following installed:

• Docker Desktop (v20.10 or higher)

  • Download for Windows
  • Download for Mac
  • Download for Linux

• .NET 8 SDK (for local development)

  • Download .NET 8

• Node.js 18+ (for frontend development)

  • Download Node.js

• Git

  • Download Git

# Check Docker docker --version docker compose version # Check .NET dotnet --version # Check Node.js node --version npm --version

git clone https://github.com/Lukada-taiya/gigashop.git cd gigashop

The easiest way to run the entire application:

cd src docker compose up -d

This will start all services:

• Web UI: http://localhost:6005
• API Gateway: http://localhost:6004
• Catalog API: http://localhost:6000
• Basket API: http://localhost:6001
• Order API: http://localhost:6003
• Discount gRPC: http://localhost:6002
• RabbitMQ Management: http://localhost:15672 (guest/guest)

# Check all containers are up docker compose ps # View logs docker compose logs -f # View specific service logs docker compose logs -f catalog.api

# Stop all services docker compose down # Stop and remove volumes (clean slate) docker compose down -v

gigashop/ ├── src/ │ ├── ApiGateways/ │ │ └── YarpApiGateway/ # API Gateway service │ ├── BuildingBlocks/ │ │ ├── BuildingBlocks/ # Shared libraries │ │ └── BuildingBlocks.Messaging/ # Messaging abstractions │ ├── Services/ │ │ ├── Basket/ │ │ │ └── Basket.API/ # Basket microservice │ │ ├── Catalog/ │ │ │ └── Catalog.API/ # Catalog microservice │ │ ├── Discount/ │ │ │ └── Discount.Grpc/ # Discount gRPC service │ │ └── Order/ │ │ ├── Order.API/ # Order API │ │ ├── Order.Application/ # Business logic │ │ ├── Order.Domain/ # Domain models │ │ └── Order.Infrastructure/ # Data access │ ├── Web/ # React frontend │ ├── compose.yaml # Docker Compose base │ ├── compose.override.yaml # Docker Compose overrides │ └── gigashop.sln # Solution file ├── .github/ # GitHub templates ├── CONTRIBUTING.md # Contribution guidelines ├── CODE_OF_CONDUCT.md # Code of conduct ├── LICENSE # MIT License └── README.md # This file 

cd src # Run Catalog API dotnet run --project Services/Catalog/Catalog.API # Run Basket API dotnet run --project Services/Basket/Basket.API # Run Order API dotnet run --project Services/Order/Order.API # Run Discount gRPC dotnet run --project Services/Discount/Discount.Grpc # Run API Gateway dotnet run --project ApiGateways/YarpApiGateway

cd src/Web # Install dependencies npm install # Run development server npm run dev # Build for production npm run build # Preview production build npm run preview # Lint code npm run lint

# Add a new migration (Order service example) cd src/Services/Order/Order.API dotnet ef migrations add MigrationName # Update database dotnet ef database update # Remove last migration dotnet ef migrations remove

cd src # Build all images docker compose build # Build specific service docker compose build catalog.api # Build without cache docker compose build --no-cache

Create a .env file in the src/ directory for local configuration:

# Database Connection Strings POSTGRES_USER=postgres POSTGRES_PASSWORD=postgres POSTGRES_DB=CatalogDb # SQL Server SA_PASSWORD=YourStrong@Passw0rd # Redis REDIS_PASSWORD= # RabbitMQ RABBITMQ_DEFAULT_USER=guest RABBITMQ_DEFAULT_PASS=guest # API URLs VITE_CART_SERVICE_URL=http://localhost:6004/basket-service VITE_PRODUCT_SERVICE_URL=http://localhost:6004/catalog-service VITE_USER_SERVICE_URL=http://localhost:6004/order-service

• GET /products - Get all products
• GET /products/{id} - Get product by ID
• GET /products/category/{category} - Get products by category
• POST /products - Create new product
• PUT /products - Update product
• DELETE /products/{id} - Delete product

• GET /basket/{userName} - Get user's basket
• POST /basket - Store/update basket
• DELETE /basket/{userName} - Delete basket
• POST /basket/checkout - Checkout basket

• GET /orders - Get all orders
• GET /orders/{orderName} - Get orders by name
• GET /orders/customer/{customerId} - Get customer orders
• POST /orders - Create order
• PUT /orders - Update order
• DELETE /orders/{id} - Delete order

• GetDiscount - Get discount for a product
• CreateDiscount - Create new discount
• UpdateDiscount - Update existing discount
• DeleteDiscount - Delete discount

# Run all tests dotnet test # Run tests with coverage dotnet test /p:CollectCoverage=true # Run specific test project dotnet test src/Services/Catalog/Catalog.Tests

Port conflicts:

# Check what's using a port lsof -i :6000 # macOS/Linux netstat -ano | findstr :6000 # Windows # Change ports in compose.override.yaml

Database connection issues:

# Reset databases docker compose down -v docker compose up -d

Frontend build errors:

cd src/Web rm -rf node_modules package-lock.json npm install

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

• Code of Conduct
• Development process
• Submitting pull requests
• Coding standards
• Testing requirements

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

• Adam Tungtaiya Lukman - Initial work - @maestro-00

• Built with modern .NET and React ecosystems
• Inspired by microservices best practices
• Community-driven development

• 📧 Email: Create an issue
• 💬 Discussions: GitHub Discussions
• 🐛 Bug Reports: Issue Tracker

Star ⭐ this repository if you find it helpful!