Skip to content

Home

Jump to bottom
Frederik Wulf edited this page May 1, 2023 · 27 revisions

Welcome to the ecommerce wiki!

E-Commerce Project based on microservice architecture build with Microsfot .net. In this wiki, we will explore some further aspects of the project, like infrastructure, architecture and general scope of functionality.

The main sections of the wiki can always be accessed from the sidebar on the right side.

Getting Started

  1. Install Docker

  2. Install DontNet CLI

  3. Reference the Common Nuget Package of the Project in the NuGet.Config. How to add a new source to the NuGet.Config (https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-nuget-add-source). Either do:

    1. Add the github nuget repository https://nuget.pkg.github.com/fredyyy998/index.json in your NuGet.Config

    or

    1. Build the package by yourself and pack the project with dotnet pack -o {direcotry path}
    2. Reference the local package directory in your NuGet.Config

  4. Setup the database (this hopefully wont be necessary soon)

    1. Install DotNet EF Core Tools
    2. Run docker-compose up -f docker-compose.infrastructure.yml up to start the infrastructure separately.
    3. Go into each service Web project (e.g cd src/Services/Account/Account.Web)
    4. Run dotnet ef database update
    5. Repeat step 3 and 4 for each service
    6. Run docker-compose down

  5. Run docker-compose up in the project root to start the docker container providing a postgres database, the infrastructure for Apache Kafka and each web service in a seperate container.

  6. When each container is running the services should be accessible:

Notes:

  • Each service has a swagger.json that is accessible via <serviceUrl>/swagger/index.html
  • A admin user is created by default with the following credentials:
  • A customer user can be created via the Account service.

Explore

Clone this wiki locally