@polymorphism-tech/morph-spec 8.38.0 → 8.40.0

package/framework/templates/code/dotnet/database/vector-entity.cs

@@ -1,8 +1,3 @@
-// ============================================================
-// PGVECTOR ENTITY + CONFIGURATION TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
 using System.ComponentModel.DataAnnotations.Schema;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Metadata.Builders;
@@ -12,10 +7,6 @@ using Pgvector;
 
 namespace {{NAMESPACE}}.Domain.Entities;
 
-/// <summary>
-/// Entity with vector embedding for similarity search via pgvector.
-/// Dimensions: 1536 (text-embedding-3-small). Adjust if using a different model.
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}
 {
     public Guid Id { get; set; }
@@ -23,6 +14,7 @@ public class {{pascalCase FEATURE_NAME}}
     public string Content { get; set; } = string.Empty;
     public string? Metadata { get; set; }
 
+    // 1536 é a dimensão do text-embedding-3-small; troca junto com o modelo, aqui e na configuração
     [Column(TypeName = "vector(1536)")]
     public Vector? Embedding { get; set; }
 
@@ -30,12 +22,9 @@ public class {{pascalCase FEATURE_NAME}}
     public DateTimeOffset? UpdatedAt { get; set; }
 }
 
-// ============================================================
-// ENTITY TYPE CONFIGURATION
-// ============================================================
-
 namespace {{NAMESPACE}}.Infrastructure.Data.Configurations;
 
+// Exige UseVector() no AddNpgsql e HasPostgresExtension("vector") no OnModelCreating
 public class {{pascalCase FEATURE_NAME}}Configuration : IEntityTypeConfiguration<{{pascalCase FEATURE_NAME}}>
 {
     public void Configure(EntityTypeBuilder<{{pascalCase FEATURE_NAME}}> builder)
@@ -49,7 +38,6 @@ public class {{pascalCase FEATURE_NAME}}Configuration : IEntityTypeConfiguration
         builder.Property(e => e.Embedding).HasColumnType("vector(1536)");
         builder.Property(e => e.CreatedAt).HasDefaultValueSql("now()");
 
-        // HNSW index for cosine similarity search
         builder.HasIndex(e => e.Embedding)
             .HasMethod("hnsw")
             .HasOperators("vector_cosine_ops")
@@ -59,35 +47,3 @@ public class {{pascalCase FEATURE_NAME}}Configuration : IEntityTypeConfiguration
         builder.HasIndex(e => e.Title);
     }
 }
-
-// ============================================================
-// SETUP INSTRUCTIONS
-// ============================================================
-//
-// 1. Install NuGet packages:
-//
-//    dotnet add package Pgvector.EntityFrameworkCore
-//    dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL
-//
-// 2. Configure NpgsqlDataSource with vector support in Program.cs:
-//
-//    builder.Services.AddNpgsql<AppDbContext>(
-//        connectionString,
-//        npgsqlOptions => npgsqlOptions.UseVector());
-//
-// 3. Register in DbContext:
-//
-//    public DbSet<{{pascalCase FEATURE_NAME}}> {{pascalCase FEATURE_NAME}}s => Set<{{pascalCase FEATURE_NAME}}>();
-//
-//    protected override void OnModelCreating(ModelBuilder modelBuilder)
-//    {
-//        modelBuilder.HasPostgresExtension("vector");
-//        modelBuilder.ApplyConfiguration(new {{pascalCase FEATURE_NAME}}Configuration());
-//    }
-//
-// 4. Create and apply migration:
-//
-//    dotnet ef migrations add Add{{pascalCase FEATURE_NAME}}WithVector -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
-//    dotnet ef database update -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
-//
-// ============================================================

package/framework/templates/code/dotnet/extensions/result-extensions.cs

