Convert featured content images from local storage to Cloudinary

The FeaturedContent model previously used Django ImageField for local file
storage, inconsistent with the rest of the project which uses Cloudinary.
All image fields now use URLField + public_id CharField, matching the
User model pattern.

## Claude Implementation Notes
- backend/contributions/models.py: Replace 4 ImageFields with URLField + public_id pairs (hero, tablet, mobile, avatar)
- backend/contributions/serializers.py: Remove SerializerMethodField helpers, read URL fields directly from model
- backend/contributions/admin.py: Show URL fields instead of file uploads, public_ids as read-only collapsed section
- backend/contributions/management/commands/seed_featured_content.py: Remove local file copy logic, simplified to just create records
- backend/contributions/migrations/0040_convert_featured_images_to_cloudinary.py: Migration for the field conversion

Author: rasca

backend/contributions/admin.py

@@ -683,7 +683,9 @@ class FeaturedContentAdmin(admin.ModelAdmin):
     search_fields = ('title', 'description', 'user__name', 'user__address')
     list_editable = ('order', 'is_active')
     raw_id_fields = ('user', 'contribution')
-    readonly_fields = ('created_at', 'updated_at')
+    readonly_fields = ('created_at', 'updated_at', 'hero_image_public_id',
+                       'hero_image_tablet_public_id', 'hero_image_mobile_public_id',
+                       'user_profile_image_public_id')
     ordering = ('order', '-created_at')
 
     fieldsets = (
@@ -694,8 +696,15 @@ class FeaturedContentAdmin(admin.ModelAdmin):
             'fields': ('user', 'contribution')
         }),
         ('Links & Media', {
-            'fields': ('hero_image', 'hero_image_tablet', 'hero_image_mobile', 'user_profile_image', 'url'),
-            'description': 'Upload images directly. Django serves them from the media directory. Tablet/mobile hero images are optional — falls back to the main hero image.'
+            'fields': ('hero_image_url', 'hero_image_url_tablet', 'hero_image_url_mobile',
+                       'user_profile_image_url', 'url'),
+            'description': 'Paste Cloudinary URLs for images. Tablet/mobile hero images are optional — falls back to the main hero image.'
+        }),
+        ('Cloudinary Metadata', {
+            'fields': ('hero_image_public_id', 'hero_image_tablet_public_id',
+                       'hero_image_mobile_public_id', 'user_profile_image_public_id'),
+            'classes': ('collapse',),
+            'description': 'Auto-managed Cloudinary public IDs (read-only)'
         }),
         ('Metadata', {
             'fields': ('created_at', 'updated_at'),

backend/contributions/management/commands/seed_featured_content.py

@@ -1,7 +1,3 @@
-import os
-import shutil
-
-from django.conf import settings
 from django.core.management.base import BaseCommand
 from django.contrib.auth import get_user_model
 from contributions.models import FeaturedContent
@@ -12,30 +8,7 @@
 class Command(BaseCommand):
     help = 'Seeds FeaturedContent entries for the portal home page (hero banner and featured builds).'
 
-    def _copy_to_media(self, source_path, relative_dest):
-        """
-        Copy a file to MEDIA_ROOT if it doesn't already exist at the destination.
-        Returns the relative path within MEDIA_ROOT, or None if the source doesn't exist.
-        """
-        if not os.path.exists(source_path):
-            self.stdout.write(self.style.WARNING(f"    Image not found: {source_path}"))
-            return None
-
-        dest_path = os.path.join(settings.MEDIA_ROOT, relative_dest)
-        dest_dir = os.path.dirname(dest_path)
-        os.makedirs(dest_dir, exist_ok=True)
-
-        if not os.path.exists(dest_path):
-            shutil.copy2(source_path, dest_path)
-            self.stdout.write(self.style.SUCCESS(f"    Copied: {relative_dest}"))
-        else:
-            self.stdout.write(f"    Already exists: {relative_dest}")
-
-        return relative_dest
-
     def handle(self, *args, **options):
-        media_root = settings.MEDIA_ROOT
-
         # ----------------------------------------------------------------
         # 1.  Ensure users exist (get_or_create with dummy email/address)
         # ----------------------------------------------------------------
@@ -76,29 +49,19 @@ def handle(self, *args, **options):
         # ----------------------------------------------------------------
         # 2.  Hero banner
         # ----------------------------------------------------------------
-        hero_defaults = {
-            'description': 'Deploy intelligent contracts, run validators, and earn GenLayer Points on the latest testnet.',
-            'author': 'cognocracy',
-            'user': users['cognocracy'],
-            'url': '',
-            'is_active': True,
-            'order': 0,
-        }
-
         obj, created = FeaturedContent.objects.update_or_create(
             content_type='hero',
             title='Argue.fun Launch',
-            defaults=hero_defaults,
+            defaults={
+                'description': 'Deploy intelligent contracts, run validators, and earn GenLayer Points on the latest testnet.',
+                'author': 'cognocracy',
+                'user': users['cognocracy'],
+                'url': '',
+                'is_active': True,
+                'order': 0,
+            },
         )
 
-        # Copy hero image to media directory
-        hero_source = os.path.join(media_root, 'featured', 'hero-bg.png')
-        hero_rel = 'featured/hero-bg.png'
-        result = self._copy_to_media(hero_source, hero_rel)
-        if result:
-            obj.hero_image = result
-            obj.save()
-
         self.stdout.write(
             self.style.SUCCESS(f"  {'Created' if created else 'Updated'} hero: {obj.title}")
         )
@@ -110,30 +73,18 @@ def handle(self, *args, **options):
             {
                 'title': 'Argue.fun',
                 'user': users['cognocracy'],
-                'hero_image_source': os.path.join(media_root, 'featured', 'argue-fun-bg.jpg'),
-                'hero_image_rel': 'featured/argue-fun-bg.jpg',
-                'avatar_source': os.path.join(media_root, 'featured', 'avatars', 'cognocracy-avatar.png'),
-                'avatar_rel': 'featured/avatars/cognocracy-avatar.png',
                 'url': '',
                 'order': 0,
             },
             {
                 'title': 'Internet Court',
                 'user': users['raskovsky'],
-                'hero_image_source': os.path.join(media_root, 'featured', 'internet-court-bg.jpg'),
-                'hero_image_rel': 'featured/internet-court-bg.jpg',
-                'avatar_source': os.path.join(media_root, 'featured', 'avatars', 'raskovsky-avatar.png'),
-                'avatar_rel': 'featured/avatars/raskovsky-avatar.png',
                 'url': '',
                 'order': 1,
             },
             {
                 'title': 'Rally',
                 'user': users['GenLayer'],
-                'hero_image_source': os.path.join(media_root, 'featured', 'rally-bg.jpg'),
-                'hero_image_rel': 'featured/rally-bg.jpg',
-                'avatar_source': os.path.join(media_root, 'featured', 'avatars', 'genlayer-avatar.png'),
-                'avatar_rel': 'featured/avatars/genlayer-avatar.png',
                 'url': '',
                 'order': 2,
             },
@@ -153,25 +104,9 @@ def handle(self, *args, **options):
                 },
             )
 
