Fix running clean architecture template on Linux

- Skip LocalDB connection on non-Windows platforms in InfrastructureServiceExtensions
- Use EnsureCreated for SQLite, Migrate for SQL Server in MiddlewareConfig
- Update appsettings.json comments to clarify cross-platform behavior
- Update functional tests to force SQL Server mode on Linux via environment variable

Co-authored-by: ardalis <[email protected]>

Author: Copilot

src/Clean.Architecture.Infrastructure/InfrastructureServiceExtensions.cs

@@ -14,10 +14,13 @@ public static IServiceCollection AddInfrastructureServices(
   {
     // Try to get connection strings in order of priority:
     // 1. "cleanarchitecture" - provided by Aspire when using .WithReference(cleanArchDb)
-    // 2. "DefaultConnection" - traditional SQL Server connection
+    // 2. "DefaultConnection" - SQL Server (Windows only by default, can be forced with USE_SQL_SERVER=true)
     // 3. "SqliteConnection" - fallback to SQLite
+    bool isWindows = OperatingSystem.IsWindows();
+    bool forceSqlServer = Environment.GetEnvironmentVariable("USE_SQL_SERVER") == "true";
+    
     string? connectionString = config.GetConnectionString("cleanarchitecture")
-                               ?? config.GetConnectionString("DefaultConnection") 
+                               ?? ((isWindows || forceSqlServer) ? config.GetConnectionString("DefaultConnection") : null)
                                ?? config.GetConnectionString("SqliteConnection");
     Guard.Against.Null(connectionString);
 
@@ -28,9 +31,9 @@ public static IServiceCollection AddInfrastructureServices(
     {
       var eventDispatchInterceptor = provider.GetRequiredService<EventDispatchInterceptor>();
 
-      // Use SQL Server if Aspire or DefaultConnection is available, otherwise use SQLite
+      // Use SQL Server if Aspire or DefaultConnection (on Windows or forced) is available, otherwise use SQLite
       if (config.GetConnectionString("cleanarchitecture") != null || 
-          config.GetConnectionString("DefaultConnection") != null)
+          ((isWindows || forceSqlServer) && config.GetConnectionString("DefaultConnection") != null))
       {
         options.UseSqlServer(connectionString);
       }

src/Clean.Architecture.Web/Configurations/MiddlewareConfig.cs

@@ -55,8 +55,19 @@ static async Task MigrateDatabaseAsync(WebApplication app)
     {
       logger.LogInformation("Applying database migrations...");
       var context = services.GetRequiredService<AppDbContext>();
-      await context.Database.MigrateAsync();
-      logger.LogInformation("Database migrations applied successfully");
+      
+      // For SQLite, use EnsureCreated instead of migrations (common for dev/local scenarios)
+      // For SQL Server, use migrations (production scenario)
+      if (context.Database.IsSqlite())
+      {
+        await context.Database.EnsureCreatedAsync();
+        logger.LogInformation("SQLite database created successfully");
+      }
+      else
+      {
+        await context.Database.MigrateAsync();
+        logger.LogInformation("Database migrations applied successfully");
+      }
     }
     catch (Exception ex)
     {

src/Clean.Architecture.Web/appsettings.json

@@ -1,10 +1,11 @@
 {
   "ConnectionStrings": {
     // When running through Aspire, the connection string is provided automatically by the AspireHost
-    // This DefaultConnection is used only when running the Web project directly (without Aspire)
+    // This DefaultConnection is used only when running the Web project directly on Windows (without Aspire)
     // You can configure this to point to your local SQL Server instance
+    // Note: On Linux/macOS, this connection is skipped and SQLite is used instead
     "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=cleanarchitecture;Trusted_Connection=True;MultipleActiveResultSets=true",
-    // SQLite is used as a fallback when running standalone without Aspire and no DefaultConnection is configured
+    // SQLite is used as a fallback when running on Linux/macOS or when running standalone on Windows without Aspire
     "SqliteConnection": "Data Source=database.sqlite"
   },
   "Database": {

tests/Clean.Architecture.FunctionalTests/CustomWebApplicationFactory.cs

@@ -1,5 +1,6 @@
 using Clean.Architecture.Infrastructure.Data;
 using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
 using Testcontainers.MsSql;
 
 namespace Clean.Architecture.FunctionalTests;
@@ -18,6 +19,8 @@ public async Task InitializeAsync()
 
   public new async Task DisposeAsync()
   {
+    // Clean up environment variable
+    Environment.SetEnvironmentVariable("USE_SQL_SERVER", null);
     await _dbContainer.DisposeAsync();
   }
 
@@ -66,7 +69,18 @@ protected override IHost CreateHost(IHostBuilder builder)
 
   protected override void ConfigureWebHost(IWebHostBuilder builder)
   {
+    // Force SQL Server mode even on non-Windows platforms for functional tests
+    Environment.SetEnvironmentVariable("USE_SQL_SERVER", "true");
+    
     builder
+        .ConfigureAppConfiguration((context, config) =>
+        {
+          // Set the connection string to use the Testcontainer
+          config.AddInMemoryCollection(new Dictionary<string, string?>
+          {
+            ["ConnectionStrings:DefaultConnection"] = _dbContainer.GetConnectionString()
+          });
+        })
         .ConfigureServices(services =>
         {
           // Remove the app's ApplicationDbContext registration
@@ -84,6 +98,8 @@ protected override void ConfigureWebHost(IWebHostBuilder builder)
           services.AddDbContext<AppDbContext>((provider, options) =>
           {
             options.UseSqlServer(_dbContainer.GetConnectionString());
+            var interceptor = provider.GetRequiredService<EventDispatchInterceptor>();
+            options.AddInterceptors(interceptor);
           });
         });
   }