CPSC-5200-Software-Architecture-Design

CPSC 5200 Software Architecture and Design based on the eShop reference Application - "Northern Mountains"

A reference .NET application implementing an eCommerce web site using a services-based architecture.

Getting Started

Features and requirements

Let's start with a review of the application's features and requirements. The eShopOnContainers application represents an online store that sells various physical products like t-shirts and coffee mugs. If you've bought anything online before, the experience of using the store should be relatively familiar. Here are some of the basic features the store implements:

List catalog items Filter items by type Filter items by brand Add items to the shopping basket Edit or remove items from the basket Checkout Register an account Sign in Sign out Review orders

Prerequisites

• Clone the eShop repository: https://github.com/dotnet/eshop
• (Windows only) Install Visual Studio. Visual Studio contains tooling support for .NET Aspire that you will want to have. Visual Studio 2022 version 17.10 Preview.
  • During installation, ensure that the following are selected:
    • ASP.NET and web development workload.
    • .NET Aspire SDK component in Individual components.
• Install the latest .NET 8 SDK
• On Mac/Linux (or if not using Visual Studio), install the Aspire workload with the following commands:

dotnet workload update
dotnet workload install aspire
dotnet restore eShop.Web.slnf

• Install & start Docker Desktop: https://docs.docker.com/engine/install/

Running the solution

Warning

Remember to ensure that Docker is started

• (Windows only) Run the application from Visual Studio:

• Open the eShop.Web.slnf file in Visual Studio
• Ensure that eShop.AppHost.csproj is your startup project
• Hit Ctrl-F5 to launch Aspire

• Or run the application from your terminal:

dotnet run --project eShop.AppHost/eShop.AppHost.csproj

then look for lines like this in the console output in order to find the URL to open the Aspire dashboard:

Now listening on: http://localhost:18848

Sample data

The sample catalog data is defined in catalog.json. Those product names, descriptions, and brand names are fictional and were generated using GPT-35-Turbo, and the corresponding product images were generated using DALL·E 3.

Contributing

For more information on contributing to this repo, please read the contribution documentation and the Code of Conduct.

References

Azure Data Studio: Postgres Quickstart