Update documentation to reflect .NET 10 upgrade and Aspire rebranding

tjementum · tjementum · commit b53873fd1e5c · 2025-11-24T00:25:23.000+01:00
diff --git a/.cursor/rules/main.mdc b/.cursor/rules/main.mdc
@@ -42,18 +42,18 @@ This is a mono repository with multiple self-contained systems (SCS), each being
 - [application](mdc:application): Contains application code:
   - [account-management](mdc:application/account-management): An SCS for tenant and user management:
     - [WebApp](mdc:application/account-management/WebApp): A React, TypeScript SPA.
-    - [Api](mdc:application/account-management/Api): .NET 9 minimal API.
-    - [Core](mdc:application/account-management/Core): .NET 9 Vertical Sliced Architecture.
+    - [Api](mdc:application/account-management/Api): .NET 10 minimal API.
+    - [Core](mdc:application/account-management/Core): .NET 10 Vertical Sliced Architecture.
     - [Workers](mdc:application/account-management/Workers): A .NET Console job.
     - [Tests](mdc:application/account-management/Tests): xUnit tests for backend.
   - [back-office](mdc:application/back-office): An empty SCS that will be used to create tools for Support and System Admins:
     - [WebApp](mdc:application/back-office/WebApp): A React, TypeScript SPA.
-    - [Api](mdc:application/back-office/Api): .NET 9 minimal API.
-    - [Core](mdc:application/back-office/Core): .NET 9 Vertical Sliced Architecture.
+    - [Api](mdc:application/back-office/Api): .NET 10 minimal API.
+    - [Core](mdc:application/back-office/Core): .NET 10 Vertical Sliced Architecture.
     - [Workers](mdc:application/back-office/Workers): A .NET Console job.
     - [Tests](mdc:application/back-office/Tests): xUnit tests for backend.
-  - [AppHost](mdc:application/AppHost): .NET Aspire project for orchestrating SCSs and Docker containers. Never run directly—typically running in watch mode.
-  - [AppGateway](mdc:application/AppGateway): Main entry point using .NET YARP as reverse proxy for all SCSs.
+  - [AppHost](mdc:application/AppHost): Aspire project for orchestrating SCSs and Docker containers. Never run directly—typically running in watch mode.
+  - [AppGateway](mdc:application/AppGateway): Main entry point using YARP as reverse proxy for all SCSs.
   - [shared-kernel](mdc:application/shared-kernel): Reusable .NET backend shared by all SCSs.
   - [shared-webapp](mdc:application/shared-webapp): Reusable frontend shared by all SCSs.
 - [cloud-infrastructure](mdc:cloud-infrastructure): Bash and Azure Bicep scripts (IaC).
diff --git a/.windsurf/rules/backend/commands.md b/.windsurf/rules/backend/commands.md
@@ -63,9 +63,7 @@ public sealed class CreateUserValidator : AbstractValidator<CreateUserCommand>
     public CreateUserValidator()
     {
         // ✅ DO: Use the same message for better user experience and easier localization
-        RuleFor(x => x.Name)
-            .NotEmpty().WithMessage("Name must be between 1 and 50 characters.")
-            .MaximumLength(50).WithMessage("Name must be between 1 and 50 characters.");
+        RuleFor(x => x.Name).Length(1, 50).WithMessage("Name must be between 1 and 50 characters.");
     }
 }
 
