🛒 EcommerceDDD

An experimental full-stack application showcasing cutting-edge technologies and architectural patterns for building scalable e-commerce systems.

⭐ If you find this project useful, please consider giving it a star! It helps others discover the project.

🏗️ Architecture

High-Level Overview

Detailed Architecture

📁 Project Structure

├── Core                    # Building blocks and abstractions
├── Core.Infrastructure     # Shared infrastructure implementations
│
├── Crosscutting
│   ├── ServiceClients      # Kiota-generated HTTP clients
│   ├── ApiGateway          # Ocelot API Gateway
│   ├── SignalR             # Real-time communication
│   └── IdentityServer      # Authentication & authorization
│
├── Services
│   ├── CustomerManagement
│   ├── InventoryManagement
│   ├── OrderProcessing
│   ├── PaymentProcessing
│   ├── ProductCatalog
│   ├── QuoteManagement
│   └── ShipmentProcessing
│
├── SPA                     # Angular frontend
└── docker-compose          # Container orchestration

Microservice Structure

Each microservice follows a clean vertical slice architecture.

├── EcommerceDDD.ProductCatalog
│   ├── API              # RESTful endpoints
│   ├── Application      # Use cases, commands & queries
│   ├── Domain           # Aggregates, entities, domain events
│   └── Infrastructure   # Data persistence & external integrations

🔗 Service Communication

External Communication (SPA → Backend)

• Koalesce.OpenAPI aggregates all OpenAPI definitions exposed in the API Gateway.
• Kiota generates typed TypeScript clients from this unified spec.
• The Angular SPA communicates through the API Gateway using the clients.

Internal Communication (Service-to-Service)

Microservices communicate directly using Kiota-generated typed HTTP clients.

🛠️ Tech Stack

Backend

Frontend

🔌 Getting Started

Running with Docker

Backend only — starts all microservices, databases, Kafka, and infrastructure:

Backend + Frontend — also builds and serves the Angular SPA at http://localhost:4200:

docker compose --profile frontend up

💡 Tip: You can also set docker-compose.dcproj as the startup project in Visual Studio for debugging.

Running the SPA locally (with hot-reload)

If you prefer running the frontend outside Docker for development, start the backend with docker compose up, then:

cd src/EcommerceDDD.Spa
npm install
ng serve

The app will be available at http://localhost:4200.

Advanced: Regenerating Kiota Clients

Tool services are defined in docker-compose.override.yml, which Docker Compose loads automatically alongside docker-compose.yml. After the main stack is running, use one of the commands below:

📧 Support & Contributing

• Issues: Report bugs or request features via GitHub Issues.
• Contributing: Contributions are welcome! Please read CONTRIBUTING.md before submitting PRs.

📄 License

This project is licensed under the terms of the LICENSE file.

Made with ❤️ by Felipe Henrique