MadWorldSuite

MadWorldSuite is a captivating hobby project that serves as a powerful platform for me to delve into the realms of Azure, Blazor, and Azure Functions. As a passionate learner, I have embarked on this exciting journey to explore and master these cutting-edge technologies while building a collection of diverse tools, a personalized CV, and a host of other thrilling

Table of Contents

1. MadWorldSuite
2. Running Environments
3. Pre-requisites
4. How to Install and Run the Project
5. How to Run the Tests
6. Azure Resources
7. Other Readme's
8. Currently maintained by

Running Environments

The following environments are currently running in Azure:

Frontend:

• MadWorld.Frontend.UI.Admin -> admin.mad-world.nl
• MadWorld.Frontend.UI.Suite -> www.mad-world.nl

Backend:

• MadWorld.Backend.API.Anonymous -> api.mad-world.nl/anonymous
• MadWorld.Backend.API.Authorized -> api.mad-world.nl/authorized

Pre-requisites

Make sure you have installed all of the following prerequisites on your development machine:

• Rider - Download & Install Rider or another IDE of your choice.
• Git - Download & Install Git. OSX and Linux machines typically have this already installed.
• Docker - Download & Install Docker
• Dotnet 7 - Download & Install Dotnet 7
• Azurite - Download & Install Azurite

How to Install and Run the Project

First make sure that azurite is running:

azurite -l /tmp/azurite # Use a temporary folder for storage

Set multiple startup projects:

• MadWorld.Backend.Api.Anonymous
• MadWorld.Backend.Api.Authorized
• MadWorld.Backend.JobRunner
• MadWorld.Frontend.Admin.UI
• MadWorld.Frontend.Suite.UI

Set functions host arguments:

• MadWorld.Backend.Api.Anonymous
  • host start --pause-on-error --cors * --port 7071
• MadWorld.Backend.Api.Authorized
  • host start --pause-on-error --cors * --port 7072
• MadWorld.Backend.JobRunner
  • host start --pause-on-error --cors * --port 7073

Configure your AzureAd B2C your MadWorld.Frontend.UI.Suite configurations in appsettings.Development.json

Configure your AzureAd B2C your MadWorld.Frontend.UI.Admin configurations in appsettings.Development.json

Configure your AzureAd B2C in your MadWorld.Backend.API.Anonymous configurations by:

• Copy local.settings.example.json and name the file local.settings.json

Configure your AzureAd B2C in your MadWorld.Backend.API.Authorized configurations by:

• Copy local.settings.example.json, change the <TEMP> values and name the file local.settings.json

Run happily your project!

How to Run the Tests

First make sure that Docker Desktop is running:

# Windows
C:\Program Files\Docker\Docker\Docker Desktop.exe

# Linux
systemctl --user start docker-desktop

# MacOS
open -a Docker

Then run the following command to run all tests:

cd MadWorld
dotnet test

When all unit and integration tests pass, you should observe the following output for each test project:

Passed!  - Failed:     0, Passed:     2, Skipped:     0, Total:     2, 
Duration: 6 s - MadWorld.Backend.Api.Anonymous.IntegrationTests.dll (net7.0)

Azure Resources

The following Azure resources are currently running in my Azure environment:

• Azure Static Web App (2x)
• Azure Functions (3x)
• Azure API Management
• Azure Storage
• Azure Key Vault
• Azure Application Insights (3x)
• Azure App Service Plan (2x)
• Azure Log Analytics Workspace
• Azure B2C

Other Readme's

• Use Microsoft Monaco
• C4 Models

Currently maintained by

• Oscar Veldman