@@ -5,7 +5,6 @@ namespace {{pascalCase PROJECT_NAME}}.Extensions;
 
 public static class ResultExtensions
 {
-    // For non-generic Result
     public static TOut Match<TOut>(
         this Result result,
         Func<TOut> onSuccess,
@@ -16,7 +15,6 @@ public static class ResultExtensions
             : onFailure(result.Error);
     }
 
-    // 🔥 THIS is what your endpoint needs
     public static TOut Match<TIn, TOut>(
         this Result<TIn> result,
         Func<TIn, TOut> onSuccess,

package/framework/templates/code/dotnet/feature/validator.cs.hbs

@@ -1,15 +1,11 @@
-using FluentValidation;
-
-namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}Feature.{{pascalCase SLICE_NAME}};
-
-public class {{pascalCase SLICE_NAME}}Validator : AbstractValidator<{{pascalCase SLICE_NAME}}Request>
-{
-    public {{pascalCase SLICE_NAME}}Validator()
-    {
-        // TODO: Add validation rules for {{pascalCase SLICE_NAME}}Request properties
-        // Example:
-        // RuleFor(c => c.Name)
-        //     .NotEmpty().WithMessage("Name is required")
-        //     .MaximumLength(200).WithMessage("Name must not exceed 200 characters");
-    }
-}
+using FluentValidation;
+
+namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}Feature.{{pascalCase SLICE_NAME}};
+
+public class {{pascalCase SLICE_NAME}}Validator : AbstractValidator<{{pascalCase SLICE_NAME}}Request>
+{
+    public {{pascalCase SLICE_NAME}}Validator()
+    {
+        // TODO: Add validation rules for {{pascalCase SLICE_NAME}}Request properties
+    }
+}

package/framework/templates/code/dotnet/jobs/agent.cs

@@ -1,8 +1,3 @@
-// ============================================================
-// MICROSOFT AGENT FRAMEWORK TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
 using System.ComponentModel;
 using System.Text.Json;
 using Microsoft.Extensions.AI;
@@ -10,15 +5,10 @@ using Microsoft.Extensions.Logging;
 
 namespace {{NAMESPACE}}.Agents.{{pascalCase FEATURE_NAME}};
 
-/// <summary>
-/// AI Agent for analyzing {{pascalCase FEATURE_NAME}} data.
-/// Uses Microsoft Agent Framework with IChatClient (gpt-4o-mini by default).
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
     IChatClient chatClient,
     ILogger<{{pascalCase FEATURE_NAME}}AnalyzerAgent> logger) : I{{pascalCase FEATURE_NAME}}AnalyzerAgent
 {
-    /// <inheritdoc />
     public async Task<{{pascalCase FEATURE_NAME}}AnalysisResult> AnalyzeAsync(
         {{pascalCase FEATURE_NAME}}Data data,
         CancellationToken cancellationToken = default)
@@ -65,14 +55,12 @@ public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
         return result;
     }
 
-    #region Tools
-
     [Description("Gets additional context for the analysis")]
     private async Task<string> GetContextAsync(
         [Description("What context is needed")] string query,
         CancellationToken ct = default)
     {
-        // TODO: Implement context retrieval (e.g., from database or search)
+        // TODO: buscar o contexto (banco ou busca)
         await Task.CompletedTask;
         return $"Context for: {query}";
     }
@@ -82,19 +70,16 @@ public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
         [Description("Metric type to retrieve")] string metricType,
         CancellationToken ct = default)
     {
-        // TODO: Implement metrics retrieval
+        // TODO: buscar as métricas
         await Task.CompletedTask;
         return $"Metrics for: {metricType}";
     }
 
-    #endregion
-
-    #region Response Parsing
-
     private {{pascalCase FEATURE_NAME}}AnalysisResult ParseResponse(string response)
     {
         try
         {
+            // o modelo às vezes cerca o JSON com ```json mesmo instruído a não fazer
             var json = response
                 .Replace("```json", "")
                 .Replace("```", "")
@@ -126,37 +111,4 @@ public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
         public List<string>? Recommendations { get; set; }
         public double ConfidenceScore { get; set; }
     }
-
-    #endregion
 }
