@polymorphism-tech/morph-spec 4.12.0 → 4.13.0

package/framework/templates/saas/subscription.cs

@@ -1,347 +0,0 @@
-// ==============================================================================
-// 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

@@ -1,338 +0,0 @@
-// ==============================================================================
-// 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;
-    }
-}