deploy to prod

backend/CLAUDE.md

@@ -66,6 +66,7 @@ backend/
 - **Models**: `contributions/models.py`
   - Contribution - Individual contribution records
   - ContributionType - Categories with slug field, has M2M `accepted_evidence_url_types`
+  - FeaturedContent - Portal hero/community/validator-steward content managed through admin
   - ContributionTypeMultiplier - Dynamic point multipliers
   - Evidence - Evidence items with `url_type` FK for auto-detected URL type, `normalized_url` indexed field for fast duplicate detection (text descriptions and URLs only - file uploads are disabled)
   - EvidenceURLType - Defines URL type categories (X Post, GitHub PR, etc.) with regex patterns for auto-detection and handle ownership validation
@@ -79,6 +80,12 @@ backend/
   - Custom DRF serializer field for Google reCAPTCHA v2 validation
   - Validates tokens from frontend reCAPTCHA widget
   - Required for new contribution submissions only (not for edits)
+
+### Projects
+- **Models**: `projects/models.py`
+  - Project - Project profile with website/GitHub links, description, usage notes, details, media, participants, and related accepted contributions
+  - ProjectMetric - Admin-managed title/value/detail metric rows for project pages
+  - ProjectPageRevision - Owner-submitted ordered page blocks rendered through whitelisted portal components
 - **AI Review**: `contributions/ai_review/views.py`
   - `/api/v1/ai-review/` - List pending submissions for the external AI review agent
   - `/api/v1/ai-review/{id}/` - Retrieve a pending submission with evidence and user history
@@ -261,6 +268,10 @@ GET    /api/v1/ai-review/templates/
 GET    /api/v1/partners/                   (public, list active partners)
 GET    /api/v1/partners/{slug}/            (public, partner detail)
 
+# Projects
+GET    /api/v1/projects/                   (public, active project profiles)
+GET    /api/v1/projects/{slug}/            (public, project detail with metrics and related contributions)
+
 # Gen TV
 GET    /api/v1/gen-tv/streams/             (public, supports ?category= filter)
 GET    /api/v1/gen-tv/streams/{slug}/      (public, stream detail)

backend/api/urls.py

@@ -4,6 +4,7 @@
 from contributions.views import ContributionTypeViewSet, ContributionViewSet, EvidenceViewSet, SubmittedContributionViewSet, StewardSubmissionViewSet, MissionViewSet, StartupRequestViewSet, FeaturedContentViewSet, AlertViewSet
 from leaderboard.views import GlobalLeaderboardMultiplierViewSet, LeaderboardViewSet
 from partners.views import PartnerViewSet
+from projects.views import ProjectViewSet
 from gen_tv.views import StreamCategoryViewSet, StreamViewSet
 from poaps.views import PoapDropViewSet
 from rest_framework_simplejwt.views import TokenObtainPairView, TokenRefreshView, TokenVerifyView
@@ -22,6 +23,7 @@
 router.register(r'missions', MissionViewSet, basename='mission')
 router.register(r'startup-requests', StartupRequestViewSet, basename='startup-request')
 router.register(r'featured', FeaturedContentViewSet, basename='featured')
+router.register(r'projects', ProjectViewSet, basename='project')
 router.register(r'alerts', AlertViewSet, basename='alert')
 router.register(r'partners', PartnerViewSet, basename='partner')
 router.register(r'gen-tv/streams', StreamViewSet, basename='stream')

backend/contributions/admin.py

@@ -1,4 +1,5 @@
 from django.contrib import admin
+from django import forms
 from django.core.management import call_command
 from django.contrib import messages
 from django.http import HttpResponseRedirect, JsonResponse
@@ -32,6 +33,27 @@
 NON_CAPACITY_STATES = ['rejected', 'canceled']
 
 