-
-// ============================================================
-// DEPENDENCY INJECTION SETUP
-// ============================================================
-//
-// In Program.cs:
-//
-// // Register IChatClient (Azure OpenAI with Managed Identity)
-// builder.Services.AddSingleton<IChatClient>(sp =>
-// {
-//     var cfg = sp.GetRequiredService<IConfiguration>();
-//     return new AzureOpenAIClient(
-//             new Uri(cfg["AzureOpenAI:Endpoint"]!),
-//             new DefaultAzureCredential())
-//         .GetChatClient(cfg["AzureOpenAI:DeploymentName"] ?? "gpt-4o-mini")
-//         .AsIChatClient();
-// });
-//
-// // Option A: Register as scoped service
-// builder.Services.AddScoped<I{{pascalCase FEATURE_NAME}}AnalyzerAgent, {{pascalCase FEATURE_NAME}}AnalyzerAgent>();
-//
-// // Option B: Register as keyed agent (recommended for multiple agents)
-// builder.AddAIAgent("{{pascalCase FEATURE_NAME}}Analyzer", (sp, key) =>
-// {
-//     var chatClient = sp.GetRequiredService<IChatClient>();
-//     return new ChatClientAgent(chatClient,
-//         name: key,
-//         instructions: "You are an expert {{pascalCase FEATURE_NAME}} analyst.");
-// });
-//
-// ============================================================

package/framework/templates/code/dotnet/jobs/job.cs

@@ -1,8 +1,3 @@
-// ============================================================
-// HANGFIRE JOB TEMPLATE (VSA Pattern — ApplicationDbContext direto)
-// Generated by MORPH Framework
-// ============================================================
-
 using Hangfire;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Logging;
@@ -10,21 +5,11 @@ using {{pascalCase PROJECT_NAME}}.Database;
 
 namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}.Jobs;
 
-/// <summary>
-/// Background job for processing {{pascalCase FEATURE_NAME}}.
-/// Uses Hangfire for scheduling and retry handling.
-/// Injects ApplicationDbContext directly (no service layer, no generic repository).
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}ProcessorJob(
     ApplicationDbContext db,
     I{{pascalCase FEATURE_NAME}}AnalyzerAgent analyzer,
     ILogger<{{pascalCase FEATURE_NAME}}ProcessorJob> logger) : I{{pascalCase FEATURE_NAME}}ProcessorJob
 {
-    /// <summary>
-    /// Executes the {{pascalCase FEATURE_NAME}} processing job.
-    /// </summary>
-    /// <param name="id">The {{pascalCase FEATURE_NAME}} ID to process</param>
-    /// <param name="cancellationToken">Cancellation token</param>
     [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]
     [Queue("default")]
     [JobDisplayName("{{pascalCase FEATURE_NAME}} Processing - ID: {0}")]
@@ -34,7 +19,6 @@ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
 
         try
         {
-            // Get the entity directly from the DbSet
             var entity = await db.Set<{{pascalCase FEATURE_NAME}}>().FindAsync(new object[] { id }, cancellationToken);
             if (entity is null)
             {
@@ -42,14 +26,12 @@ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
                 return;
             }
 
-            // Check if already processed
             if (entity.Status == {{pascalCase FEATURE_NAME}}Status.Completed)
             {
                 logger.LogInformation("{{pascalCase FEATURE_NAME}} {Id} already completed, skipping", id);
                 return;
             }
 
-            // Perform MAF agent analysis (if applicable)
             var analysisData = new {{pascalCase FEATURE_NAME}}Data(entity.Name);
             var analysis = await analyzer.AnalyzeAsync(analysisData, cancellationToken);
 
@@ -57,7 +39,6 @@ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
                 "{{pascalCase FEATURE_NAME}} {Id} analyzed. Confidence: {Confidence:P0}",
                 id, analysis.ConfidenceScore);
 
-            // Update the tracked entity and persist
             entity.MarkAsCompleted(analysis);
             await db.SaveChangesAsync(cancellationToken);
 
@@ -66,54 +47,17 @@ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
         catch (Exception ex)
         {
             logger.LogError(ex, "Failed to process {{pascalCase FEATURE_NAME}} {Id}", id);
-            throw; // Re-throw to trigger Hangfire retry
+            throw; // sem a exceção o Hangfire não aplica o AutomaticRetry
         }
     }
 }
 
