DevStore | A microservices e-commerce reference application built with ASP.NET 9

A real-world reference application powered by desenvolvedor.io implementing the most common and used technologies to share with the technical community the best way to develop full and complex applications with .NET

---

This project was inspired by EShopOnContainers. However, the real motivation was to build it by "our way."

The EShopOnContainers is an awesome project. However, the code has some "bad smells." We found it difficult to start learning/using EShopOnContainers compared to DevStore. We like to think of the DevStore as a simplified (but no less complex) version and written with more care in code and small details. We also focused only on the Web architecture with ASP.NET.

Give a Star! ⭐

If you liked the project or if DevStore is helping you, please give us a star ;)

Want to learn everything to build an app like this? 🎓

Check these online courses at desenvolvedor.io (only in Portuguese)

• ASP.NET Core Expert
• Software Architect

Technologies / Components implemented

• .NET 9

  • ASP.NET MVC Core
  • ASP.NET WebApi
  • ASP.NET Minimal API
  • ASP.NET Identity Core
  • Refresh Token
  • JWT with rotating public/private keys
  • gRPC
  • Background Services
  • Entity Framework Core

• Components / Services

  • RabbitMQ
  • EasyNetQ
  • Refit
  • Polly
  • Bogus
  • Dapper
  • FluentValidator
  • MediatR
  • Swagger UI with JWT support
  • NetDevPack
  • NetDevPack.Identity
  • NetDevPack.Security.JWT

• Hosting

  • IIS
  • NGINX
  • Docker (with composing)

Architecture:

Complete architecture implementing the most important and used concerns as:

• Hexagonal Architecture
• Clean Code
• Clean Architecture
• DDD - Domain Driven Design (Layers and Domain Model Pattern)
• Domain Events
• Domain Notification
• Domain Validations
• CQRS (Immediate Consistency)
• Retry Pattern
• Circuit Breaker
• Unit of Work
• Repository
• Specification Pattern
• API Gateway / BFF

---

Architecture Overview

The entire application is based on a unique solution with 7 APIs and one web application (MVC)

---

This is a reference application, each microservice has its own database and represents a bounded context (DDD concept). There is a BFF / API Gateway to manage the Basket / Order / Payment requests and data structure from responses.

---

Getting Started

You can run the DevStore project on any operating system. **Make sure you have installed docker in your environment. ** (Get Docker Installation)

Clone the DevStore's repository and navigate to the /Docker folder and then:

If you just want to run the DevStore application in your Docker environment:

docker-compose up

If you want to build the local images and run the DevStore application in your Docker environment:

This docker compose will provide one database container per each API service.

docker-compose -f docker-compose-local.yml up --build

If you prefer to save resource, then use the light local docker compose:

This docker compose will provide just one database container for all API services.

docker-compose -f docker-compose-local-light.yml up --build

---

If you want to run locally with Visual Studio / VSCode:

You will need:

• Docker
• MS-SQL Server instance (or container)
• RabbitMQ

So you can edit the Docker compose to just run the database and queue dependencies and save your time.

If you want Visual Studio with F5 and debug experience:

• You will need at least Visual Studio 2022 and .NET 6.
• The latest SDK and tools can be downloaded from https://dot.net/core
• Set up the solution to start multiple projects and hit F5

---

If you want Visual Studio Code experience:

• Open the VSCode on the root directory (solution file)
• Create a new launch.json at VSCode debug section and use the configuration below to set up the option "Start all projects"

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "DevStore MVC WebApp",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/src/web/DevStore.WebApp.MVC/bin/Debug/net9.0/DevStore.WebApp.MVC.dll",
            "args": [],
            "cwd": "${workspaceFolder}/src/web/DevStore.WebApp.MVC",
            "console": "internalConsole",
            "stopAtEntry": false
        },
        {
            "name": "DevStore Billing API",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/src/services/DevStore.Billing.API/bin/Debug/net9.0/DevStore.Billing.API.dll",
            "args": [],
            "cwd": "${workspaceFolder}/src/services/DevStore.Billing.API",
            "console": "internalConsole",
            "stopAtEntry": false
        },
        {
            "name": "DevStore Catalog API",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/src/services/DevStore.Catalog.API/bin/Debug/net9.0/DevStore.Catalog.API.dll",
            "args": [],
            "cwd": "${workspaceFolder}/src/services/DevStore.Catalog.API",
            "console": "internalConsole",
            "stopAtEntry": false
        },
        {
            "name": "DevStore Customers API",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/src/services/DevStore.Customers.API/bin/Debug/net9.0/DevStore.Customers.API.dll",
            "args": [],
            "cwd": "${workspaceFolder}/src/services/DevStore.Customers.API",
            "console": "internalConsole",
            "stopAtEntry": false
        },
        {
            "name": "DevStore Identity API",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/src/services/DevStore.Identity.API/bin/Debug/net9.0/DevStore.Identity.API.dll",
            "args": [],
            "cwd": "${workspaceFolder}/src/services/DevStore.Identity.API",
            "console": "internalConsole",
            "stopAtEntry": false
        },
        {
            "name": "DevStore Orders API",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/src/services/DevStore.Orders.API/bin/Debug/net9.0/DevStore.Orders.API.dll",
            "args": [],
            "cwd": "${workspaceFolder}/src/services/DevStore.Orders.API",
            "console": "internalConsole",
            "stopAtEntry": false
        },
        {
            "name": "DevStore ShoppingCart API",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/src/services/DevStore.ShoppingCart.API/bin/Debug/net9.0/DevStore.ShoppingCart.API.dll",
            "args": [],
            "cwd": "${workspaceFolder}/src/services/DevStore.ShoppingCart.API",
            "console": "internalConsole",
            "stopAtEntry": false
        },
        {
            "name": "DevStore BFF Checkout",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/src/api-gateways/DevStore.Bff.Checkout/bin/Debug/net9.0/DevStore.Bff.Checkout.dll",
            "args": [],
            "cwd": "${workspaceFolder}/src/api-gateways/DevStore.Bff.Checkout",
            "console": "internalConsole",
            "stopAtEntry": false
        }
    ],
    "compounds": [
        {
            "name": "Start all projects",
            "configurations": [
                "DevStore MVC WebApp",
                "DevStore Billing API",
                "DevStore Catalog API",
                "DevStore Customers API",
                "DevStore Identity API",
                "DevStore Orders API",
                "DevStore ShoppingCart API",
                "DevStore BFF Checkout"
            ],
            "stopAll": true
        }
    ]
}   

Disclaimer

• This is not an architectural template or bootstrap model for new apps
• All implementations were made for the real world, but the goal is to share knowledge
• In case it is too many implementations included, remove the excess and try to avoid over-engineering

Pull-Requests

Open an issue and let's discuss! Do not submit PRs for undiscussed or unapproved features.

If you want to help us, choose an approved issue and implement it.

We are Online

See the project running on DevStore official instance

About

DevStore was proudly developed by desenvolvedor.io ❤ team under the MIT license.