✨ 1 auto register modules and endpoints

.editorconfig

@@ -0,0 +1,41 @@
+# Remove the line below if you want to inherit .editorconfig settings from higher directories
+root = true
+
+##########################################################################################
+#
+# CODE STYLE RULES
+#
+##########################################################################################
+
+# All files
+[*]
+indent_style = space
+
+# Xml files
+[*.{xml,yml,json}]
+indent_size = 2
+tab_width = 2
+
+# C# Projects
+[*.csproj]
+indent_size = 4
+tab_width = 4
+
+# C# files
+[*.cs]
+indent_size = 4
+tab_width = 4
+
+# New line preferences
+end_of_line = lf
+insert_final_newline = false
+
+# File scoped namespaces
+csharp_style_namespace_declarations = file_scoped:silent
+
+csharp_prefer_braces = when_multiline
+
+# https://learn.microsoft.com/en-gb/dotnet/fundamentals/code-analysis/style-rules/ide0007-ide0008
+csharp_style_var_for_built_in_types = true
+csharp_style_var_when_type_is_apparent = true
+csharp_style_var_elsewhere = true

.github/workflows/dotnet.yml

@@ -8,21 +8,42 @@ on:
     branches: [ "main" ]
   pull_request:
     branches: [ "main" ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  actions: read
+  checks: write
 
 jobs:
   build:
 
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
+
     - name: Setup .NET
-      uses: actions/setup-dotnet@v3
+      uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: 8.0.x
+        dotnet-version: 9.0.x
+
+    - name: Install Aspire
+      run: dotnet workload install aspire --include-previews
+
     - name: Restore dependencies
       run: dotnet restore
+
     - name: Build
-      run: dotnet build --no-restore
+      run: dotnet build --no-restore -c Debug
+
     - name: Test
-      run: dotnet test --no-build --verbosity normal
+      run: dotnet test --no-build --verbosity normal -c Debug --logger "trx;LogFileName=test-results.trx"
+
+    - name: Test Report
+      uses: dorny/test-reporter@v1
+      if: success() || failure()
+      with:
+        name: Tests Results
+        path: "**/test-results.trx"
+        reporter: dotnet-trx

ADRs.md

@@ -0,0 +1,20 @@
+# Architectural Decision Records
+
+## ADR1 - Ensure Related Data is Created When Seeding the DB
+
+### Context
+
+In normal execution of the application DB updates will cause domain events to fire.  These domain events can have side affects that cause other DB updates.
+
+There are several pieces of complicated infrastructure that make this work.
+
+We need to ensure that related data is updated when seeding the DB via the following:
+
+- `WarehouseDbContextInitializer`
+- `CatalogDbContextInitializer`
+
+### Decision
+
+Instead of emulating the domain event propagating infrastructure, we will instead pass the data between initializers.  This means a bit more manual work, but is a much simpler solution.
+
+If this turns out to be too complex in future we will need to revist this.

Directory.Build.props

@@ -0,0 +1,20 @@
+<Project>
+    <PropertyGroup>
+        <TargetFramework>net9.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+
+        <GenerateDocumentationFile>true</GenerateDocumentationFile>
+        <!-- Remove exceptions for NUXXXX warnings -->
+        <NoWarn>CS1591,NU1902,NU1903,NU1904</NoWarn>
+
+        <!-- Configure code analysis. -->
+        <AnalysisLevel>latest</AnalysisLevel>
+        <!-- TODO: Upgrade to 'Recommended' -->
+        <AnalysisMode>Minimum</AnalysisMode>
+        <TreatWarningsAsErrors Condition="'$(Configuration)' == 'Release'">true</TreatWarningsAsErrors>
+        <CodeAnalysisTreatWarningsAsErrors Condition="'$(Configuration)' == 'Release'">true</CodeAnalysisTreatWarningsAsErrors>
+        <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
+
+    </PropertyGroup>
+</Project>

ModularMonolith.Catalog.slnf

@@ -0,0 +1,13 @@
+{
+  "solution": {
+    "path": "ModularMonolith.sln",
+    "projects": [
+      "src\\Common\\Common.SharedKernel\\Common.SharedKernel.csproj",
+      "src\\Common\\Common.Tests\\Common.Tests.csproj",
+      "src\\Modules\\Products\\Modules.Catalog.Tests\\Modules.Catalog.Tests.csproj",
+      "src\\Modules\\Products\\Modules.Catalog\\Modules.Catalog.csproj",
+      "src\\WebApi\\WebApi.csproj",
+      "tools\\Database\\Database.csproj"
+    ]
+  }
+}

ModularMonolith.slnx

@@ -0,0 +1,41 @@
+<Solution>
+  <Folder Name="/.docs/">
+    <File Path="README.md" />
+  </Folder>
+  <Folder Name="/.sln/">
+    <File Path=".editorconfig" />
+    <File Path="Directory.Build.props" />
+  </Folder>
+  <Folder Name="/src/">
+    <Project Path="src\AppHost\AppHost.csproj" Type="Classic C#" />
+    <Project Path="src\WebApi.Tests\WebApi.Tests.csproj" Type="Classic C#" />
+    <Project Path="src\WebApi\WebApi.csproj" Type="Classic C#" />
+  </Folder>
+  <Folder Name="/src/Common/">
+    <Project Path="src\Common\Common.ServiceDefaults\Common.ServiceDefaults.csproj" Type="Classic C#" />
+    <Project Path="src\Common\Common.SharedKernel\Common.SharedKernel.csproj" Type="Classic C#" />
+    <Project Path="src\Common\Common.Tests\Common.Tests.csproj" Type="Classic C#" />
+  </Folder>
+  <Folder Name="/src/Modules/" />
+  <Folder Name="/src/Modules/Catalog/">
+    <Project Path="src\Modules\Products\Modules.Catalog.Messages\Modules.Catalog.Messages.csproj" Type="Classic C#" />
+    <Project Path="src\Modules\Products\Modules.Catalog.Tests\Modules.Catalog.Tests.csproj" Type="Classic C#" />
+    <Project Path="src\Modules\Products\Modules.Catalog\Modules.Catalog.csproj" Type="Classic C#" />
+  </Folder>
+  <Folder Name="/src/Modules/Customers/">
+    <Project Path="src\Modules\Customers\Modules.Customers.Tests\Modules.Customers.Tests.csproj" Type="Classic C#" />
+    <Project Path="src\Modules\Customers\Modules.Customers\Modules.Customers.csproj" Type="Classic C#" />
+  </Folder>
+  <Folder Name="/src/Modules/Orders/">
+    <Project Path="src\Modules\Orders\Modules.Orders.Tests\Modules.Orders.Tests.csproj" Type="Classic C#" />
+    <Project Path="src\Modules\Orders\Modules.Orders\Modules.Orders.csproj" Type="Classic C#" />
+  </Folder>
+  <Folder Name="/src/Modules/Warehouse/">
+    <Project Path="src\Modules\Warehouse\Modules.Warehouse.Messages\Modules.Warehouse.Messages.csproj" Type="Classic C#" />
+    <Project Path="src\Modules\Warehouse\Modules.Warehouse.Tests\Modules.Warehouse.Tests.csproj" Type="Classic C#" />
+    <Project Path="src\Modules\Warehouse\Modules.Warehouse\Modules.Warehouse.csproj" Type="Classic C#" />
+  </Folder>
+  <Folder Name="/tools/">
+    <Project Path="tools\MigrationService\MigrationService.csproj" Type="Classic C#" />
+  </Folder>
+</Solution>

README.md

@@ -27,3 +27,51 @@ Responsible for Warehouse and Inventory Management
 - Restocking - When do we need to restock?
 - Backorders - When do we put items on back order?
 - Product Management
+
+## Business Invariants
+
+Warehouse:
+- ✅ An Aisle cannot have duplicate bays
+- ✅ A bay cannot have duplicate shelves
+
+Product Catalog:
+- ✅ A product must have a name
+- ✅ A product can be given one or more categories
+- ✅ A product cannot have a negative price
+- ✅ A product cannot duplicate categories
+
+Customers:
+- Must have a unique email address
+- Must have an address
+
+Cart:
+- ✅ Must always have the correct price
+
+Orders:
+- ✅ An order must be associated with a customer
+- ✅ The order total must always be correct
+- ✅ The order tax must always be correct
+- ✅ Shipping must be included in the total price
+- ✅ Payment must be completed for the order to be placed (FUTURE: Consider splitting payments to its own module)
+
+## Event Storming
+
+![image](https://github.com/user-attachments/assets/63ceadd7-428e-4cac-9937-377e46ae384a)
+
+## Bounded Contexts
+
+### Warehouse Context
+
+![image](https://github.com/user-attachments/assets/f7d5a522-246b-4ecf-88cf-e5cb0738f0a0)
+
+### Catalog Context
+
+![image](https://github.com/user-attachments/assets/a08d2964-c3fa-417f-8b6a-598d2a2fe511)
+
+### Customer Context
+
+![image](https://github.com/user-attachments/assets/d104aff7-2d5d-4308-af97-fca0c298d0b7)
+
+### Orders Context
+
+![image](https://github.com/user-attachments/assets/3c731981-1f98-42ca-9f74-c955a31a5790)

Warehouse.slnf

@@ -0,0 +1,12 @@
+{
+  "solution": {
+    "path": "ModularMonolith.sln",
+    "projects": [
+      "src\\Common\\Common.SharedKernel\\Common.SharedKernel.csproj",
+      "src\\Modules\\Warehouse\\Modules.Warehouse.Tests\\Modules.Warehouse.Tests.csproj",
+      "src\\Modules\\Warehouse\\Modules.Warehouse\\Modules.Warehouse.csproj",
+      "src\\WebApi\\WebApi.csproj",
+      "tools\\Database\\Database.csproj"
+    ]
+  }
+}

src/AppHost/AppHost.csproj

@@ -0,0 +1,19 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <IsAspireHost>true</IsAspireHost>
+        <UserSecretsId>25ad7f3b-101b-4d4c-aa10-629ae07db0e5</UserSecretsId>
+    </PropertyGroup>
+
+    <ItemGroup>
+      <ProjectReference Include="..\..\tools\MigrationService\MigrationService.csproj" />
+      <ProjectReference Include="..\WebApi\WebApi.csproj" />
+    </ItemGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Aspire.Hosting.AppHost" Version="8.2.1"/>
+        <PackageReference Include="Aspire.Hosting.SqlServer" Version="8.2.1" />
+    </ItemGroup>
+
+</Project>

src/AppHost/Program.cs

@@ -0,0 +1,27 @@
+using Projects;
+
+var builder = DistributedApplication.CreateBuilder();
+
+var sqlServer = builder.AddSqlServer("sql-server");
+var warehouseDb = sqlServer.AddDatabase("warehouse");
+var catalogDb = sqlServer.AddDatabase("catalog");
+var customersDb = sqlServer.AddDatabase("customers");
+var ordersDb = sqlServer.AddDatabase("orders");
+
+builder.AddProject<MigrationService>("migrations")
+    .WithReference(warehouseDb)
+    .WithReference(catalogDb)
+    .WithReference(customersDb)
+    .WithReference(ordersDb);
+
+builder
+    .AddProject<WebApi>("api")
+    .WithExternalHttpEndpoints()
+    .WithReference(warehouseDb)
+    .WithReference(catalogDb)
+    .WithReference(customersDb)
+    .WithReference(ordersDb);
+
+builder
+    .Build()
+    .Run();

src/AppHost/Properties/launchSettings.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json.schemastore.org/launchsettings.json",
+  "profiles": {
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "https://localhost:17074;http://localhost:15235",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development",
+        "DOTNET_ENVIRONMENT": "Development",
+        "DOTNET_DASHBOARD_OTLP_ENDPOINT_URL": "https://localhost:21257",
+        "DOTNET_RESOURCE_SERVICE_ENDPOINT_URL": "https://localhost:22208"
+      }
+    },
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "http://localhost:15235",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development",
+        "DOTNET_ENVIRONMENT": "Development",
+        "DOTNET_DASHBOARD_OTLP_ENDPOINT_URL": "http://localhost:19245",
+        "DOTNET_RESOURCE_SERVICE_ENDPOINT_URL": "http://localhost:20247"
+      }
+    }
+  }
+}

src/AppHost/appsettings.Development.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}

src/AppHost/appsettings.json

@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning",
+      "Aspire.Hosting.Dcp": "Warning"
+    }
+  }
+}

src/Common/Common.ServiceDefaults/Common.ServiceDefaults.csproj

@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <TargetFramework>net8.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+        <IsAspireSharedProject>true</IsAspireSharedProject>
+    </PropertyGroup>
+
+    <ItemGroup>
+        <FrameworkReference Include="Microsoft.AspNetCore.App"/>
+
+        <PackageReference Include="Microsoft.Extensions.Http.Resilience" Version="9.0.0-preview.9.24507.7" />
+        <PackageReference Include="Microsoft.Extensions.ServiceDiscovery" Version="8.2.1"/>
+        <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.9.0"/>
+        <PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.9.0"/>
+        <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.9.0"/>
+        <PackageReference Include="OpenTelemetry.Instrumentation.Http" Version="1.9.0"/>
+        <PackageReference Include="OpenTelemetry.Instrumentation.Runtime" Version="1.9.0"/>
+    </ItemGroup>
+
+</Project>