Skip to content

Home

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

Welcome to the ecommerce wiki!

This E-Commerce Project is 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

The project was build with .net version 6.0.16. The following instructions will take advantage of the github package repositories, where NuGet packages and Docker images are deployed. If you are more comfortable with using your own images take a look on the Deployment page. There you can find two sections on how to build NuGet and Docker locally.

  1. Install Docker

  2. Install DotNet

  3. Get the common NuGet packages of the project

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

    1. Install DotNet EF Core Tools
    2. Run docker-compose -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 separate 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