-// ============================================================
-// RECURRING JOB CONFIGURATION
-// ============================================================
-//
-// For scheduled/recurring jobs, configure in Program.cs:
-//
-// // Run every hour
-// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
-//     "{{kebabCase FEATURE_NAME}}-processor",
-//     job => job.ExecuteAsync(0, CancellationToken.None),
-//     Cron.Hourly);
-//
-// // Run daily at midnight
-// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
-//     "{{kebabCase FEATURE_NAME}}-daily-processor",
-//     job => job.ExecuteAsync(0, CancellationToken.None),
-//     Cron.Daily);
-//
-// // Custom cron expression (every 15 minutes)
-// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
-//     "{{kebabCase FEATURE_NAME}}-frequent-processor",
-//     job => job.ExecuteAsync(0, CancellationToken.None),
-//     "*/15 * * * *");
-//
-// ============================================================
-
-// ============================================================
-// BATCH JOB TEMPLATE
-// ============================================================
-
-/// <summary>
-/// Batch job for processing multiple {{pascalCase FEATURE_NAME}}s.
-/// Queries pending items via LINQ on the DbSet and enqueues individual jobs.
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
     ApplicationDbContext db,
     ILogger<{{pascalCase FEATURE_NAME}}BatchProcessorJob> logger)
 {
-    /// <summary>
-    /// Processes all pending {{pascalCase FEATURE_NAME}}s.
-    /// </summary>
     [AutomaticRetry(Attempts = 1)]
-    [Queue("batch")]
+    [Queue("batch")] // a fila precisa constar em AddHangfireServer(o => o.Queues), senão ninguém a consome
     [JobDisplayName("{{pascalCase FEATURE_NAME}} Batch Processing")]
     public async Task ProcessAllPendingAsync(CancellationToken cancellationToken)
     {
@@ -127,7 +71,6 @@ public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
 
         foreach (var item in pending)
         {
-            // Enqueue individual processing jobs
             BackgroundJob.Enqueue<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
                 job => job.ExecuteAsync(item.Id, CancellationToken.None));
         }
@@ -135,41 +78,3 @@ public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
         logger.LogInformation("Enqueued {Count} processing jobs", pending.Count);
     }
 }
-
-// ============================================================
-// HANGFIRE CONFIGURATION
-// ============================================================
-//
-// In Program.cs:
-//
-// // Add Hangfire services
-// builder.Services.AddHangfire(config => config
-//     .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
-//     .UseSimpleAssemblyNameTypeSerializer()
-//     .UseRecommendedSerializerSettings()
-//     .UseSqlServerStorage(connectionString, new SqlServerStorageOptions
-//     {
-//         CommandBatchMaxTimeout = TimeSpan.FromMinutes(5),
-//         SlidingInvisibilityTimeout = TimeSpan.FromMinutes(5),
-//         QueuePollInterval = TimeSpan.Zero,
-//         UseRecommendedIsolationLevel = true,
-//         DisableGlobalLocks = true
-//     }));
-//
-// builder.Services.AddHangfireServer(options =>
-// {
-//     options.Queues = new[] { "default", "batch" };
-//     options.WorkerCount = Environment.ProcessorCount * 2;
-// });
-//
-// // Register jobs (ApplicationDbContext already registered via AddDbContext)
-// builder.Services.AddScoped<I{{pascalCase FEATURE_NAME}}ProcessorJob, {{pascalCase FEATURE_NAME}}ProcessorJob>();
-// builder.Services.AddScoped<{{pascalCase FEATURE_NAME}}BatchProcessorJob>();
-//
-// // In app pipeline
-// app.UseHangfireDashboard("/hangfire", new DashboardOptions
-// {
-//     Authorization = new[] { new HangfireAuthorizationFilter() }
-// });
-//
-// ============================================================

package/framework/templates/code/dotnet/test.cs

@@ -1,8 +1,3 @@
-// ============================================================
-// TEST TEMPLATE (VSA Pattern — Handler + Validator)
-// Generated by MORPH Framework
-// ============================================================
-
 using FluentAssertions;
 using FluentValidation;
 using FluentValidation.Results;
