Points System

Global Points = Base Points × Active Multiplier

class ContributionType:
    min_points = 0      # Minimum points allowed
    max_points = 100    # Maximum points allowed

class GlobalLeaderboardMultiplier:
    contribution_type    # Which contribution type
    multiplier_value    # The multiplier (e.g., 1.5, 2.0)
    valid_from         # When this multiplier becomes active
    description        # Reason for this multiplier

# Get active multiplier for a specific date
multiplier = GlobalLeaderboardMultiplier.get_active_for_type(
    contribution_type=blog_post_type,
    at_date=datetime(2026, 4, 15)  # Returns 2.5x
)

total_points = sum(contribution.frozen_global_points 
                  for contribution in user.contributions.all())

validator_points = sum(
    contribution.frozen_global_points
    for contribution in user.contributions.filter(
        contribution_type__category__slug='validator'
    )
)

builder_points = sum(
    contribution.frozen_global_points
    for contribution in user.contributions.filter(
        contribution_type__category__slug='builder'
    )
)

waitlist_points = validator_contributions + referral_points

graduation_entry = LeaderboardEntry(
    type='validator-waitlist-graduation',
    total_points=waitlist_points,  # Frozen
    graduation_date=validator_contribution_date
)

class ReferralPoints:
    builder_points     # 10% of referred users' builder contributions
    validator_points   # 10% of referred users' validator contributions

eligible = referred_user.contributions.exclude(
    contribution_type__slug__in=['builder-welcome', 'validator-waitlist']
).exists()

@receiver(post_save, sender=Contribution)
def update_leaderboard_on_contribution(sender, instance, **kwargs):
    # Update user's leaderboard entries
    update_user_leaderboard_entries(instance.user)
    
    # Update referrer's referral points
    if instance.user.referred_by:
        update_referrer_points(instance)

frozen_global_points = models.PositiveIntegerField(
    default=0,
    help_text="Global points calculated as points × multiplier."
)

def clean(self):
    if self.multiplier_value <= 0:
        raise ValidationError("Multiplier value must be positive")

if not contribution_date:
    contribution_date = timezone.now()

multiplier = GlobalLeaderboardMultiplier.get_active_for_type(
    contribution_type,
    at_date=contribution_date
)