+class FeaturedContentAdminForm(forms.ModelForm):
+    hero_placements = forms.MultipleChoiceField(
+        choices=FeaturedContent.HERO_PLACEMENT_CHOICES,
+        required=False,
+        widget=forms.CheckboxSelectMultiple,
+        help_text=(
+            "For hero banners only. Select 'All hero surfaces' or choose one "
+            "or more specific surfaces."
+        ),
+    )
+
+    class Meta:
+        model = FeaturedContent
+        fields = '__all__'
+
+    def clean_hero_placements(self):
+        return FeaturedContent.normalize_hero_placements(
+            self.cleaned_data.get('hero_placements', [])
+        )
+
+
 def active_submission_count_subquery(fk_name):
     return SubmittedContribution.objects.exclude(
         state__in=NON_CAPACITY_STATES
@@ -851,6 +873,7 @@ def get_status(self, obj):
 
 @admin.register(FeaturedContent)
 class FeaturedContentAdmin(CloudinaryUploadMixin, admin.ModelAdmin):
+    form = FeaturedContentAdminForm
     cloudinary_upload_fields = {
         'hero_image_url': {
             'public_id_field': 'hero_image_public_id',
@@ -870,7 +893,7 @@ class FeaturedContentAdmin(CloudinaryUploadMixin, admin.ModelAdmin):
         },
     }
 
-    list_display = ('title', 'content_type', 'user', 'status', 'order', 'created_at')
+    list_display = ('title', 'content_type', 'display_hero_placements', 'user', 'status', 'order', 'created_at')
     list_filter = ('content_type', 'status', 'created_at')
     search_fields = ('title', 'description', 'user__name', 'user__address')
     list_editable = ('order', 'status')
@@ -882,7 +905,7 @@ class FeaturedContentAdmin(CloudinaryUploadMixin, admin.ModelAdmin):
 
     fieldsets = (
         (None, {
-            'fields': ('content_type', 'title', 'author', 'description', 'status', 'order')
+            'fields': ('content_type', 'title', 'author', 'description', 'hero_placements', 'status', 'order')
         }),
         ('Relations', {
             'fields': ('user', 'contribution')
@@ -898,6 +921,12 @@ class FeaturedContentAdmin(CloudinaryUploadMixin, admin.ModelAdmin):
         }),
     )
 
+    @admin.display(description='Hero placements')
+    def display_hero_placements(self, obj):
+        labels = dict(FeaturedContent.HERO_PLACEMENT_CHOICES)
+        placements = obj.hero_placements or []
+        return ', '.join(labels.get(placement, placement) for placement in placements) or '-'
+
 
 @admin.register(Alert)
 class AlertAdmin(admin.ModelAdmin):

backend/contributions/migrations/0061_featuredcontent_hero_placements.py

@@ -0,0 +1,26 @@
+# Generated by Django 6.0.5 on 2026-05-24
+
+import contributions.models
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('contributions', '0060_contributiontype_required_discord_roles'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='hero_placements',
+            field=models.JSONField(
+                blank=True,
+                default=contributions.models.default_featured_hero_placements,
+                help_text=(
+                    "Hero banner placements. Use 'all' to show everywhere, or select "
+                    "specific surfaces such as overview, builder, validator, and community."
+                ),
+            ),
+        ),
+    ]

backend/contributions/models.py

@@ -14,6 +14,10 @@
 logger = get_app_logger('contributions')
 
 
+def default_featured_hero_placements():
+    return ['overview', 'builder', 'community']
+
+
 class Category(BaseModel):
     """
     Defines a user category (Validator, Builder, Steward).
@@ -931,6 +935,7 @@ class FeaturedContent(BaseModel):
     """
     CONTENT_TYPE_CHOICES = [
         ('hero', 'Hero Banner'),
+        # Legacy portal builds are kept for compatibility; new project profiles live in projects.Project.
         ('build', 'Featured Build'),
         ('community', 'Featured Community'),
         ('validator_steward', 'Featured Validator/Steward'),
@@ -939,6 +944,14 @@ class FeaturedContent(BaseModel):
         ('active', 'Active'),
         ('idle', 'Idle'),
     ]
