docs(multitenancy-aspnetcore): clarify middleware ordering

Note that auto wiring is intended for host/header resolution and manual ordering is required for route/claim and exception handling.

Author: mheidari988

src/CleanArchitecture.Extensions.Multitenancy.AspNetCore/DependencyInjectionExtensions.cs

@@ -24,7 +24,10 @@ public static class DependencyInjectionExtensions
     /// <param name="services">Service collection.</param>
     /// <param name="configureCore">Optional callback to configure <see cref="MultitenancyOptions"/>.</param>
     /// <param name="configureAspNetCore">Optional callback to configure <see cref="AspNetCoreMultitenancyOptions"/>.</param>
-    /// <param name="autoUseMiddleware">Whether to add the multitenancy middleware automatically.</param>
+    /// <param name="autoUseMiddleware">
+    /// Whether to add the multitenancy middleware automatically. Use only for host/header resolution.
+    /// Route/claim resolution requires manual ordering after routing/authentication.
+    /// </param>
     public static IServiceCollection AddCleanArchitectureMultitenancyAspNetCore(
         this IServiceCollection services,
         Action<MultitenancyOptions>? configureCore = null,

src/CleanArchitecture.Extensions.Multitenancy.AspNetCore/README.md

@@ -28,7 +28,7 @@ using CleanArchitecture.Extensions.Multitenancy.AspNetCore;
 builder.Services.AddCleanArchitectureMultitenancyAspNetCore(autoUseMiddleware: true);
 ```
 
-Use `autoUseMiddleware` when header or host resolution is enough. For claim- or route-based resolution, disable it and place `app.UseCleanArchitectureMultitenancy()` after authentication or routing.
+Use `autoUseMiddleware` when header or host resolution is enough and you do not depend on route values. For claim- or route-based resolution, disable it and place `app.UseCleanArchitectureMultitenancy()` after authentication or routing. If you want tenant resolution exceptions to flow through your global exception handler, place it after `app.UseExceptionHandler(...)`.
 
 ### 2) Add the middleware (manual)