@@ -99,7 +97,7 @@ public sealed class CreateUserValidator : AbstractValidator<CreateUserCommand>
 {
     public CreateUserValidator()
     {
-        // ❌ DON'T: Use different validation messages for the same property
+        // ❌ DON'T: Use different validation messages for the same property and redundant validation rules
         RuleFor(x => x.Name)
             .NotEmpty().WithMessage("Name must not be empty.")
             .MaximumLength(50).WithMessage("Name must not be more than 50 characters.");
diff --git a/.windsurf/rules/main.md b/.windsurf/rules/main.md
@@ -42,18 +42,18 @@ This is a mono repository with multiple self-contained systems (SCS), each being
 - [application](/application): Contains application code:
   - [account-management](/application/account-management): An SCS for tenant and user management:
     - [WebApp](/application/account-management/WebApp): A React, TypeScript SPA.
-    - [Api](/application/account-management/Api): .NET 9 minimal API.
-    - [Core](/application/account-management/Core): .NET 9 Vertical Sliced Architecture.
+    - [Api](/application/account-management/Api): .NET 10 minimal API.
+    - [Core](/application/account-management/Core): .NET 10 Vertical Sliced Architecture.
     - [Workers](/application/account-management/Workers): A .NET Console job.
     - [Tests](/application/account-management/Tests): xUnit tests for backend.
   - [back-office](/application/back-office): An empty SCS that will be used to create tools for Support and System Admins:
     - [WebApp](/application/back-office/WebApp): A React, TypeScript SPA.
-    - [Api](/application/back-office/Api): .NET 9 minimal API.
-    - [Core](/application/back-office/Core): .NET 9 Vertical Sliced Architecture.
+    - [Api](/application/back-office/Api): .NET 10 minimal API.
+    - [Core](/application/back-office/Core): .NET 10 Vertical Sliced Architecture.
     - [Workers](/application/back-office/Workers): A .NET Console job.
     - [Tests](/application/back-office/Tests): xUnit tests for backend.
-  - [AppHost](/application/AppHost): .NET Aspire project for orchestrating SCSs and Docker containers. Never run directly—typically running in watch mode.
-  - [AppGateway](/application/AppGateway): Main entry point using .NET YARP as reverse proxy for all SCSs.
+  - [AppHost](/application/AppHost): Aspire project for orchestrating SCSs and Docker containers. Never run directly—typically running in watch mode.
+  - [AppGateway](/application/AppGateway): Main entry point using YARP as reverse proxy for all SCSs.
   - [shared-kernel](/application/shared-kernel): Reusable .NET backend shared by all SCSs.
   - [shared-webapp](/application/shared-webapp): Reusable frontend shared by all SCSs.
 - [cloud-infrastructure](/cloud-infrastructure): Bash and Azure Bicep scripts (IaC).
diff --git a/README.md b/README.md
@@ -27,7 +27,7 @@ Built to demonstrate seamless flow—backend contracts feed a fully-typed React
 
 ## What's inside
 
-* **Backend** - .NET 9 and C# adhering to the principles of vertical slice architecture, DDD, CQRS, and clean code
+* **Backend** - .NET 10 and C# 14 adhering to the principles of vertical slice architecture, DDD, CQRS, and clean code
 * **Frontend** – React 19, TypeScript, TanStack Router & Query, React Aria for accessible and UI
 * **CI/CD** - GitHub actions for fast passwordless deployments of docker containers and infrastructure (Bicep)
 * **Infrastructure** - Cost efficient and scalable Azure PaaS services like Azure Container Apps, Azure SQL, etc.
@@ -59,7 +59,7 @@ For development, you need .NET, Docker, and Node. And GitHub and Azure CLI for s
 2.	From an Administrator PowerShell terminal, use [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/) (preinstalled on Windows 11) to install any missing packages:
 
     ```powershell
-    winget install Microsoft.DotNet.SDK.9
+    winget install Microsoft.DotNet.SDK.10
     winget install Git.Git
     winget install Docker.DockerDesktop
     winget install OpenJS.NodeJS
@@ -125,10 +125,10 @@ Open a terminal and run the following commands (if not installed):
   sudo apt-get update
   ```
 
-- Install .NET SDK 9.0, Node, GitHub CLI
+- Install .NET SDK 10.0, Node, GitHub CLI
 
   ```bash
-  sudo apt-get install -y dotnet-sdk-9.0 nodejs gh
+  sudo apt-get install -y dotnet-sdk-10.0 nodejs gh
   ```
 
 - Install Azure CLI
@@ -233,11 +233,11 @@ PlatformPlatform is a [monorepo](https://en.wikipedia.org/wiki/Monorepo) contain
 
 # Technologies
 
-### .NET 9 Backend With Vertical Sliced Architecture, DDD, CQRS, Minimal API, and Aspire
+### .NET 10 Backend With Vertical Sliced Architecture, DDD, CQRS, Minimal API, and Aspire
 
 The backend is built using the most popular, mature, and commonly used technologies in the .NET ecosystem:
 
-- [.NET 9](https://dotnet.microsoft.com) and [C# 13](https://learn.microsoft.com/en-us/dotnet/csharp/tour-of-csharp)
+- [.NET 10](https://dotnet.microsoft.com) and [C# 14](https://learn.microsoft.com/en-us/dotnet/csharp/tour-of-csharp)
 - [Aspire](https://aka.ms/dotnet-aspire)
 - [YARP](https://microsoft.github.io/reverse-proxy)
 - [ASP.NET Minimal API](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/minimal-apis)

Original file line number	Diff line number	Diff line change
`@@ -63,9 +63,7 @@ public sealed class CreateUserValidator : AbstractValidator<CreateUserCommand>`
`63`	`63`	`public CreateUserValidator()`
`64`	`64`	`{`
`65`	`65`	`// ✅ DO: Use the same message for better user experience and easier localization`
`66`		`- RuleFor(x => x.Name)`
`67`		`- .NotEmpty().WithMessage("Name must be between 1 and 50 characters.")`
`68`		`- .MaximumLength(50).WithMessage("Name must be between 1 and 50 characters.");`
	`66`	`+ RuleFor(x => x.Name).Length(1, 50).WithMessage("Name must be between 1 and 50 characters.");`
`69`	`67`	`}`
`70`	`68`	`}`
`71`	`69`
`@@ -99,7 +97,7 @@ public sealed class CreateUserValidator : AbstractValidator<CreateUserCommand>`
`99`	`97`	`{`
`100`	`98`	`public CreateUserValidator()`
`101`	`99`	`{`
`102`		`- // ❌ DON'T: Use different validation messages for the same property`
	`100`	`+ // ❌ DON'T: Use different validation messages for the same property and redundant validation rules`
`103`	`101`	`RuleFor(x => x.Name)`
`104`	`102`	`.NotEmpty().WithMessage("Name must not be empty.")`
`105`	`103`	`.MaximumLength(50).WithMessage("Name must not be more than 50 characters.");`