+    HERO_PLACEMENT_ALL = 'all'
+    HERO_PLACEMENT_CHOICES = [
+        (HERO_PLACEMENT_ALL, 'All hero surfaces'),
+        ('overview', 'Overview'),
+        ('builder', 'Builder dashboard'),
+        ('validator', 'Validator dashboard'),
+        ('community', 'Community dashboard'),
+    ]
     content_type = models.CharField(max_length=20, choices=CONTENT_TYPE_CHOICES)
     title = models.CharField(max_length=200)
     description = models.TextField(blank=True)
@@ -960,6 +973,14 @@ class FeaturedContent(BaseModel):
     user_profile_image_url = models.URLField(max_length=500, blank=True, help_text='Cloudinary URL for user profile image')
     user_profile_image_public_id = models.CharField(max_length=255, blank=True, help_text='Cloudinary public ID for user profile image')
     url = models.URLField(max_length=500, blank=True)
+    hero_placements = models.JSONField(
+        default=default_featured_hero_placements,
+        blank=True,
+        help_text=(
+            "Hero banner placements. Use 'all' to show everywhere, or select "
+            "specific surfaces such as overview, builder, validator, and community."
+        )
+    )
     status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='active')
     order = models.PositiveIntegerField(default=0)
 
@@ -974,6 +995,36 @@ def get_link(self):
             return f"/badge/{self.contribution_id}"
         return self.url or None
 
