bojanv91 / ContosoUniversity

DEMO codebase

Contoso University - an opinionated vertical slices and CQRS implementation example

NOTE: The codebase is only for DEMO purposes.

Get Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

• Visual Studio 2017
• .NET Core SDK 2.1
• PostgreSQL 10+
• plv8 extension for PostgreSQL

Installing

A step by step series of examples that tell you how to setup a development environment. This section assumes you have already installed the prerequisites.

• Clone the GIT repo in a local folder.
• Open pgAdmin (a Postgres database server administration tool).
• Create PostgreSQL database named contosouni (or whatever name).
• Create PostgreSQL database named contosouni_integrationtests (or whatever name).
• Install the plv8 extension in both databases using this SQL statement: create extension plv8;
• Create local appsettings.Development.json to src/ContosoUniversity.API.
• Create local appsettings.IntegrationTests.json to src/ContosoUniversity.API.
• Set values in the newly created config files following appsettings.json file as a template.
• Open ContosoUniversity.sln in Visual Studio and run all tests.
• Run ContosoUniversity.API project in browser and navigate to /docs to view API documentation generated by Swagger.
• Your machine is ready.

Technologies used

• ASP.NET Core
• MediatR
• Marten
• FluentValidation
• Serilog
• xUnit
• Shouldly
• Flurl