@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

package/framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs

@@ -0,0 +1,61 @@
+name: Deploy to Azure App Service
+
+on:
+  workflow_call:
+    inputs:
+      environment:
+        required: true
+        type: string
+      resource-group:
+        required: true
+        type: string
+      app-service-name:
+        required: true
+        type: string
+      package-path:
+        required: false
+        type: string
+        default: './publish'
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: ${{{{ inputs.environment }}}}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Azure Login (OIDC)
+        uses: azure/login@v1
+        with:
+          client-id: ${{{{ secrets.AZURE_CLIENT_ID }}}}
+          tenant-id: ${{{{ secrets.AZURE_TENANT_ID }}}}
+          subscription-id: ${{{{ secrets.AZURE_SUBSCRIPTION_ID }}}}
+
+      - name: Deploy Infrastructure (Bicep)
+        uses: azure/arm-deploy@v1
+        with:
+          resourceGroupName: ${{{{ inputs.resource-group }}}}
+          template: .morph/templates/infra/main.bicep
+          parameters: .morph/templates/infra/parameters.${{{{ inputs.environment }}}}.json
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '{{DOTNET_VERSION}}'
+
+      - name: Publish .NET App
+        run: dotnet publish -c Release -o ${{{{ inputs.package-path }}}}
+
+      - name: Deploy to App Service
+        uses: azure/webapps-deploy@v2
+        with:
+          app-name: ${{{{ inputs.app-service-name }}}}
+          package: ${{{{ inputs.package-path }}}}
+
+      - name: Health Check
+        run: |
+          APP_URL=$(az webapp show \
+            --name ${{{{ inputs.app-service-name }}}} \
+            --resource-group ${{{{ inputs.resource-group }}}} \
+            --query defaultHostName -o tsv)
+          curl --retry 10 --retry-delay 5 --retry-connrefused https://$APP_URL/health

package/framework/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs

@@ -0,0 +1,31 @@
+name: Deploy to EasyPanel
+
+on:
+  workflow_call:
+    inputs:
+      environment:
+        required: true
+        type: string
+      image:
+        required: true
+        type: string
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: ${{{{ inputs.environment }}}}
+    steps:
+      - name: Trigger EasyPanel Deploy
+        run: |
+          curl -X POST ${{{{ secrets.EASYPANEL_WEBHOOK_URL }}}} \
+            -H "Authorization: Bearer ${{{{ secrets.EASYPANEL_API_TOKEN }}}}" \
+            -H "Content-Type: application/json" \
+            -d '{
+              "image": "${{{{ inputs.image }}}}",
+              "environment": "${{{{ inputs.environment }}}}"
+            }'
+
+      - name: Health Check
+        run: |
+          sleep 30  # Wait for deployment
+          curl --retry 10 --retry-delay 5 --retry-connrefused ${{{{ secrets.APP_URL }}}}/health

package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs

@@ -0,0 +1,59 @@
+name: Build & Push Docker Image
+
+on:
+  workflow_call:
+    inputs:
+      registry:
+        required: true
+        type: string
+      image-name:
+        required: true
+        type: string
+      dockerfile-path:
+        required: false
+        type: string
+        default: 'Dockerfile'
+      build-context:
+        required: false
+        type: string
+        default: '.'
+    outputs:
+      image-tag:
+        value: ${{{{ jobs.docker.outputs.tag }}}}
+
+jobs:
+  docker:
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{{{ steps.meta.outputs.tags }}}}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{{{ inputs.registry }}}}
+          username: ${{{{ secrets.REGISTRY_USERNAME }}}}
+          password: ${{{{ secrets.REGISTRY_PASSWORD }}}}
+
+      - name: Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{{{ inputs.registry }}}}/${{{{ inputs.image-name }}}}
+          tags: |
+            type=ref,event=branch
+            type=sha,prefix=${{{{ inputs.image-name }}}}-
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: ${{{{ inputs.build-context }}}}
+          file: ${{{{ inputs.dockerfile-path }}}}
+          push: true
+          tags: ${{{{ steps.meta.outputs.tags }}}}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs

