@polymorphism-tech/morph-spec 2.2.0 → 2.4.0

package/content/.morph/templates/service.cs

@@ -1,139 +1,139 @@
-// ============================================================
-// SERVICE TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
-using Microsoft.Extensions.Logging;
-
-namespace MyProject.Application.Features.{Feature}.Services;
-
-/// <summary>
-/// Service for managing {Feature} operations.
-/// </summary>
-public class {Feature}Service(
-    I{Feature}Repository repository,
-    ILogger<{Feature}Service> logger) : I{Feature}Service
-{
-    /// <inheritdoc />
-    public async Task<{Feature}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)
-    {
-        logger.LogDebug("Getting {Feature} with ID {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken);
-        if (entity is null)
-        {
-            logger.LogWarning("{Feature} with ID {Id} not found", id);
-            return null;
-        }
-
-        return MapToDto(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task<List<{Feature}Dto>> GetAllAsync(CancellationToken cancellationToken = default)
-    {
-        logger.LogDebug("Getting all {Feature}s");
-
-        var entities = await repository.GetAllAsync(cancellationToken);
-        return entities.Select(MapToDto).ToList();
-    }
-
-    /// <inheritdoc />
-    public async Task<{Feature}Dto> CreateAsync(
-        Create{Feature}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Creating new {Feature}: {Name}", request.Name);
-
-        // Validate
-        await ValidateCreateAsync(request, cancellationToken);
-
-        // Create entity
-        var entity = Domain.Entities.{Feature}.Create(request.Name);
-
-        // Save
-        await repository.AddAsync(entity, cancellationToken);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Created {Feature} with ID {Id}", entity.Id);
-
-        return MapToDto(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task UpdateAsync(
-        int id,
-        Update{Feature}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Updating {Feature} {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken)
-            ?? throw new {Feature}NotFoundException(id);
-
-        // Validate
-        await ValidateUpdateAsync(entity, request, cancellationToken);
-
-        // Update entity
-        entity.UpdateName(request.Name);
-
-        // Save
-        repository.Update(entity);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Updated {Feature} {Id}", id);
-    }
-
-    /// <inheritdoc />
-    public async Task DeleteAsync(int id, CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Deleting {Feature} {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken)
-            ?? throw new {Feature}NotFoundException(id);
-
-        // Soft delete or remove
-        repository.Remove(entity);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Deleted {Feature} {Id}", id);
-    }
-
-    #region Private Methods
-
-    private static {Feature}Dto MapToDto(Domain.Entities.{Feature} entity)
-    {
-        return new {Feature}Dto(
-            entity.Id,
-            entity.Name,
-            entity.Status,
-            entity.CreatedAt,
-            entity.UpdatedAt
-        );
-    }
-
-    private async Task ValidateCreateAsync(
-        Create{Feature}Request request,
-        CancellationToken cancellationToken)
-    {
-        // Add validation logic here
-        // Example: Check for duplicates
-        // var existing = await repository.FindByNameAsync(request.Name, cancellationToken);
-        // if (existing is not null)
-        //     throw new ValidationException("Name already exists");
-
-        await Task.CompletedTask;
-    }
-
-    private async Task ValidateUpdateAsync(
-        Domain.Entities.{Feature} entity,
-        Update{Feature}Request request,
-        CancellationToken cancellationToken)
-    {
-        // Add validation logic here
-
-        await Task.CompletedTask;
-    }
-
-    #endregion
-}
+// ============================================================
+// SERVICE TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using Microsoft.Extensions.Logging;
+
+namespace MyProject.Application.Features.{Feature}.Services;
+
+/// <summary>
+/// Service for managing {Feature} operations.
+/// </summary>
+public class {Feature}Service(
+    I{Feature}Repository repository,
+    ILogger<{Feature}Service> logger) : I{Feature}Service
+{
+    /// <inheritdoc />
+    public async Task<{Feature}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)
+    {
+        logger.LogDebug("Getting {Feature} with ID {Id}", id);
+
+        var entity = await repository.GetByIdAsync(id, cancellationToken);
+        if (entity is null)
+        {
+            logger.LogWarning("{Feature} with ID {Id} not found", id);
+            return null;
+        }
+
+        return MapToDto(entity);
+    }
+
+    /// <inheritdoc />
+    public async Task<List<{Feature}Dto>> GetAllAsync(CancellationToken cancellationToken = default)
+    {
+        logger.LogDebug("Getting all {Feature}s");
+
+        var entities = await repository.GetAllAsync(cancellationToken);
+        return entities.Select(MapToDto).ToList();
+    }
+
+    /// <inheritdoc />
+    public async Task<{Feature}Dto> CreateAsync(
+        Create{Feature}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        logger.LogInformation("Creating new {Feature}: {Name}", request.Name);
+
+        // Validate
+        await ValidateCreateAsync(request, cancellationToken);
+
+        // Create entity
+        var entity = Domain.Entities.{Feature}.Create(request.Name);
+
+        // Save
+        await repository.AddAsync(entity, cancellationToken);
+        await repository.SaveChangesAsync(cancellationToken);
+
+        logger.LogInformation("Created {Feature} with ID {Id}", entity.Id);
+
+        return MapToDto(entity);
+    }
+
+    /// <inheritdoc />
+    public async Task UpdateAsync(
+        int id,
+        Update{Feature}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        logger.LogInformation("Updating {Feature} {Id}", id);
+
+        var entity = await repository.GetByIdAsync(id, cancellationToken)
+            ?? throw new {Feature}NotFoundException(id);
+
+        // Validate
+        await ValidateUpdateAsync(entity, request, cancellationToken);
+
+        // Update entity
+        entity.UpdateName(request.Name);
+
+        // Save
+        repository.Update(entity);
+        await repository.SaveChangesAsync(cancellationToken);
+
+        logger.LogInformation("Updated {Feature} {Id}", id);
+    }
+
+    /// <inheritdoc />
+    public async Task DeleteAsync(int id, CancellationToken cancellationToken = default)
+    {
+        logger.LogInformation("Deleting {Feature} {Id}", id);
+
+        var entity = await repository.GetByIdAsync(id, cancellationToken)
+            ?? throw new {Feature}NotFoundException(id);
+
+        // Soft delete or remove
+        repository.Remove(entity);
+        await repository.SaveChangesAsync(cancellationToken);
+
+        logger.LogInformation("Deleted {Feature} {Id}", id);
+    }
+
+    #region Private Methods
+
+    private static {Feature}Dto MapToDto(Domain.Entities.{Feature} entity)
+    {
+        return new {Feature}Dto(
+            entity.Id,
+            entity.Name,
+            entity.Status,
+            entity.CreatedAt,
+            entity.UpdatedAt
+        );
+    }
+
+    private async Task ValidateCreateAsync(
+        Create{Feature}Request request,
+        CancellationToken cancellationToken)
+    {
+        // Add validation logic here
+        // Example: Check for duplicates
+        // var existing = await repository.FindByNameAsync(request.Name, cancellationToken);
+        // if (existing is not null)
+        //     throw new ValidationException("Name already exists");
+
+        await Task.CompletedTask;
+    }
+
+    private async Task ValidateUpdateAsync(
+        Domain.Entities.{Feature} entity,
+        Update{Feature}Request request,
+        CancellationToken cancellationToken)
+    {
+        // Add validation logic here
+
+        await Task.CompletedTask;
+    }
+
+    #endregion
+}

package/content/.morph/templates/simulation.md

@@ -0,0 +1,353 @@
+# Template: Simulacao de Servicos Externos
+
+> Template para configurar modo de simulacao em projetos .NET
+
+## Configuracao
+
+### appsettings.Development.json
+
+```json
+{
+  "Simulation": {
+    "Enabled": true,
+    "ImageDelayMs": 500,
+    "EmailDelayMs": 100,
+    "PaymentDelayMs": 200,
+    "PlaceholderImageUrl": "https://picsum.photos/1024/1024"
+  }
+}
+```
+
+### SimulationOptions.cs
+
+```csharp
+namespace {Namespace}.Infrastructure.Options;
+
+public class SimulationOptions
+{
+    public bool Enabled { get; set; }
+    public int ImageDelayMs { get; set; } = 500;
+    public int EmailDelayMs { get; set; } = 100;
+    public int PaymentDelayMs { get; set; } = 200;
+    public string PlaceholderImageUrl { get; set; } = "https://picsum.photos/1024/1024";
+}
+```
+
+---
+
+## DI Condicional
+
+### Program.cs
+
+```csharp
+// Configurar options
+builder.Services.Configure<SimulationOptions>(
+    builder.Configuration.GetSection("Simulation"));
+
+// Registrar clientes baseado em modo
+var simulationEnabled = builder.Configuration.GetValue<bool>("Simulation:Enabled");
+
+if (simulationEnabled)
+{
+    builder.Services.AddSimulationClients();
+    builder.Services.AddSingleton<IStartupFilter, SimulationWarningStartupFilter>();
+}
+else
+{
+    builder.Services.AddProductionClients(builder.Configuration);
+}
+```
+
+### ServiceCollectionExtensions.cs
+
+```csharp
+namespace {Namespace}.Infrastructure.Extensions;
+
+public static class ServiceCollectionExtensions
+{
+    public static IServiceCollection AddSimulationClients(this IServiceCollection services)
+    {
+        // ========================================
+        // STATEFUL (mantem dados) → SINGLETON
+        // ========================================
+        services.AddSingleton<IReplicateClient, FakeReplicateClient>();
+        services.AddSingleton<IPaymentClient, FakePaymentClient>();
+
+        // ========================================
+        // STATELESS → SCOPED
+        // ========================================
+        services.AddScoped<IEmailClient, FakeEmailClient>();
+
+        // ========================================
+        // DEPENDENCIAS TRANSITIVAS - NAO ESQUECER!
+        // ========================================
+        services.AddHttpClient("FakeImageDownloader");
+        services.AddScoped<IImageDownloader>(sp =>
+        {
+            var httpClientFactory = sp.GetRequiredService<IHttpClientFactory>();
+            var httpClient = httpClientFactory.CreateClient("FakeImageDownloader");
+            var logger = sp.GetRequiredService<ILogger<FakeImageDownloader>>();
+            var options = sp.GetRequiredService<IOptions<SimulationOptions>>();
+            return new FakeImageDownloader(httpClient, logger, options);
+        });
+
+        return services;
+    }
+
+    public static IServiceCollection AddProductionClients(
+        this IServiceCollection services,
+        IConfiguration configuration)
+    {
+        // Clientes reais com HttpClient tipado
+        services.AddHttpClient<IReplicateClient, ReplicateClient>();
+        services.AddHttpClient<IPaymentClient, AsaasClient>();
+        services.AddHttpClient<IEmailClient, ResendClient>();
+        services.AddHttpClient<IImageDownloader, HttpImageDownloader>();
+
+        return services;
+    }
+}
+```
+
+---
+
+## Exemplos de Fake Clients
+
+### FakeReplicateClient (Stateful → Singleton)
+
+```csharp
+public class FakeReplicateClient : IReplicateClient
+{
+    // Stateful - REQUER Singleton
+    private readonly Dictionary<string, FakePrediction> _predictions = new();
+    private readonly ILogger<FakeReplicateClient> _logger;
+    private readonly SimulationOptions _options;
+
+    public FakeReplicateClient(
+        ILogger<FakeReplicateClient> logger,
+        IOptions<SimulationOptions> options)
+    {
+        _logger = logger;
+        _options = options.Value;
+    }
+
+    public Task<string> CreatePredictionAsync(CreatePredictionRequest request, CancellationToken ct)
+    {
+        var id = Guid.NewGuid().ToString();
+        _predictions[id] = new FakePrediction
+        {
+            Id = id,
+            Status = "processing",
+            Prompt = request.Input.Prompt,
+            CreatedAt = DateTime.UtcNow
+        };
+
+        _logger.LogInformation(
+            "[SIMULATED] Created prediction {Id} with prompt: {Prompt}",
+            id, request.Input.Prompt?.Substring(0, Math.Min(50, request.Input.Prompt.Length)));
+
+        return Task.FromResult(id);
+    }
+
+    public async Task<PredictionResult> WaitForPredictionAsync(string id, CancellationToken ct)
+    {
+        if (!_predictions.TryGetValue(id, out var prediction))
+            throw new InvalidOperationException($"Prediction {id} not found");
+
+        // Simular delay de processamento
+        await Task.Delay(_options.ImageDelayMs, ct);
+
+        var style = ExtractStyleFromPrompt(prediction.Prompt);
+
+        _logger.LogInformation(
+            "[SIMULATED] Prediction {Id} completed. Style: {Style}",
+            id, style);
+
+        return new PredictionResult
+        {
+            Id = id,
+            Status = "succeeded",
+            Output = _options.PlaceholderImageUrl
+        };
+    }
+
+    private static string ExtractStyleFromPrompt(string? prompt)
+    {
+        if (string.IsNullOrEmpty(prompt)) return "Default";
+
+        var lowerPrompt = prompt.ToLowerInvariant();
+
+        // IMPORTANTE: Atualizar conforme prompts REAIS do projeto
+        if (lowerPrompt.Contains("movie poster")) return "MoviePoster";
+        if (lowerPrompt.Contains("impressionist")) return "Impressionist";
+        if (lowerPrompt.Contains("baroque")) return "Baroque";
+        if (lowerPrompt.Contains("watercolor")) return "Watercolor";
+
+        return "Default";
+    }
+
+    private class FakePrediction
+    {
+        public string Id { get; init; } = "";
+        public string Status { get; set; } = "";
+        public string? Prompt { get; init; }
+        public DateTime CreatedAt { get; init; }
+    }
+}
+```
+
+### FakeEmailClient (Stateless → Scoped)
+
+```csharp
+public class FakeEmailClient : IEmailClient
+{
+    private readonly ILogger<FakeEmailClient> _logger;
+    private readonly SimulationOptions _options;
+
+    public FakeEmailClient(
+        ILogger<FakeEmailClient> logger,
+        IOptions<SimulationOptions> options)
+    {
+        _logger = logger;
+        _options = options.Value;
+    }
+
+    public async Task<string?> SendEmailAsync(
+        string to,
+        string subject,
+        string htmlBody,
+        IReadOnlyList<EmailAttachment>? attachments = null,
+        CancellationToken ct = default)
+    {
+        await Task.Delay(_options.EmailDelayMs, ct);
+
+        var attachmentCount = attachments?.Count ?? 0;
+
+        _logger.LogInformation(
+            "[SIMULATED] Email sent to {To}. Subject: {Subject}. Attachments: {Count}",
+            to, subject, attachmentCount);
+
+        return $"fake-message-{Guid.NewGuid():N}";
+    }
+}
+```
+
+### FakeImageDownloader (Stateless → Scoped)
+
+```csharp
+public class FakeImageDownloader : IImageDownloader
+{
+    private readonly HttpClient _httpClient;
+    private readonly ILogger<FakeImageDownloader> _logger;
+    private readonly SimulationOptions _options;
+
+    public FakeImageDownloader(
+        HttpClient httpClient,
+        ILogger<FakeImageDownloader> logger,
+        IOptions<SimulationOptions> options)
+    {
+        _httpClient = httpClient;
+        _logger = logger;
+        _options = options.Value;
+    }
+
+    public async Task<byte[]> DownloadAsync(string url, CancellationToken ct)
+    {
+        _logger.LogInformation(
+            "[SIMULATED] Downloading image from placeholder instead of {Url}",
+            url);
+
+        // Baixa imagem real do placeholder
+        var response = await _httpClient.GetAsync(_options.PlaceholderImageUrl, ct);
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadAsByteArrayAsync(ct);
+    }
+}
+```
+
+---
+
+## Startup Warning
+
+```csharp
+public class SimulationWarningStartupFilter : IStartupFilter
+{
+    private readonly ILogger<SimulationWarningStartupFilter> _logger;
+
+    public SimulationWarningStartupFilter(ILogger<SimulationWarningStartupFilter> logger)
+    {
+        _logger = logger;
+    }
+
+    public Action<IApplicationBuilder> Configure(Action<IApplicationBuilder> next)
+    {
+        _logger.LogWarning(
+            "⚠️ SIMULATION MODE ENABLED - External services are being simulated!");
+
+        return next;
+    }
+}
+```
+
+---
+
+## Dependency Trace Template
+
+Antes de implementar, preencher este trace:
+
+```markdown
+## Dependency Trace para Simulacao
+
+### Feature: {Nome da Feature}
+
+### Fluxo Principal:
+1. Controller/Page chama {ServiceA}
+2. {ServiceA} chama {IExternalClient}
+3. {IExternalClient} retorna dados
+4. {ServiceA} chama {IDependenciaTransitiva} ← NAO ESQUECER!
+
+### Servicos a Mockar:
+| Interface | Fake | Lifetime | Motivo |
+|-----------|------|----------|--------|
+| IReplicateClient | FakeReplicateClient | Singleton | Stateful (Dictionary) |
+| IEmailClient | FakeEmailClient | Scoped | Stateless |
+| IImageDownloader | FakeImageDownloader | Scoped | Stateless |
+
+### Checklist:
+- [ ] Todas as interfaces mapeadas
+- [ ] Lifetimes definidos corretamente
+- [ ] Dependencias transitivas identificadas
+- [ ] Assinaturas de metodos verificadas
+- [ ] Prompts/payloads atuais lidos (se IA)
+```
+
+---
+
+## Checklist Rapido
+
+```markdown
+### Pre-Implementacao:
+- [ ] Listar TODAS as interfaces envolvidas no fluxo
+- [ ] Verificar dependencias transitivas (DI graph)
+- [ ] Ler assinaturas COMPLETAS das interfaces
+- [ ] Verificar lifetimes necessarios (Singleton vs Scoped)
+
+### Para mocks de IA:
+- [ ] Ler prompts/payloads ATUAIS do codigo
+- [ ] Verificar formato de response da API real
+- [ ] Testar com dados reais primeiro (1 chamada) antes de mockar
+
+### Para mocks de Email:
+- [ ] Verificar se ha attachments/inline images
+- [ ] Testar renderizacao do template separadamente
+
+### Pos-Implementacao:
+- [ ] Build passa: `dotnet build`
+- [ ] DI valido: `dotnet run` sem erros
+- [ ] Fluxo funciona em modo simulacao
+```
+
+---
+
+*MORPH-SPEC Simulation Template*