-            updated = False
-
-            # Copy hero image to media directory
-            result = self._copy_to_media(build['hero_image_source'], build['hero_image_rel'])
-            if result:
-                obj.hero_image = result
-                updated = True
-
-            # Copy avatar to media directory
-            result = self._copy_to_media(build['avatar_source'], build['avatar_rel'])
-            if result:
-                obj.user_profile_image = result
-                updated = True
-
-            if updated:
-                obj.save()
-
             self.stdout.write(
                 self.style.SUCCESS(f"  {'Created' if created else 'Updated'} build: {obj.title}")
             )
 
         self.stdout.write(self.style.SUCCESS('\nFeatured content seeded successfully.'))
+        self.stdout.write('Note: Upload images via Django admin or set hero_image_url / user_profile_image_url directly.')

backend/contributions/migrations/0040_convert_featured_images_to_cloudinary.py

@@ -0,0 +1,69 @@
+# Generated by Django 6.0.3 on 2026-03-16 18:40
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('contributions', '0039_add_responsive_hero_images'),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name='featuredcontent',
+            name='hero_image',
+        ),
+        migrations.RemoveField(
+            model_name='featuredcontent',
+            name='hero_image_mobile',
+        ),
+        migrations.RemoveField(
+            model_name='featuredcontent',
+            name='hero_image_tablet',
+        ),
+        migrations.RemoveField(
+            model_name='featuredcontent',
+            name='user_profile_image',
+        ),
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='hero_image_mobile_public_id',
+            field=models.CharField(blank=True, help_text='Cloudinary public ID for mobile hero image', max_length=255),
+        ),
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='hero_image_public_id',
+            field=models.CharField(blank=True, help_text='Cloudinary public ID for hero image', max_length=255),
+        ),
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='hero_image_tablet_public_id',
+            field=models.CharField(blank=True, help_text='Cloudinary public ID for tablet hero image', max_length=255),
+        ),
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='hero_image_url',
+            field=models.URLField(blank=True, help_text='Cloudinary URL for hero image', max_length=500),
+        ),
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='hero_image_url_mobile',
+            field=models.URLField(blank=True, help_text='Cloudinary URL for mobile hero image (<768px). Falls back to hero_image_url if empty.', max_length=500),
+        ),
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='hero_image_url_tablet',
+            field=models.URLField(blank=True, help_text='Cloudinary URL for tablet hero image (768-1023px). Falls back to hero_image_url if empty.', max_length=500),
+        ),
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='user_profile_image_public_id',
+            field=models.CharField(blank=True, help_text='Cloudinary public ID for user profile image', max_length=255),
+        ),
+        migrations.AddField(
+            model_name='featuredcontent',
+            name='user_profile_image_url',
+            field=models.URLField(blank=True, help_text='Cloudinary URL for user profile image', max_length=500),
+        ),
+    ]

