Giter Club home page Giter Club logo

ecommerceddd's Introduction

Build License

Welcome to Ecommerce DDD

This project is a showcase of a full-stack application I use to combine several cutting-edge technologies and architectural patterns. It is based on Domain-Driven Design at its core for implementing a clean-architectured API that powers up an Angular-based SPA application.

Thanks for getting here! please give a โญ if you liked the project. It motivates me to keep improving it.

Screenshots






Architecture

Domain

This is where the business logic resides, with a structured implementation of the domain through aggregates, entities, value objects, domain services, repository definitions, and domain events.

Domain SeedWork

It defines the domain building blocks, such as entities, value objects, aggregate root, repositories, services and so on.

Application

It orchestrates the interactions between the external world (API/SPA) and the domain. It is concerned with defining the jobs needed to be done to accomplish a certain application task. Since the project is based on CQRS/EventSourcing architecture, it defines and handles commands, queries and events.

Infrastructure

It takes care of the application's infrastructure and issues not related to the business itself. It is responsible for database mapping (ORM), domain repository implementation, identity authentication and user claims, JWT authentication, tooling for processing and publishing messages, Inversion of Control and everything needed to support the upper layers.

Presentation

  • Web API: A restful API providing endpoints with secured routes based on user claims. It also implements and host a Background Service for processing and publishing stored events.
  • SPA: A lightweight Angular-based application providing a functional and user-friendly UI.

Technologies used

  • ASP.NET Core and C# 10 for cross-platform back-end with:
    • .NET 6
    • Entity Framework Core 6
    • ASP.NET Core Web API
    • ASP.NET Core Identity
    • SignalR Core
    • JWT Bearer Authentication
    • MediatR
    • Fluent Validation
    • Automapper
    • NSubstitute
    • Swagger
    • Docker Compose
  • Angular 12 and TypeScript for the front-end with:
    • NgBootstrap
    • Font Awesome
    • Toastr
    • Angular JWT

What do you need to run

Running the WebAPI

Set EcommerceDDD.Api as the Startup project and run

 $ docker-compose up --build

Running the Angular SPA

Using a terminal, navigate to EcommerceDDD.Spa and run for the node packages and serving the SPA on http://localhost:4200 respectively:

 $ npm install
 $ ng serve

Notes:

  • The docker-compose.yml is targeting the OS to Linux and setting up the with SQL Server 2019 for Ubuntu
  • When registering your first customer, it will create the database structure automatically. DataSeeder will add some products for you if the Products table is empty.

ecommerceddd's People

Contributors

falberthen avatar

Watchers

 avatar

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.