Editions

public class Edition : AuditableEntity<Guid>
{
    public string Name { get; set; } = null!;           // internal slug (e.g. "basic", "pro")
    public string? DisplayNameEn { get; set; }          // localized display name
    public string? DisplayNameAr { get; set; }
    public string? Description { get; set; }
    public string? Tagline { get; set; }                // short marketing tagline
    public string? RecommendationLabels { get; set; }   // JSON badge labels (e.g. ["Best Value"])
    public int TierLevel { get; set; }                  // 0 = Free, 1+ = premium
    public bool IsSystem { get; set; }
    public bool IsRetired { get; set; }                 // no new assignments allowed
    public Guid? EditionCategoryId { get; set; }        // grouping for signup plan picker
    public Guid? FallbackEditionId { get; set; }
    public OverflowPolicy OverflowPolicy { get; set; } = OverflowPolicy.Block;

    // Billing Toggles
    public bool AllowMonthly { get; set; } = true;
    public bool AllowYearly { get; set; } = true;
    public bool AllowLifetime { get; set; } = true;
    public bool AllowTrial { get; set; } = true;
    public bool IsSelfServiceEnabled { get; set; } = true;
    public bool IsContactSalesOnly { get; set; }

    // Computed: free when no billing types enabled
    public bool IsFree => !AllowTrial && !AllowMonthly && !AllowYearly && !AllowLifetime && !IsContactSalesOnly;

    // Trial Configuration
    [Range(1, 730)]
    public int TrialDurationDays { get; set; } = 14;
    public bool TrialIsFree { get; set; } = true;
    [Range(0, 100)]
    public int TrialDiscountPercent { get; set; } = 100;  // int, not decimal

    public int GracePeriodDays { get; set; } = 0;
    public int MaxActiveSubscriptions { get; set; } = -1;  // -1 = unlimited
    public int CurrentVersion { get; set; } = 1;
    public decimal? ConnectCommissionRate { get; set; }    // Stripe Connect commission (null = global default)
    public string? StripeProductId { get; set; }           // null until first catalog sync

    public virtual ICollection<EditionFeature> Features { get; set; } = new List<EditionFeature>();
    public virtual ICollection<EditionPrice> Prices { get; set; } = new List<EditionPrice>();
    public virtual ICollection<EditionVersion> Versions { get; set; } = new List<EditionVersion>();
    public ICollection<EditionPromotion> Promotions { get; set; } = new List<EditionPromotion>();
}

public enum OverflowPolicy
{
    /// <summary>Block downgrade if any resource exceeds the new limit</summary>
    Block = 0,
    
    /// <summary>Allow downgrade but warn; existing resources grandfathered</summary>
    Warn = 1,
    
    /// <summary>Silently allow downgrade; no enforcement on existing data</summary>
    Allow = 2,
}

public class EditionFeature
{
    public Guid EditionId { get; set; }
    public Edition Edition { get; set; } = null!;
    
    public Guid FeatureId { get; set; }
    public Feature Feature { get; set; } = null!;
    
    public string Value { get; set; } = string.Empty;
    // Interpreted as: bool (Boolean), int (Numeric), or string (String)
}