backend/contributions/models.py

@@ -663,10 +663,14 @@ class FeaturedContent(BaseModel):
         settings.AUTH_USER_MODEL, on_delete=models.CASCADE,
         related_name='featured_items'
     )
-    hero_image = models.ImageField(upload_to='featured/', blank=True, null=True)
-    hero_image_tablet = models.ImageField(upload_to='featured/', blank=True, null=True, help_text='Tablet variant (768-1023px). Falls back to hero_image if empty.')
-    hero_image_mobile = models.ImageField(upload_to='featured/', blank=True, null=True, help_text='Mobile variant (<768px). Falls back to hero_image if empty.')
-    user_profile_image = models.ImageField(upload_to='featured/avatars/', blank=True, null=True)
+    hero_image_url = models.URLField(max_length=500, blank=True, help_text='Cloudinary URL for hero image')
+    hero_image_public_id = models.CharField(max_length=255, blank=True, help_text='Cloudinary public ID for hero image')
+    hero_image_url_tablet = models.URLField(max_length=500, blank=True, help_text='Cloudinary URL for tablet hero image (768-1023px). Falls back to hero_image_url if empty.')
+    hero_image_tablet_public_id = models.CharField(max_length=255, blank=True, help_text='Cloudinary public ID for tablet hero image')
+    hero_image_url_mobile = models.URLField(max_length=500, blank=True, help_text='Cloudinary URL for mobile hero image (<768px). Falls back to hero_image_url if empty.')
+    hero_image_mobile_public_id = models.CharField(max_length=255, blank=True, help_text='Cloudinary public ID for mobile hero image')
+    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)
     is_active = models.BooleanField(default=True)
     order = models.PositiveIntegerField(default=0)

backend/contributions/serializers.py

@@ -722,9 +722,6 @@ class FeaturedContentSerializer(serializers.ModelSerializer):
     user_name = serializers.CharField(source='user.name', read_only=True)
     user_address = serializers.CharField(source='user.address', read_only=True)
     user_profile_image_url = serializers.SerializerMethodField()
-    hero_image_url = serializers.SerializerMethodField()
-    hero_image_url_tablet = serializers.SerializerMethodField()
-    hero_image_url_mobile = serializers.SerializerMethodField()
     link = serializers.SerializerMethodField()
 
     class Meta:
@@ -735,31 +732,10 @@ class Meta:
                   'user', 'user_name', 'user_address', 'user_profile_image_url',
                   'contribution', 'is_active', 'order', 'created_at']
 
-    def _build_image_url(self, image_field):
-        """Return absolute URL for an image field if set."""
-        if image_field:
-            request = self.context.get('request')
-            if request:
-                return request.build_absolute_uri(image_field.url)
-            return image_field.url
-        return ''
-
-    def get_hero_image_url(self, obj):
-        return self._build_image_url(obj.hero_image)
-
-    def get_hero_image_url_tablet(self, obj):
-        return self._build_image_url(obj.hero_image_tablet)
-
-    def get_hero_image_url_mobile(self, obj):
-        return self._build_image_url(obj.hero_image_mobile)
-
     def get_user_profile_image_url(self, obj):
-        """Return the FeaturedContent's user_profile_image if set, otherwise fall back to user's profile_image_url."""
-        if obj.user_profile_image:
-            request = self.context.get('request')
-            if request:
-                return request.build_absolute_uri(obj.user_profile_image.url)
-            return obj.user_profile_image.url
+        """Return the FeaturedContent's user_profile_image_url if set, otherwise fall back to user's profile_image_url."""
+        if obj.user_profile_image_url:
+            return obj.user_profile_image_url
         if obj.user and obj.user.profile_image_url:
             return obj.user.profile_image_url
         return ''