Coder Social home page Coder Social logo

edward-teixeira / dev-store Goto Github PK

View Code? Open in Web Editor NEW

This project forked from desenvolvedor-io/dev-store

0.0 0.0 0.0 7.22 MB

A microservices e-commerce reference application built with ASP.NET 6

Home Page: https://devstore.academy

License: MIT License

Shell 0.20% JavaScript 1.61% C# 81.32% CSS 0.18% HTML 15.51% Dockerfile 1.18%

dev-store's Introduction

logo logo

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

A real-world reference application powered by desenvolvedor.io Brasil 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 ;)

DevStore

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

Check this online courses at desenvolvedor.io (only in portuguese)

Technologies / Components implemented

  • .NET 6

    • ASP.NET MVC Core
    • ASP.NET WebApi
    • ASP.NET Minimal API
    • ASP.NET Identity Core
    • Refresh Token
    • JWT with rotactive public / private key
    • GRPC
    • Background Services
    • Entity Framework Core 6

  • 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 compose)

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 (Imediate Consistency)
  • Retry Pattern
  • Circuit Breaker
  • Unit of Work
  • Repository
  • Specification Pattern
  • API Gateway / BFF

Architecture Overview

The entire application is based in an unique solution with 7 API's and one web application (MVC)

read before

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.

read before

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 DevStore repository and navigate to the /Docker folder and then:

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

docker-compose up

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

This compose will provide one database container each API service.

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

If you prefer save machine resources use the light local compose:

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

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

If you want run locally with VS/VS Code:

You will need:

  • Docker
  • SQL 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
  • Setup the solution to start multiple projects and hit F5

image

If you want Visual Studio Code experience:

  • Open the VS Code on root directory (solution file)
  • Create a new launch.json at VS Code debug section and use the configuration below to setup 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/net6.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/net6.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/net6.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/net6.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/net6.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/net6.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/net6.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/net6.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
  • Maybe you don't need many implementations included, 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❤Brasil team under the MIT license.

dev-store's People

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.