Refactor API structure and add comprehensive user management features

- Restructure API v1 with improved serializers organization
- Add user deletion requests and moderation queue system
- Implement bulk moderation operations and permissions
- Add user profile enhancements with display names and avatars
- Expand ride and park API endpoints with better filtering
- Add manufacturer API with detailed ride relationships
- Improve authentication flows and error handling
- Update frontend documentation and API specifications

backend/apps/api/v1/rides/serializers.py

@@ -5,42 +5,46 @@ This module contains serializers for ride-specific media functionality.
 """
 
 from rest_framework import serializers
-from drf_spectacular.utils import extend_schema_field, extend_schema_serializer, OpenApiExample
+from drf_spectacular.utils import (
+    extend_schema_field,
+    extend_schema_serializer,
+    OpenApiExample,
+)
 from apps.rides.models import Ride, RidePhoto
 
 
 @extend_schema_serializer(
     examples=[
         OpenApiExample(
-            name='Ride Photo with Cloudflare Images',
-            summary='Complete ride photo response',
-            description='Example response showing all fields including Cloudflare Images URLs and variants',
+            name="Ride Photo with Cloudflare Images",
+            summary="Complete ride photo response",
+            description="Example response showing all fields including Cloudflare Images URLs and variants",
             value={
-                'id': 123,
-                'image': 'https://imagedelivery.net/account-hash/abc123def456/public',
-                'image_url': 'https://imagedelivery.net/account-hash/abc123def456/public',
-                'image_variants': {
-                    'thumbnail': 'https://imagedelivery.net/account-hash/abc123def456/thumbnail',
-                    'medium': 'https://imagedelivery.net/account-hash/abc123def456/medium',
-                    'large': 'https://imagedelivery.net/account-hash/abc123def456/large',
-                    'public': 'https://imagedelivery.net/account-hash/abc123def456/public'
+                "id": 123,
+                "image": "https://imagedelivery.net/account-hash/abc123def456/public",
+                "image_url": "https://imagedelivery.net/account-hash/abc123def456/public",
+                "image_variants": {
+                    "thumbnail": "https://imagedelivery.net/account-hash/abc123def456/thumbnail",
+                    "medium": "https://imagedelivery.net/account-hash/abc123def456/medium",
+                    "large": "https://imagedelivery.net/account-hash/abc123def456/large",
+                    "public": "https://imagedelivery.net/account-hash/abc123def456/public",
                 },
-                'caption': 'Amazing roller coaster photo',
-                'alt_text': 'Steel roller coaster with multiple inversions',
-                'is_primary': True,
-                'is_approved': True,
-                'photo_type': 'exterior',
-                'created_at': '2023-01-01T12:00:00Z',
-                'updated_at': '2023-01-01T12:00:00Z',
-                'date_taken': '2023-01-01T10:00:00Z',
-                'uploaded_by_username': 'photographer123',
-                'file_size': 2048576,
-                'dimensions': [1920, 1080],
-                'ride_slug': 'steel-vengeance',
-                'ride_name': 'Steel Vengeance',
-                'park_slug': 'cedar-point',
-                'park_name': 'Cedar Point'
-            }
+                "caption": "Amazing roller coaster photo",
+                "alt_text": "Steel roller coaster with multiple inversions",
+                "is_primary": True,
+                "is_approved": True,
+                "photo_type": "exterior",
+                "created_at": "2023-01-01T12:00:00Z",
+                "updated_at": "2023-01-01T12:00:00Z",
+                "date_taken": "2023-01-01T10:00:00Z",
+                "uploaded_by_username": "photographer123",
+                "file_size": 2048576,
+                "dimensions": [1920, 1080],
+                "ride_slug": "steel-vengeance",
+                "ride_name": "Steel Vengeance",
+                "park_slug": "cedar-point",
+                "park_name": "Cedar Point",
+            },
         )
     ]
 )
@@ -78,8 +82,7 @@ class RidePhotoOutputSerializer(serializers.ModelSerializer):
 
     @extend_schema_field(
         serializers.URLField(
-            help_text="Full URL to the Cloudflare Images asset",
-            allow_null=True
+            help_text="Full URL to the Cloudflare Images asset", allow_null=True
         )
     )
     def get_image_url(self, obj):
@@ -91,7 +94,7 @@ class RidePhotoOutputSerializer(serializers.ModelSerializer):
     @extend_schema_field(
         serializers.DictField(
             child=serializers.URLField(),
-            help_text="Available Cloudflare Images variants with their URLs"
+            help_text="Available Cloudflare Images variants with their URLs",
         )
     )
     def get_image_variants(self, obj):
@@ -101,10 +104,10 @@ class RidePhotoOutputSerializer(serializers.ModelSerializer):
 
         # Common variants for ride photos
         variants = {
-            'thumbnail': f"{obj.image.url}/thumbnail",
-            'medium': f"{obj.image.url}/medium",
-            'large': f"{obj.image.url}/large",
-            'public': f"{obj.image.url}/public"
+            "thumbnail": f"{obj.image.url}/thumbnail",
+            "medium": f"{obj.image.url}/medium",
+            "large": f"{obj.image.url}/large",
+            "public": f"{obj.image.url}/public",
         }
         return variants