@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

package/framework/templates/saas/subscription.cs

@@ -0,0 +1,347 @@
+// ==============================================================================
+// MORPH-SPEC - Subscription Model Template
+// Modelo de assinatura para SaaS
+// ==============================================================================
+
+using System.ComponentModel.DataAnnotations;
+
+namespace {{Namespace}}.Domain.Entities;
+
+// ==============================================================================
+// SUBSCRIPTION ENTITY
+// ==============================================================================
+
+public class Subscription : BaseEntity
+{
+    public int TenantId { get; private set; }
+    public Tenant Tenant { get; private set; } = null!;
+
+    public int PlanId { get; private set; }
+    public Plan Plan { get; private set; } = null!;
+
+    public SubscriptionStatus Status { get; private set; }
+    public BillingCycle Cycle { get; private set; }
+
+    public DateTime StartDate { get; private set; }
+    public DateTime? EndDate { get; private set; }
+    public DateTime? CancelledAt { get; private set; }
+    public DateTime NextBillingDate { get; private set; }
+
+    public decimal CurrentPrice { get; private set; }
+    public string? ExternalSubscriptionId { get; private set; } // Asaas subscription ID
+
+    public ICollection<SubscriptionPayment> Payments { get; private set; } = new List<SubscriptionPayment>();
+
+    // =========================================================================
+    // FACTORY
+    // =========================================================================
+
+    public static Subscription Create(int tenantId, int planId, BillingCycle cycle, decimal price)
+    {
+        return new Subscription
+        {
+            TenantId = tenantId,
+            PlanId = planId,
+            Status = SubscriptionStatus.PendingPayment,
+            Cycle = cycle,
+            StartDate = DateTime.UtcNow,
+            NextBillingDate = DateTime.UtcNow,
+            CurrentPrice = price,
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    // =========================================================================
+    // BEHAVIORS
+    // =========================================================================
+
+    public void Activate(string externalSubscriptionId)
+    {
+        Status = SubscriptionStatus.Active;
+        ExternalSubscriptionId = externalSubscriptionId;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Suspend()
+    {
+        Status = SubscriptionStatus.Suspended;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Cancel(DateTime? endDate = null)
+    {
+        Status = SubscriptionStatus.Cancelled;
+        CancelledAt = DateTime.UtcNow;
+        EndDate = endDate ?? DateTime.UtcNow;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Renew()
+    {
+        NextBillingDate = CalculateNextBillingDate();
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void ChangePlan(int newPlanId, decimal newPrice)
+    {
+        PlanId = newPlanId;
+        CurrentPrice = newPrice;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void AddPayment(SubscriptionPayment payment)
+    {
+        Payments.Add(payment);
+    }
+
+    // =========================================================================
+    // QUERIES
+    // =========================================================================
+
+    public bool IsActive => Status == SubscriptionStatus.Active;
+    public bool IsCancelled => Status == SubscriptionStatus.Cancelled;
+    public bool IsSuspended => Status == SubscriptionStatus.Suspended;
+    public bool IsExpired => EndDate.HasValue && EndDate.Value < DateTime.UtcNow;
+
+    public int DaysUntilRenewal => (NextBillingDate - DateTime.UtcNow).Days;
+    public bool IsNearRenewal => DaysUntilRenewal <= 3;
+
+    private DateTime CalculateNextBillingDate()
+    {
+        return Cycle switch
+        {
+            BillingCycle.Monthly => NextBillingDate.AddMonths(1),
+            BillingCycle.Quarterly => NextBillingDate.AddMonths(3),
+            BillingCycle.Yearly => NextBillingDate.AddYears(1),
+            _ => NextBillingDate.AddMonths(1)
+        };
+    }
+}
+
+// ==============================================================================
+// SUBSCRIPTION PAYMENT ENTITY
+// ==============================================================================
+
+public class SubscriptionPayment : BaseEntity
+{
+    public int SubscriptionId { get; private set; }
+    public Subscription Subscription { get; private set; } = null!;
+
+    public decimal Amount { get; private set; }
+    public PaymentStatus Status { get; private set; }
+    public PaymentMethod Method { get; private set; }
+
+    public DateTime DueDate { get; private set; }
+    public DateTime? PaidAt { get; private set; }
+
+    public string? ExternalPaymentId { get; private set; } // Asaas payment ID
+    public string? InvoiceUrl { get; private set; }
+    public string? BoletoUrl { get; private set; }
+    public string? PixQrCode { get; private set; }
+    public string? PixPayload { get; private set; }
+
+    // =========================================================================
+    // FACTORY
+    // =========================================================================
+
+    public static SubscriptionPayment Create(
+        int subscriptionId,
+        decimal amount,
+        PaymentMethod method,
+        DateTime dueDate)
+    {
+        return new SubscriptionPayment
+        {
+            SubscriptionId = subscriptionId,
+            Amount = amount,
+            Status = PaymentStatus.Pending,
+            Method = method,
+            DueDate = dueDate,
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    // =========================================================================
+    // BEHAVIORS
+    // =========================================================================
+
+    public void SetExternalId(string externalPaymentId)
+    {
+        ExternalPaymentId = externalPaymentId;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void SetPaymentUrls(string? invoiceUrl, string? boletoUrl)
+    {
+        InvoiceUrl = invoiceUrl;
+        BoletoUrl = boletoUrl;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void SetPixData(string qrCode, string payload)
+    {
+        PixQrCode = qrCode;
+        PixPayload = payload;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void MarkAsPaid()
+    {
+        Status = PaymentStatus.Paid;
+        PaidAt = DateTime.UtcNow;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void MarkAsOverdue()
+    {
+        Status = PaymentStatus.Overdue;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void MarkAsRefunded()
+    {
+        Status = PaymentStatus.Refunded;
+        UpdatedAt = DateTime.UtcNow;
+    }
+}
+
+// ==============================================================================
+// PLAN ENTITY
+// ==============================================================================
+
+public class Plan : BaseEntity
+{
+    [Required]
+    [MaxLength(100)]
+    public string Name { get; private set; } = string.Empty;
+
+    [MaxLength(500)]
+    public string? Description { get; private set; }
+
+    public decimal MonthlyPrice { get; private set; }
+    public decimal YearlyPrice { get; private set; }
+
+    public int MaxUsers { get; private set; }
+    public long MaxStorageBytes { get; private set; }
+
+    public bool IsActive { get; private set; }
+    public int SortOrder { get; private set; }
+
+    public ICollection<PlanFeature> Features { get; private set; } = new List<PlanFeature>();
+
+    // =========================================================================
+    // FACTORY
+    // =========================================================================
+
+    public static Plan Create(
+        string name,
+        decimal monthlyPrice,
+        decimal yearlyPrice,
+        int maxUsers,
+        long maxStorageBytes)
+    {
+        return new Plan
+        {
+            Name = name,
+            MonthlyPrice = monthlyPrice,
+            YearlyPrice = yearlyPrice,
+            MaxUsers = maxUsers,
+            MaxStorageBytes = maxStorageBytes,
+            IsActive = true,
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    // =========================================================================
+    // QUERIES
+    // =========================================================================
+
+    public decimal GetPrice(BillingCycle cycle) => cycle switch
+    {
+        BillingCycle.Monthly => MonthlyPrice,
+        BillingCycle.Quarterly => MonthlyPrice * 3 * 0.95m, // 5% discount
+        BillingCycle.Yearly => YearlyPrice,
+        _ => MonthlyPrice
+    };
+
+    public decimal YearlySavings => (MonthlyPrice * 12) - YearlyPrice;
+    public int YearlySavingsPercent => (int)((YearlySavings / (MonthlyPrice * 12)) * 100);
+}
+
+// ==============================================================================
+// PLAN FEATURE ENTITY
+// ==============================================================================
+
+public class PlanFeature
+{
+    public int Id { get; private set; }
+    public int PlanId { get; private set; }
+    public Plan Plan { get; private set; } = null!;
+
+    [Required]
+    [MaxLength(100)]
+    public string Name { get; private set; } = string.Empty;
+
+    [MaxLength(200)]
+    public string? Description { get; private set; }
+
+    public bool IsIncluded { get; private set; }
+    public int? Limit { get; private set; } // null = unlimited
+
+    public static PlanFeature Create(string name, bool isIncluded, int? limit = null)
+    {
+        return new PlanFeature
+        {
+            Name = name,
+            IsIncluded = isIncluded,
+            Limit = limit
+        };
+    }
+}
+
+// ==============================================================================
+// ENUMS
+// ==============================================================================
+
+public enum SubscriptionStatus
+{
+    PendingPayment,
+    Active,
+    Suspended,
+    Cancelled,
+    Expired
+}
+
+public enum BillingCycle
+{
+    Monthly,
+    Quarterly,
+    Yearly
+}
+
+public enum PaymentStatus
+{
+    Pending,
+    Paid,
+    Overdue,
+    Refunded,
+    Cancelled
+}
+
+public enum PaymentMethod
+{
+    Pix,
+    Boleto,
+    CreditCard
+}
+
+// ==============================================================================
+// BASE ENTITY
+// ==============================================================================
+
+public abstract class BaseEntity
+{
+    public int Id { get; protected set; }
+    public DateTime CreatedAt { get; protected set; }
+    public DateTime? UpdatedAt { get; protected set; }
+}

package/framework/templates/saas/tenant.cs

@@ -0,0 +1,338 @@
+// ==============================================================================
+// MORPH-SPEC - Multi-Tenant Model Template
+// Modelo de multi-tenancy para SaaS
+// ==============================================================================
+
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace {{Namespace}}.Domain.Entities;
+
+// ==============================================================================
+// TENANT ENTITY
+// ==============================================================================
+
+public class Tenant : BaseEntity
+{
+    [Required]
+    [MaxLength(100)]
+    public string Name { get; private set; } = string.Empty;
+
+    [Required]
+    [MaxLength(50)]
+    public string Slug { get; private set; } = string.Empty; // Unique identifier (URL-friendly)
+
+    [MaxLength(500)]
+    public string? Description { get; private set; }
+
+    [MaxLength(200)]
+    public string? LogoUrl { get; private set; }
+
+    public TenantStatus Status { get; private set; }
+
+    // Settings
+    public string? CustomDomain { get; private set; }
+    public string? TimeZone { get; private set; }
+    public string? Locale { get; private set; }
+
+    // Billing
+    public string? AsaasCustomerId { get; private set; }
+
+    // Navigation
+    public ICollection<TenantUser> Users { get; private set; } = new List<TenantUser>();
+    public Subscription? CurrentSubscription { get; private set; }
+
+    // =========================================================================
+    // FACTORY
+    // =========================================================================
+
+    public static Tenant Create(string name, string slug)
+    {
+        return new Tenant
+        {
+            Name = name,
+            Slug = slug.ToLowerInvariant(),
+            Status = TenantStatus.Active,
+            TimeZone = "E. South America Standard Time",
+            Locale = "pt-BR",
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    // =========================================================================
+    // BEHAVIORS
+    // =========================================================================
+
+    public void UpdateInfo(string name, string? description, string? logoUrl)
+    {
+        Name = name;
+        Description = description;
+        LogoUrl = logoUrl;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void SetCustomDomain(string? domain)
+    {
+        CustomDomain = domain;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void SetAsaasCustomerId(string customerId)
+    {
+        AsaasCustomerId = customerId;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Suspend()
+    {
+        Status = TenantStatus.Suspended;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Activate()
+    {
+        Status = TenantStatus.Active;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Delete()
+    {
+        Status = TenantStatus.Deleted;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    // =========================================================================
+    // QUERIES
+    // =========================================================================
+
+    public bool IsActive => Status == TenantStatus.Active;
+    public bool IsSuspended => Status == TenantStatus.Suspended;
+    public bool IsDeleted => Status == TenantStatus.Deleted;
+}
+
+// ==============================================================================
+// TENANT USER ENTITY (Association between Users and Tenants)
+// ==============================================================================
+
+public class TenantUser : BaseEntity
+{
+    public int TenantId { get; private set; }
+    public Tenant Tenant { get; private set; } = null!;
+
+    [Required]
+    [MaxLength(100)]
+    public string ExternalUserId { get; private set; } = string.Empty; // Clerk/Azure AD user ID
+
+    [Required]
+    [MaxLength(200)]
+    public string Email { get; private set; } = string.Empty;
+
+    [MaxLength(100)]
+    public string? Name { get; private set; }
+
+    public TenantUserRole Role { get; private set; }
+    public TenantUserStatus Status { get; private set; }
+
+    public DateTime? LastLoginAt { get; private set; }
+
+    // =========================================================================
+    // FACTORY
+    // =========================================================================
+
+    public static TenantUser Create(
+        int tenantId,
+        string externalUserId,
+        string email,
+        string? name,
+        TenantUserRole role = TenantUserRole.Member)
+    {
+        return new TenantUser
+        {
+            TenantId = tenantId,
+            ExternalUserId = externalUserId,
+            Email = email,
+            Name = name,
+            Role = role,
+            Status = TenantUserStatus.Active,
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    // =========================================================================
+    // BEHAVIORS
+    // =========================================================================
+
+    public void UpdateRole(TenantUserRole role)
+    {
+        Role = role;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void RecordLogin()
+    {
+        LastLoginAt = DateTime.UtcNow;
+    }
+
+    public void Deactivate()
+    {
+        Status = TenantUserStatus.Inactive;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Activate()
+    {
+        Status = TenantUserStatus.Active;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    // =========================================================================
+    // QUERIES
+    // =========================================================================
+
+    public bool IsOwner => Role == TenantUserRole.Owner;
+    public bool IsAdmin => Role == TenantUserRole.Owner || Role == TenantUserRole.Admin;
+    public bool IsActive => Status == TenantUserStatus.Active;
+}
+
+// ==============================================================================
+// ENUMS
+// ==============================================================================
+
+public enum TenantStatus
+{
+    Active,
+    Suspended,
+    Deleted
+}
+
+public enum TenantUserRole
+{
+    Owner,
+    Admin,
+    Member,
+    Viewer
+}
+
+public enum TenantUserStatus
+{
+    Pending,
+    Active,
+    Inactive
+}
+
+// ==============================================================================
+// TENANT CONTEXT (Current Tenant Resolution)
+// ==============================================================================
+
+public interface ITenantContext
+{
+    int? TenantId { get; }
+    Tenant? CurrentTenant { get; }
+    Task<Tenant?> GetCurrentTenantAsync(CancellationToken ct = default);
+}
+
+public class TenantContext : ITenantContext
+{
+    private readonly IHttpContextAccessor _httpContextAccessor;
+    private readonly ITenantRepository _tenantRepository;
+    private Tenant? _currentTenant;
+    private bool _loaded;
+
+    public TenantContext(
+        IHttpContextAccessor httpContextAccessor,
+        ITenantRepository tenantRepository)
+    {
+        _httpContextAccessor = httpContextAccessor;
+        _tenantRepository = tenantRepository;
+    }
+
+    public int? TenantId => _currentTenant?.Id;
+    public Tenant? CurrentTenant => _currentTenant;
+
+    public async Task<Tenant?> GetCurrentTenantAsync(CancellationToken ct = default)
+    {
+        if (_loaded) return _currentTenant;
+
+        var tenantSlug = ResolveTenantSlug();
+        if (string.IsNullOrEmpty(tenantSlug))
+        {
+            _loaded = true;
+            return null;
+        }
+
+        _currentTenant = await _tenantRepository.GetBySlugAsync(tenantSlug, ct);
+        _loaded = true;
+
+        return _currentTenant;
+    }
+
+    private string? ResolveTenantSlug()
+    {
+        var httpContext = _httpContextAccessor.HttpContext;
+        if (httpContext is null) return null;
+
+        // Strategy 1: From route (e.g., /tenant/{slug}/...)
+        if (httpContext.Request.RouteValues.TryGetValue("tenantSlug", out var routeSlug))
+            return routeSlug?.ToString();
+
+        // Strategy 2: From header (e.g., X-Tenant-ID)
+        if (httpContext.Request.Headers.TryGetValue("X-Tenant-ID", out var headerSlug))
+            return headerSlug.FirstOrDefault();
+
+        // Strategy 3: From subdomain (e.g., acme.app.com)
+        var host = httpContext.Request.Host.Host;
+        var parts = host.Split('.');
+        if (parts.Length >= 3)
+            return parts[0];
+
+        // Strategy 4: From claim
+        var claimSlug = httpContext.User.FindFirst("tenant_id")?.Value;
+        if (!string.IsNullOrEmpty(claimSlug))
+            return claimSlug;
+
+        return null;
+    }
+}
+
+// ==============================================================================
+// TENANT REPOSITORY INTERFACE
+// ==============================================================================
+
+public interface ITenantRepository
+{
+    Task<Tenant?> GetByIdAsync(int id, CancellationToken ct = default);
+    Task<Tenant?> GetBySlugAsync(string slug, CancellationToken ct = default);
+    Task<bool> SlugExistsAsync(string slug, CancellationToken ct = default);
+    Task AddAsync(Tenant tenant, CancellationToken ct = default);
+    void Update(Tenant tenant);
+}
+
+// ==============================================================================
+// TENANT QUERY FILTER (EF Core)
+// ==============================================================================
+
+/*
+// In DbContext:
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    // Apply tenant filter to all tenant-scoped entities
+    modelBuilder.Entity<Order>().HasQueryFilter(o => o.TenantId == _tenantContext.TenantId);
+    modelBuilder.Entity<Customer>().HasQueryFilter(c => c.TenantId == _tenantContext.TenantId);
+    // ... other entities
+}
+*/
+
+// ==============================================================================
+// DEPENDENCY INJECTION
+// ==============================================================================
+
+public static class TenantServiceExtensions
+{
+    public static IServiceCollection AddMultiTenancy(this IServiceCollection services)
+    {
+        services.AddScoped<ITenantContext, TenantContext>();
+        services.AddScoped<ITenantRepository, TenantRepository>();
+
+        return services;
+    }
+}

package/framework/templates/state.template.json

@@ -0,0 +1,17 @@
+{
+  "version": "3.0.0",
+  "project": {
+    "name": "{{PROJECT_NAME}}",
+    "type": "{{PROJECT_TYPE}}",
+    "createdAt": "{{TIMESTAMP}}",
+    "updatedAt": "{{TIMESTAMP}}"
+  },
+  "features": {},
+  "threads": {},
+  "metadata": {
+    "totalFeatures": 0,
+    "completedFeatures": 0,
+    "totalTimeSpent": 0,
+    "lastUpdated": "{{TIMESTAMP}}"
+  }
+}