@@ -0,0 +1,39 @@
+name: Build .NET Application
+
+on:
+  workflow_call:
+    inputs:
+      dotnet-version:
+        required: false
+        type: string
+        default: '{{DOTNET_VERSION}}'
+      build-configuration:
+        required: false
+        type: string
+        default: 'Release'
+      run-tests:
+        required: false
+        type: boolean
+        default: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{{{ inputs.dotnet-version }}}}
+
+      - name: Restore dependencies
+        run: dotnet restore
+
+      - name: Build
+        run: dotnet build --configuration ${{{{ inputs.build-configuration }}}} --no-restore
+
+      {{#if run-tests}}
+      - name: Test
+        run: dotnet test --configuration ${{{{ inputs.build-configuration }}}} --no-build --verbosity normal
+      {{/if}}

package/framework/templates/integrations/asaas-client.cs

@@ -0,0 +1,387 @@
+// ==============================================================================
+// MORPH-SPEC - Asaas Client Template
+// HTTP Client para integração com Asaas API
+// ==============================================================================
+
+using System.Net.Http.Json;
+using System.Text.Json.Serialization;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
+
+namespace {{Namespace}}.Infrastructure.Services;
+
+// ==============================================================================
+// OPTIONS
+// ==============================================================================
+
+public class AsaasOptions
+{
+    public const string SectionName = "Asaas";
+
+    /// <summary>
+    /// Base URL da API (sandbox ou produção)
+    /// Sandbox: https://sandbox.asaas.com/api/v3
+    /// Produção: https://www.asaas.com/api/v3
+    /// </summary>
+    public string BaseUrl { get; set; } = "https://sandbox.asaas.com/api/v3";
+
+    /// <summary>
+    /// API Key do Asaas
+    /// </summary>
+    public string ApiKey { get; set; } = string.Empty;
+}
+
+// ==============================================================================
+// INTERFACE
+// ==============================================================================
+
+public interface IAsaasClient
+{
+    // Customers
+    Task<AsaasCustomer> CreateCustomerAsync(CreateCustomerRequest request, CancellationToken ct = default);
+    Task<AsaasCustomer?> GetCustomerByIdAsync(string customerId, CancellationToken ct = default);
+    Task<AsaasCustomer?> GetCustomerByCpfCnpjAsync(string cpfCnpj, CancellationToken ct = default);
+
+    // Payments
+    Task<AsaasPayment> CreatePaymentAsync(CreatePaymentRequest request, CancellationToken ct = default);
+    Task<AsaasPayment?> GetPaymentAsync(string paymentId, CancellationToken ct = default);
+    Task<AsaasPixQrCode?> GetPixQrCodeAsync(string paymentId, CancellationToken ct = default);
+
+    // Subscriptions
+    Task<AsaasSubscription> CreateSubscriptionAsync(CreateSubscriptionRequest request, CancellationToken ct = default);
+    Task<AsaasSubscription?> GetSubscriptionAsync(string subscriptionId, CancellationToken ct = default);
+    Task CancelSubscriptionAsync(string subscriptionId, CancellationToken ct = default);
+}
+
+// ==============================================================================
+// IMPLEMENTATION
+// ==============================================================================
+
+public class AsaasClient : IAsaasClient
+{
+    private readonly HttpClient _httpClient;
+    private readonly ILogger<AsaasClient> _logger;
+
+    public AsaasClient(HttpClient httpClient, ILogger<AsaasClient> logger)
+    {
+        _httpClient = httpClient;
+        _logger = logger;
+    }
+
+    // =========================================================================
+    // CUSTOMERS
+    // =========================================================================
+
+    public async Task<AsaasCustomer> CreateCustomerAsync(CreateCustomerRequest request, CancellationToken ct = default)
+    {
+        _logger.LogInformation("Creating Asaas customer: {Name}", request.Name);
+
+        var response = await _httpClient.PostAsJsonAsync("customers", request, ct);
+        await EnsureSuccessAsync(response, "create customer");
+
+        return await response.Content.ReadFromJsonAsync<AsaasCustomer>(ct)
+            ?? throw new AsaasException("Failed to deserialize customer response");
+    }
+
+    public async Task<AsaasCustomer?> GetCustomerByIdAsync(string customerId, CancellationToken ct = default)
+    {
+        var response = await _httpClient.GetAsync($"customers/{customerId}", ct);
+
+        if (response.StatusCode == System.Net.HttpStatusCode.NotFound)
+            return null;
+
+        await EnsureSuccessAsync(response, "get customer");
+        return await response.Content.ReadFromJsonAsync<AsaasCustomer>(ct);
+    }
+
+    public async Task<AsaasCustomer?> GetCustomerByCpfCnpjAsync(string cpfCnpj, CancellationToken ct = default)
+    {
+        var response = await _httpClient.GetAsync($"customers?cpfCnpj={cpfCnpj}", ct);
+        await EnsureSuccessAsync(response, "search customer");
+
+        var result = await response.Content.ReadFromJsonAsync<AsaasListResponse<AsaasCustomer>>(ct);
+        return result?.Data?.FirstOrDefault();
+    }
+
+    // =========================================================================
+    // PAYMENTS
+    // =========================================================================
+
+    public async Task<AsaasPayment> CreatePaymentAsync(CreatePaymentRequest request, CancellationToken ct = default)
+    {
+        _logger.LogInformation("Creating Asaas payment for customer {CustomerId}, type {BillingType}, value {Value}",
+            request.Customer, request.BillingType, request.Value);
+
+        var response = await _httpClient.PostAsJsonAsync("payments", request, ct);
+        await EnsureSuccessAsync(response, "create payment");
+
+        return await response.Content.ReadFromJsonAsync<AsaasPayment>(ct)
+            ?? throw new AsaasException("Failed to deserialize payment response");
+    }
+
+    public async Task<AsaasPayment?> GetPaymentAsync(string paymentId, CancellationToken ct = default)
+    {
+        var response = await _httpClient.GetAsync($"payments/{paymentId}", ct);
+
+        if (response.StatusCode == System.Net.HttpStatusCode.NotFound)
+            return null;
+
+        await EnsureSuccessAsync(response, "get payment");
+        return await response.Content.ReadFromJsonAsync<AsaasPayment>(ct);
+    }
+
+    public async Task<AsaasPixQrCode?> GetPixQrCodeAsync(string paymentId, CancellationToken ct = default)
+    {
+        var response = await _httpClient.GetAsync($"payments/{paymentId}/pixQrCode", ct);
+
+        if (response.StatusCode == System.Net.HttpStatusCode.NotFound)
+            return null;
+
+        await EnsureSuccessAsync(response, "get pix qrcode");
+        return await response.Content.ReadFromJsonAsync<AsaasPixQrCode>(ct);
+    }
+
+    // =========================================================================
+    // SUBSCRIPTIONS
+    // =========================================================================
+
+    public async Task<AsaasSubscription> CreateSubscriptionAsync(CreateSubscriptionRequest request, CancellationToken ct = default)
+    {
+        _logger.LogInformation("Creating Asaas subscription for customer {CustomerId}", request.Customer);
+
+        var response = await _httpClient.PostAsJsonAsync("subscriptions", request, ct);
+        await EnsureSuccessAsync(response, "create subscription");
+
+        return await response.Content.ReadFromJsonAsync<AsaasSubscription>(ct)
+            ?? throw new AsaasException("Failed to deserialize subscription response");
+    }
+
+    public async Task<AsaasSubscription?> GetSubscriptionAsync(string subscriptionId, CancellationToken ct = default)
+    {
+        var response = await _httpClient.GetAsync($"subscriptions/{subscriptionId}", ct);
+
+        if (response.StatusCode == System.Net.HttpStatusCode.NotFound)
+            return null;
+
+        await EnsureSuccessAsync(response, "get subscription");
+        return await response.Content.ReadFromJsonAsync<AsaasSubscription>(ct);
+    }
+
+    public async Task CancelSubscriptionAsync(string subscriptionId, CancellationToken ct = default)
+    {
+        _logger.LogInformation("Canceling Asaas subscription {SubscriptionId}", subscriptionId);
+
+        var response = await _httpClient.DeleteAsync($"subscriptions/{subscriptionId}", ct);
+        await EnsureSuccessAsync(response, "cancel subscription");
+    }
+
+    // =========================================================================
+    // HELPERS
+    // =========================================================================
+
+    private async Task EnsureSuccessAsync(HttpResponseMessage response, string operation)
+    {
+        if (!response.IsSuccessStatusCode)
+        {
+            var error = await response.Content.ReadAsStringAsync();
+            _logger.LogError("Asaas API error during {Operation}: {StatusCode} - {Error}",
+                operation, response.StatusCode, error);
+            throw new AsaasException($"Failed to {operation}: {response.StatusCode} - {error}");
+        }
+    }
+}
+
+// ==============================================================================
+// DTOS
+// ==============================================================================
+
+public record CreateCustomerRequest
+{
+    [JsonPropertyName("name")]
+    public required string Name { get; init; }
+
+    [JsonPropertyName("cpfCnpj")]
+    public required string CpfCnpj { get; init; }
+
+    [JsonPropertyName("email")]
+    public string? Email { get; init; }
+
+    [JsonPropertyName("phone")]
+    public string? Phone { get; init; }
+
+    [JsonPropertyName("mobilePhone")]
+    public string? MobilePhone { get; init; }
+
+    [JsonPropertyName("externalReference")]
+    public string? ExternalReference { get; init; }
+}
+
+public record CreatePaymentRequest
+{
+    [JsonPropertyName("customer")]
+    public required string Customer { get; init; }
+
+    [JsonPropertyName("billingType")]
+    public required string BillingType { get; init; } // BOLETO, PIX, CREDIT_CARD
+
+    [JsonPropertyName("value")]
+    public required decimal Value { get; init; }
+
+    [JsonPropertyName("dueDate")]
+    public required string DueDate { get; init; } // yyyy-MM-dd
+
+    [JsonPropertyName("description")]
+    public string? Description { get; init; }
+
+    [JsonPropertyName("externalReference")]
+    public string? ExternalReference { get; init; }
+}
+
+public record CreateSubscriptionRequest
+{
+    [JsonPropertyName("customer")]
+    public required string Customer { get; init; }
+
+    [JsonPropertyName("billingType")]
+    public required string BillingType { get; init; }
+
+    [JsonPropertyName("value")]
+    public required decimal Value { get; init; }
+
+    [JsonPropertyName("nextDueDate")]
+    public required string NextDueDate { get; init; }
+
+    [JsonPropertyName("cycle")]
+    public required string Cycle { get; init; } // MONTHLY, WEEKLY, BIWEEKLY, YEARLY
+
+    [JsonPropertyName("description")]
+    public string? Description { get; init; }
+
+    [JsonPropertyName("externalReference")]
+    public string? ExternalReference { get; init; }
+}
+
+public record AsaasCustomer
+{
+    [JsonPropertyName("id")]
+    public string Id { get; init; } = string.Empty;
+
+    [JsonPropertyName("name")]
+    public string Name { get; init; } = string.Empty;
+
+    [JsonPropertyName("cpfCnpj")]
+    public string CpfCnpj { get; init; } = string.Empty;
+
+    [JsonPropertyName("email")]
+    public string? Email { get; init; }
+
+    [JsonPropertyName("externalReference")]
+    public string? ExternalReference { get; init; }
+}
+
+public record AsaasPayment
+{
+    [JsonPropertyName("id")]
+    public string Id { get; init; } = string.Empty;
+
+    [JsonPropertyName("customer")]
+    public string Customer { get; init; } = string.Empty;
+
+    [JsonPropertyName("value")]
+    public decimal Value { get; init; }
+
+    [JsonPropertyName("status")]
+    public string Status { get; init; } = string.Empty;
+
+    [JsonPropertyName("billingType")]
+    public string BillingType { get; init; } = string.Empty;
+
+    [JsonPropertyName("dueDate")]
+    public string DueDate { get; init; } = string.Empty;
+
+    [JsonPropertyName("invoiceUrl")]
+    public string? InvoiceUrl { get; init; }
+
+    [JsonPropertyName("bankSlipUrl")]
+    public string? BankSlipUrl { get; init; }
+
+    [JsonPropertyName("externalReference")]
+    public string? ExternalReference { get; init; }
+}
+
+public record AsaasPixQrCode
+{
+    [JsonPropertyName("encodedImage")]
+    public string? EncodedImage { get; init; }
+
+    [JsonPropertyName("payload")]
+    public string? Payload { get; init; }
+
+    [JsonPropertyName("expirationDate")]
+    public string? ExpirationDate { get; init; }
+}
+
+public record AsaasSubscription
+{
+    [JsonPropertyName("id")]
+    public string Id { get; init; } = string.Empty;
+
+    [JsonPropertyName("customer")]
+    public string Customer { get; init; } = string.Empty;
+
+    [JsonPropertyName("value")]
+    public decimal Value { get; init; }
+
+    [JsonPropertyName("status")]
+    public string Status { get; init; } = string.Empty;
+
+    [JsonPropertyName("cycle")]
+    public string Cycle { get; init; } = string.Empty;
+
+    [JsonPropertyName("nextDueDate")]
+    public string NextDueDate { get; init; } = string.Empty;
+
+    [JsonPropertyName("externalReference")]
+    public string? ExternalReference { get; init; }
+}
+
+public record AsaasListResponse<T>
+{
+    [JsonPropertyName("data")]
+    public List<T>? Data { get; init; }
+
+    [JsonPropertyName("totalCount")]
+    public int TotalCount { get; init; }
+}
+
+// ==============================================================================
+// EXCEPTION
+// ==============================================================================
+
+public class AsaasException : Exception
+{
+    public AsaasException(string message) : base(message) { }
+    public AsaasException(string message, Exception innerException) : base(message, innerException) { }
+}
+
+// ==============================================================================
+// DEPENDENCY INJECTION
+// ==============================================================================
+
+public static class AsaasServiceExtensions
+{
+    public static IServiceCollection AddAsaasClient(this IServiceCollection services, IConfiguration configuration)
+    {
+        services.Configure<AsaasOptions>(configuration.GetSection(AsaasOptions.SectionName));
+
+        services.AddHttpClient<IAsaasClient, AsaasClient>((sp, client) =>
+        {
+            var options = sp.GetRequiredService<IOptions<AsaasOptions>>().Value;
+            client.BaseAddress = new Uri(options.BaseUrl.TrimEnd('/') + "/");
+            client.DefaultRequestHeaders.Add("access_token", options.ApiKey);
+            client.DefaultRequestHeaders.Add("User-Agent", "MORPH-SPEC/1.0");
+        });
+
+        return services;
+    }
+}