/AuctionSystem

Auction system written in ASP.NET Core

Primary LanguageC#MIT LicenseMIT

AuctionSystem

Auction System is an open-source web project where users can create multiple auctions, set the date of the auction and then users are able to bid for the given item. When the auction ends the user with the highest bid wins the item.

Azure DevOps - Build Status

Build Status

Branches

  1. master - as this was one of the first projects I've developed, I decided to refactor the project in my free time. I've used CQRS pattern with MediatR. The mvc project is the same, I just built an API gateway, a new SPA and improved abstraction by using Clean Architecture. Down below you will find more information about the Clean Architecture.
  2. mvc-with-services - simple mvc project

Clean Architecture

Here's the basic architecture of this microservice template:

  • Respecting policy rules, with dependencies always pointing inward
  • Separation of technology details from the rest of the system
  • SOLID
  • Single responsibility of each layer

CQRS diagram

Automatically generated users

Username Password Role
admin@admin.com admin123 Administrator
test1@test.com test123 User
test2@test.com test123 User

Getting started

Set up Cloudinary (required)

  1. Register a Cloudinary account.
  2. Create a Cloud, API key and API secret.
  3. In the Presentation/Api/appsettings.json and Presentation/MvcWeb/appsettings.json configuration files insert the Cloud name, API key and API secret.

Example:

"Cloudinary": {
  "CloudName": "AuctionSystemCloud",
  "ApiKey": "488*********516",
  "ApiSecret": "3m7******************KdS"
}

Set up email notification functionality (required)

  1. Register a SendGrid account.
  2. Create an API key.
  3. Insert the API key in the following files:
    • Presentation/Api/appsettings.json
    • Presentation/MvcWeb/appsettings.json

Example:

"SendGrid": {
  "ApiKey": "SG.5******************************************************DO-zfRp"
}

Set up redis cache in Api project(optional)

  1. Follow the docs
  2. In Presentation/Api/appsettings.json set RedisCacheSettings Enabled property to true

Example:

"RedisCacheSettings": {
    "Enabled": true,
    "ConnectionString": "localhost"
  },

To run the project:

  1. In the /Presentation/Api folder, run in terminal:
dotnet run

and the project should be running now on https://localhost:5001

  1. In the /Presentation/SpaWeb folder, run in terminal:
  • npm install
  • npm start

the project should be running on http://localhost:3000

  1. Enjoy!!!

P.S If you're too lazy to setup and run this project, here's a short overview of the project.

Video:

🔥 And last but not least, make sure you check out my other projects which are way cooler and complex 🙂

BankSystem

AlgorithmVisualizer