refactor: implement CodeRabbit final round - schema standardization, …

…XML docs, code cleanup

Schema Standardization:
- Fix Providers module schema: 'providers' → 'meajudaai_providers' in test configuration
- Fix Users module schema: 'users' → 'meajudaai_users' in DbContext and migrations
- Regenerate Users migrations with correct schema (removed 8 old migrations, created single InitialCreate)
- Align all modules to meajudaai_{module_name} naming convention

XML Documentation:
- Add comprehensive XML docs to TestContainerTestBase helper methods (PostJsonAsync, PutJsonAsync, ReadJsonAsync, URI overloads)
- Add XML docs to Users.Infrastructure.Extensions.AddInfrastructure method
- Add XML docs to ConfigurableTestAuthenticationHandler.SchemeName constant
- Enhance ClearConfiguration docs to emphasize cleanup hook usage

Code Quality:
- Remove unreachable code in TestContainerTestBase exception handling
- Fix WireMock timeout comment accuracy (5s is within 30s timeout, not exceeding)
- Improve Portuguese grammar in technical_debt.md (add comma before 'incluindo')
- Use Portuguese term 'Desempenho' instead of 'Performance' for consistency

All tests passing:
- 1/1 ProviderRepositoryIntegrationTests
- 8/8 PermissionAuthorizationE2ETests

docs/technical_debt.md

@@ -269,7 +269,7 @@ O teste `GetProvidersByVerificationStatus_ShouldReturnOnlyPendingProviders` atua
 **Issue**: [Criar issue para rastreamento]
 
 **Descrição**:
-O módulo SearchProviders não possui testes E2E (end-to-end), apenas testes de integração e unitários. Testes E2E são necessários para validar o fluxo completo de busca de prestadores incluindo integração com APIs externas (IBGE), filtros, paginação, e respostas HTTP completas.
+O módulo SearchProviders não possui testes E2E (end-to-end), apenas testes de integração e unitários. Testes E2E são necessários para validar o fluxo completo de busca de prestadores, incluindo integração com APIs externas (IBGE), filtros, paginação, e respostas HTTP completas.
 
 **Contexto**:
 - Identificado durante code review automatizado (CodeRabbit)
@@ -300,7 +300,7 @@ O módulo SearchProviders não possui testes E2E (end-to-end), apenas testes de
    - [ ] Busca por status de verificação
    - [ ] Combinação de múltiplos filtros
 
-4. **Performance e Carga**:
+4. **Desempenho e Carga**:
    - [ ] Busca com grande volume de resultados (1000+ prestadores)
    - [ ] Validação de tempos de resposta (<500ms para buscas simples)
    - [ ] Cache de resultados de API externa

src/Modules/Providers/Tests/Integration/ProvidersIntegrationTestBase.cs

@@ -40,7 +40,7 @@ protected TestInfrastructureOptions GetTestOptions()
                 DatabaseName = $"providers_test_{_testClassId}",
                 Username = "test_user",
                 Password = "test_password",
-                Schema = "providers",
+                Schema = "meajudaai_providers",
                 UseInMemoryDatabase = false
             },
             Cache = new TestCacheOptions

src/Modules/Users/Infrastructure/Extensions.cs

@@ -17,6 +17,12 @@ namespace MeAjudaAi.Modules.Users.Infrastructure;
 
 public static class Extensions
 {
+    /// <summary>
+    /// Registers Users module infrastructure services including persistence, Keycloak integration, domain services, and event handlers.
+    /// </summary>
+    /// <param name="services">The service collection to configure.</param>
+    /// <param name="configuration">The application configuration containing database and Keycloak settings.</param>
+    /// <returns>The configured service collection for fluent chaining.</returns>
     public static IServiceCollection AddInfrastructure(this IServiceCollection services, IConfiguration configuration)
     {
         services.AddPersistence(configuration);

src/Modules/Users/Infrastructure/Migrations/20251127125806_InitialCreate.cs

@@ -0,0 +1,96 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace MeAjudaAi.Modules.Users.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class InitialCreate : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.EnsureSchema(
+                name: "meajudaai_users");
+
+            migrationBuilder.CreateTable(
+                name: "users",
+                schema: "meajudaai_users",
+                columns: table => new
+                {
+                    id = table.Column<Guid>(type: "uuid", nullable: false),
+                    username = table.Column<string>(type: "character varying(30)", maxLength: 30, nullable: false),
+                    email = table.Column<string>(type: "character varying(254)", maxLength: 254, nullable: false),
+                    first_name = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: false),
+                    last_name = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: false),
+                    keycloak_id = table.Column<string>(type: "character varying(50)", maxLength: 50, nullable: false),
+                    is_deleted = table.Column<bool>(type: "boolean", nullable: false, defaultValue: false),
+                    deleted_at = table.Column<DateTime>(type: "timestamp with time zone", nullable: true),
+                    last_username_change_at = table.Column<DateTime>(type: "timestamp with time zone", nullable: true),
+                    created_at = table.Column<DateTime>(type: "timestamp with time zone", nullable: false),
+                    updated_at = table.Column<DateTime>(type: "timestamp with time zone", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_users", x => x.id);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "ix_users_created_at",
+                schema: "meajudaai_users",
+                table: "users",
+                column: "created_at");
+
+            migrationBuilder.CreateIndex(
+                name: "ix_users_deleted_created",
+                schema: "meajudaai_users",
+                table: "users",
+                columns: new[] { "is_deleted", "created_at" },
+                filter: "is_deleted = false");
+
+            migrationBuilder.CreateIndex(
+                name: "ix_users_deleted_email",
+                schema: "meajudaai_users",
+                table: "users",
+                columns: new[] { "is_deleted", "email" },
+                filter: "is_deleted = false");
+
+            migrationBuilder.CreateIndex(
+                name: "ix_users_deleted_username",
+                schema: "meajudaai_users",
+                table: "users",
+                columns: new[] { "is_deleted", "username" },
+                filter: "is_deleted = false");
+
+            migrationBuilder.CreateIndex(
+                name: "ix_users_email",
+                schema: "meajudaai_users",
+                table: "users",
+                column: "email",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "ix_users_keycloak_id",
+                schema: "meajudaai_users",
+                table: "users",
+                column: "keycloak_id",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "ix_users_username",
+                schema: "meajudaai_users",
+                table: "users",
+                column: "username",
+                unique: true);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "users",
+                schema: "meajudaai_users");
+        }
+    }
+}

src/Modules/Users/Infrastructure/Persistence/Migrations/UsersDbContextModelSnapshot.cs → src/Modules/Users/Infrastructure/Migrations/UsersDbContextModelSnapshot.cs

@@ -17,7 +17,7 @@ protected override void BuildModel(ModelBuilder modelBuilder)
         {
 #pragma warning disable 612, 618
             modelBuilder
-                .HasDefaultSchema("users")
+                .HasDefaultSchema("meajudaai_users")
                 .HasAnnotation("ProductVersion", "10.0.0-rc.2.25502.107")
                 .HasAnnotation("Relational:MaxIdentifierLength", 63);
 
@@ -110,7 +110,7 @@ protected override void BuildModel(ModelBuilder modelBuilder)
                         .HasDatabaseName("ix_users_deleted_username")
                         .HasFilter("is_deleted = false");
 
-                    b.ToTable("users", "users");
+                    b.ToTable("users", "meajudaai_users");
                 });
 #pragma warning restore 612, 618
         }