Skip to content

FreshMarket is eCommerce Platform on .NET Core, PostGreSQL, Clean Architechture, CQRS.

License

Notifications You must be signed in to change notification settings

akhadov/fresh-market

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

.NET E-Commerce Reference Application - "Fresh Market"

A reference .NET application implementing an eCommerce web site using a clean architecture.

Features

  • 🌐 Minimal Endpoints - because it's fast & simple. ⚡

  • 🔑 Global Exception Handling - it's important to handle exceptions in a consistent way & protect sensitive information

  • 📝 OpenAPI/Swagger - easily document your API

  • 🗄️ Entity Framework Core - for data access

    • Comes with Migrations & Data Seeding
  • 🧩 Repository Pattern - abstract EF Core away from your business logic

  • 🔀 CQRS - for separation of concerns

  • 📦 MediatR - for decoupling your application

  • 📦 FluentValidation - for validating requests

  • 🆔 Strongly Typed IDs - to combat primitive obsession

    • Entity Framework can automatically convert the int, Guid, nvarchar(..) to strongly typed ID.
  • 🧪 Testing

    • Simpler Unit Tests for Application
    • Better Integration Tests
      • Integration Tests at Unit Test speed
      • Test Commands and Queries against a Real database
  • Architecture Tests

    • The tests are automated so discovering the defects is fast

Getting Started

Use these instructions to get the project up and running.

Prerequisites

You will need the following tools:

Setup

Follow these steps to get your development environment set up:

  1. Clone the repository
  2. At the root directory, restore required packages by running:
 dotnet restore
  1. Next, build the solution by running:
dotnet build
  1. Launch the back end within the \Src\WebApi directory by running:
dotnet run
  1. Launch https://localhost:5001/api in your browser to view the API

Technologies

  • .NET 8
  • ASP.NET Core 8
  • ASP.NET MVC
  • Entity Framework Core 8

Other Packages

  • MediatR
  • FluentValidation
  • Serilog
  • OpenApi
  • Swashbuckle