@@ -14,15 +9,6 @@ using Xunit;
 
 namespace {{pascalCase PROJECT_NAME}}.Tests.Unit.Features.{{pascalCase FEATURE_NAME}};
 
-// ============================================================
-// Handler Tests
-// ============================================================
-
-/// <summary>
-/// Unit tests for {{pascalCase FEATURE_NAME}} handlers.
-/// Tests handlers directly against a real ApplicationDbContext backed by
-/// in-memory SQLite (no mocks — DbSet is the repository, DbContext is the unit of work).
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
 {
     private readonly SqliteConnection _connection;
@@ -30,6 +16,7 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
 
     public {{pascalCase FEATURE_NAME}}HandlerTests()
     {
+        // o banco :memory: some quando a conexão fecha, então ela vive o teste inteiro
         _connection = new SqliteConnection("DataSource=:memory:");
         _connection.Open();
 
@@ -47,19 +34,14 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         _connection.Dispose();
     }
 
-    #region Create Handler Tests
-
     [Fact]
     public async Task Create_HandleAsync_WithValidCommand_ReturnsSuccessResult()
     {
-        // Arrange
         var command = new Create{{pascalCase FEATURE_NAME}}Request("Test {{pascalCase FEATURE_NAME}}");
         var handler = new Create{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeTrue();
         result.Value.Should().NotBeNull();
 
@@ -67,14 +49,9 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         persisted.Name.Should().Be("Test {{pascalCase FEATURE_NAME}}");
     }
 
-    #endregion
-
-    #region GetById Handler Tests
-
     [Fact]
     public async Task GetById_HandleAsync_WithValidId_ReturnsSuccessResult()
     {
-        // Arrange
         var entity = CreateTestEntity("Test {{pascalCase FEATURE_NAME}}");
         _db.Set<{{pascalCase FEATURE_NAME}}>().Add(entity);
         await _db.SaveChangesAsync();
@@ -82,10 +59,8 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         var query = new Get{{pascalCase FEATURE_NAME}}ByIdRequest(entity.Id);
         var handler = new Get{{pascalCase FEATURE_NAME}}ByIdHandler(_db);
 
-        // Act
         var result = await handler.HandleAsync(query, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeTrue();
         result.Value.Should().NotBeNull();
         result.Value!.Name.Should().Be("Test {{pascalCase FEATURE_NAME}}");
@@ -94,25 +69,17 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
     [Fact]
     public async Task GetById_HandleAsync_WithInvalidId_ReturnsFailureResult()
     {
-        // Arrange
         var query = new Get{{pascalCase FEATURE_NAME}}ByIdRequest(Guid.CreateVersion7());
         var handler = new Get{{pascalCase FEATURE_NAME}}ByIdHandler(_db);
 
-        // Act
         var result = await handler.HandleAsync(query, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeFalse();
     }
 
-    #endregion
-
-    #region Update Handler Tests
-
     [Fact]
     public async Task Update_HandleAsync_WithValidCommand_ReturnsSuccessResult()
     {
-        // Arrange
         var entity = CreateTestEntity("Original Name");
         _db.Set<{{pascalCase FEATURE_NAME}}>().Add(entity);
         await _db.SaveChangesAsync();
@@ -120,10 +87,8 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         var command = new Update{{pascalCase FEATURE_NAME}}Request(entity.Id, "Updated Name");
         var handler = new Update{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeTrue();
 
         var persisted = await _db.Set<{{pascalCase FEATURE_NAME}}>().SingleAsync(x => x.Id == entity.Id);
@@ -133,25 +98,17 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
     [Fact]
     public async Task Update_HandleAsync_WithNonExistentId_ReturnsFailureResult()
     {
-        // Arrange
         var command = new Update{{pascalCase FEATURE_NAME}}Request(Guid.CreateVersion7(), "Updated");
         var handler = new Update{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeFalse();
     }
 
-    #endregion
-
-    #region Delete Handler Tests
-
     [Fact]
     public async Task Delete_HandleAsync_WithValidId_ReturnsSuccessResult()
     {
-        // Arrange
         var entity = CreateTestEntity("To Delete");
         _db.Set<{{pascalCase FEATURE_NAME}}>().Add(entity);
         await _db.SaveChangesAsync();
@@ -159,10 +116,8 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         var command = new Delete{{pascalCase FEATURE_NAME}}Request(entity.Id);
         var handler = new Delete{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeTrue();
 
         (await _db.Set<{{pascalCase FEATURE_NAME}}>().AnyAsync(x => x.Id == entity.Id)).Should().BeFalse();
@@ -171,57 +126,35 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
     [Fact]
     public async Task Delete_HandleAsync_WithNonExistentId_ReturnsFailureResult()
     {
-        // Arrange
         var command = new Delete{{pascalCase FEATURE_NAME}}Request(Guid.CreateVersion7());
         var handler = new Delete{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeFalse();
     }
 
-    #endregion
-
-    #region Helper Methods
-
     private static {{pascalCase FEATURE_NAME}} CreateTestEntity(string name)
     {
         return new {{pascalCase FEATURE_NAME}}
         {
             Id = Guid.CreateVersion7(),
             Name = name,
-            // TODO: preencher demais campos obrigatórios da entidade
+            // TODO: demais campos obrigatórios da entidade
         };
     }
-
-    #endregion
 }
 
-// ============================================================
-// Validator Tests
-// ============================================================
-
-/// <summary>
-/// Unit tests for {{pascalCase FEATURE_NAME}} validators.
-/// Tests FluentValidation rules using ValidateAsync.
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}ValidatorTests
 {
-    #region Create Validator Tests
-
     [Fact]
     public async Task CreateValidator_WithValidCommand_PassesValidation()
     {
-        // Arrange
         var validator = new Create{{pascalCase FEATURE_NAME}}Validator();
         var command = new Create{{pascalCase FEATURE_NAME}}Request("Valid Name");
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeTrue();
         result.Errors.Should().BeEmpty();
     }
@@ -232,14 +165,11 @@ public class {{pascalCase FEATURE_NAME}}ValidatorTests
     [InlineData(null)]
     public async Task CreateValidator_WithInvalidName_FailsValidation(string? name)
     {
-        // Arrange
         var validator = new Create{{pascalCase FEATURE_NAME}}Validator();
         var command = new Create{{pascalCase FEATURE_NAME}}Request(name!);
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeFalse();
         result.Errors.Should().Contain(e => e.PropertyName == nameof(Create{{pascalCase FEATURE_NAME}}Request.Name));
     }
@@ -247,50 +177,35 @@ public class {{pascalCase FEATURE_NAME}}ValidatorTests
     [Fact]
     public async Task CreateValidator_WithNameExceedingMaxLength_FailsValidation()
     {
-        // Arrange
         var validator = new Create{{pascalCase FEATURE_NAME}}Validator();
         var command = new Create{{pascalCase FEATURE_NAME}}Request(new string('A', 201));
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeFalse();
         result.Errors.Should().Contain(e => e.PropertyName == nameof(Create{{pascalCase FEATURE_NAME}}Request.Name));
     }
 
-    #endregion
-
-    #region Update Validator Tests
-
     [Fact]
     public async Task UpdateValidator_WithValidCommand_PassesValidation()
     {
-        // Arrange
         var validator = new Update{{pascalCase FEATURE_NAME}}Validator();
         var command = new Update{{pascalCase FEATURE_NAME}}Request(Guid.CreateVersion7(), "Updated Name");
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeTrue();
     }
 
     [Fact]
     public async Task UpdateValidator_WithInvalidId_FailsValidation()
     {
-        // Arrange
         var validator = new Update{{pascalCase FEATURE_NAME}}Validator();
         var command = new Update{{pascalCase FEATURE_NAME}}Request(Guid.Empty, "Updated Name");
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeFalse();
         result.Errors.Should().Contain(e => e.PropertyName == nameof(Update{{pascalCase FEATURE_NAME}}Request.Id));
     }
-
-    #endregion
 }