+    @classmethod
+    def normalize_hero_placements(cls, placements):
+        if not isinstance(placements, list):
+            return []
+        valid = {choice[0] for choice in cls.HERO_PLACEMENT_CHOICES}
+        normalized = []
+        for placement in placements:
+            if placement in valid and placement not in normalized:
+                normalized.append(placement)
+        if cls.HERO_PLACEMENT_ALL in normalized:
+            return [cls.HERO_PLACEMENT_ALL]
+        return normalized
+
+    def clean(self):
+        super().clean()
+        if not isinstance(self.hero_placements, list):
+            raise ValidationError({'hero_placements': 'Hero placements must be a list.'})
+
+        valid = {choice[0] for choice in self.HERO_PLACEMENT_CHOICES}
+        invalid = [placement for placement in self.hero_placements if placement not in valid]
+        if invalid:
+            raise ValidationError({
+                'hero_placements': f"Invalid hero placement value(s): {', '.join(invalid)}"
+            })
+        self.hero_placements = self.normalize_hero_placements(self.hero_placements)
+
+    def shows_in_placement(self, placement):
+        placements = self.normalize_hero_placements(self.hero_placements)
+        return self.HERO_PLACEMENT_ALL in placements or placement in placements
+
     @classmethod
     def get_active_by_type(cls, content_type, limit=10):
         return cls.objects.filter(

backend/contributions/serializers.py

@@ -93,9 +93,23 @@ class LightContributionSerializer(serializers.Serializer):
     contribution_date = serializers.DateTimeField(read_only=True)
     notes = serializers.CharField(read_only=True)
     title = serializers.CharField(read_only=True, allow_blank=True)
+    is_highlighted = serializers.SerializerMethodField()
+    highlight = serializers.SerializerMethodField()
     evidence_items = serializers.SerializerMethodField()
     created_at = serializers.DateTimeField(read_only=True)
 
+    def get_highlight(self, obj):
+        highlight = next(iter(obj.highlights.all()), None)
+        if not highlight:
+            return None
+        return {
+            'title': highlight.title,
+            'description': highlight.description,
+        }
+
+    def get_is_highlighted(self, obj):
+        return bool(self.get_highlight(obj))
+
     def get_evidence_items(self, obj):
         """Returns serialized evidence items for this contribution."""
         # ViewSet prefetches evidence_items to avoid N+1 queries
@@ -830,6 +844,39 @@ def validate(self, data):
         return data
 
 
+class StewardAcceptedSubmissionUpdateSerializer(serializers.Serializer):
+    """Serializer for correcting accepted submission awards."""
+    points = serializers.IntegerField(required=True, min_value=0)
+    create_highlight = serializers.BooleanField(default=False, required=False)
+    remove_highlight = serializers.BooleanField(default=False, required=False)
+    highlight_title = serializers.CharField(max_length=200, required=False, allow_blank=True)
+    highlight_description = serializers.CharField(required=False, allow_blank=True)
+
+    def validate(self, data):
+        contribution_type = self.context['contribution_type']
+        points = data['points']
+        if points < contribution_type.min_points or points > contribution_type.max_points:
+            raise serializers.ValidationError({
+                'points': f'Points must be between {contribution_type.min_points} and {contribution_type.max_points} for {contribution_type.name}.'
+            })
+
+        if data.get('create_highlight'):
+            if data.get('remove_highlight'):
+                raise serializers.ValidationError({
+                    'remove_highlight': 'Cannot remove and create a highlight in the same update.'
+                })
+            if not data.get('highlight_title'):
+                raise serializers.ValidationError({
+                    'highlight_title': 'Title is required when creating a highlight.'
+                })
+            if not data.get('highlight_description'):
+                raise serializers.ValidationError({
+                    'highlight_description': 'Description is required when creating a highlight.'
+                })
+
+        return data
+
+
 class SubmissionNoteSerializer(serializers.ModelSerializer):
     """Serializer for CRM notes on submissions."""
     user_name = serializers.SerializerMethodField()
@@ -981,10 +1028,37 @@ def get_evidence_items(self, obj):
         return EvidenceSerializer(evidence_items, many=True, context=self.context).data
 
     def get_contribution(self, obj):
-        if self.context.get('use_light_serializers', False):
-            return None
-
         if obj.converted_contribution:
+            if self.context.get('use_light_serializers', False):
+                contribution = obj.converted_contribution
+                highlight = next(iter(contribution.highlights.all()), None)
+                return {
+                    'id': contribution.id,
+                    'user': contribution.user_id,
+                    'user_details': LightUserSerializer(contribution.user).data,
+                    'contribution_type': contribution.contribution_type_id,
+                    'contribution_type_name': contribution.contribution_type.name,
+                    'contribution_type_min_points': contribution.contribution_type.min_points,
+                    'contribution_type_max_points': contribution.contribution_type.max_points,
+                    'contribution_type_details': LightContributionTypeSerializer(
+                        contribution.contribution_type
+                    ).data,
+                    'points': contribution.points,
+                    'frozen_global_points': contribution.frozen_global_points,
+                    'multiplier_at_creation': str(contribution.multiplier_at_creation) if contribution.multiplier_at_creation is not None else None,
+                    'contribution_date': contribution.contribution_date,
+                    'notes': contribution.notes,
+                    'title': contribution.title,
+                    'highlight': {
+                        'title': highlight.title,
+                        'description': highlight.description
+                    } if highlight else None,
+                    'is_highlighted': bool(highlight),
+                    'mission': LightMissionSerializer(contribution.mission).data if contribution.mission else None,
+                    'created_at': contribution.created_at,
+                    'updated_at': contribution.updated_at,
+                }
+
             from .models import ContributionHighlight
             contrib_context = self.context.copy()
             contrib_context['use_light_serializers'] = True
@@ -1168,6 +1242,7 @@ class Meta:
         model = FeaturedContent
         fields = ['id', 'content_type', 'title', 'description', 'author',
                   'hero_image_url', 'hero_image_url_tablet', 'hero_image_url_mobile',
+                  'hero_placements',
                   'url', 'link',
                   'user', 'user_name', 'user_address', 'user_profile_image_url',
                   'featured_profile_image_url',