robpearson / Northwind365

Code Samples for the SSW FireBootCamp .NET Core Dev Superpowers Tour

Northwind 365

Northwind 365 is a sample application built using ASP.NET Core and Entity Framework Core. The architecture and design of the project is explained in the video:

• Clean Architecture with ASP.NET Core (slide deck)

The initial construction of this project is explained in the following blog posts:

• Code: Northwind Traders with Entity Framework Core
• Create Northwind Traders Code First with Entity Framework Core – Part 1
• Create Northwind Traders Code First with Entity Framework Core – Part 2

Getting Started

Use these instructions to get the project up and running.

Prerequisites

You will need the following tools:

• Visual Studio or VS Code, or Rider
• .NET 7 SDK
• Node.js (version 10 or later) with npm (version 6.11.3 or later)
• Angular CLI (version 8.3.23 or later) - install by running npm install -g @angular/cli

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

3. Next, build the solution by running:

dotnet build

5. Once the front end has started, within the \Src\WebUI directory, launch the back end by running:

dotnet run

6. Launch https://localhost:44427/ in your browser to view the Web UI

7. Launch https://localhost:44376/api in your browser to view the API

Technologies

• .NET 8
• ASP.NET Core 8
• Entity Framework Core 8
• Angular 15

Other Packages

• MediatR
• FluentValidation
• AutoMapper
• Ardalis.Specification
• Ardalis.GuardClauses

Testing Packages

• xUnit
• NSubstitute
• TestContainers
• Fluent Assertions
• Respawn
• Bogus

Marketing

Marketing site can be found at northwind365.com which is deployed from Northwind365.Website.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.