feat: Implement MFA authentication, add ride statistics model, and update various services, APIs, and tests across the application.

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

@@ -5,12 +5,13 @@ This module contains serializers for park-specific media functionality.
 Enhanced from rogue implementation to maintain full feature parity.
 """
 
-from rest_framework import serializers
 from drf_spectacular.utils import (
+    OpenApiExample,
     extend_schema_field,
     extend_schema_serializer,
-    OpenApiExample,
 )
+from rest_framework import serializers
+
 from apps.parks.models import Park, ParkPhoto
 
 
@@ -235,7 +236,7 @@ class HybridParkSerializer(serializers.ModelSerializer):
     Enhanced serializer for hybrid filtering strategy.
     Includes all filterable fields for client-side filtering.
     """
-    
+
     # Location fields from related ParkLocation
     city = serializers.SerializerMethodField()
     state = serializers.SerializerMethodField()
@@ -243,19 +244,19 @@ class HybridParkSerializer(serializers.ModelSerializer):
     continent = serializers.SerializerMethodField()
     latitude = serializers.SerializerMethodField()
     longitude = serializers.SerializerMethodField()
-    
+
     # Company fields
     operator_name = serializers.CharField(source="operator.name", read_only=True)
     property_owner_name = serializers.CharField(source="property_owner.name", read_only=True, allow_null=True)
-    
+
     # Image URLs for display
     banner_image_url = serializers.SerializerMethodField()
     card_image_url = serializers.SerializerMethodField()
-    
+
     # Computed fields for filtering
     opening_year = serializers.IntegerField(read_only=True)
     search_text = serializers.CharField(read_only=True)
-    
+
     @extend_schema_field(serializers.CharField(allow_null=True))
     def get_city(self, obj):
         """Get city from related location."""
@@ -263,7 +264,7 @@ class HybridParkSerializer(serializers.ModelSerializer):
             return obj.location.city if hasattr(obj, 'location') and obj.location else None
         except AttributeError:
             return None
-    
+
     @extend_schema_field(serializers.CharField(allow_null=True))
     def get_state(self, obj):
         """Get state from related location."""
@@ -271,7 +272,7 @@ class HybridParkSerializer(serializers.ModelSerializer):
             return obj.location.state if hasattr(obj, 'location') and obj.location else None
         except AttributeError:
             return None
-    
+
     @extend_schema_field(serializers.CharField(allow_null=True))
     def get_country(self, obj):
         """Get country from related location."""
@@ -279,7 +280,7 @@ class HybridParkSerializer(serializers.ModelSerializer):
             return obj.location.country if hasattr(obj, 'location') and obj.location else None
         except AttributeError:
             return None
-    
+
     @extend_schema_field(serializers.CharField(allow_null=True))
     def get_continent(self, obj):
         """Get continent from related location."""
@@ -287,7 +288,7 @@ class HybridParkSerializer(serializers.ModelSerializer):
             return obj.location.continent if hasattr(obj, 'location') and obj.location else None
         except AttributeError:
             return None
-    
+
     @extend_schema_field(serializers.FloatField(allow_null=True))
     def get_latitude(self, obj):
         """Get latitude from related location."""
@@ -297,7 +298,7 @@ class HybridParkSerializer(serializers.ModelSerializer):
             return None
         except (AttributeError, IndexError, TypeError):
             return None
-    
+
     @extend_schema_field(serializers.FloatField(allow_null=True))
     def get_longitude(self, obj):
         """Get longitude from related location."""
@@ -307,14 +308,14 @@ class HybridParkSerializer(serializers.ModelSerializer):
             return None
         except (AttributeError, IndexError, TypeError):
             return None
-    
+
     @extend_schema_field(serializers.URLField(allow_null=True))
     def get_banner_image_url(self, obj):
         """Get banner image URL."""
         if obj.banner_image and obj.banner_image.image:
             return obj.banner_image.image.url
         return None
-    
+
     @extend_schema_field(serializers.URLField(allow_null=True))
     def get_card_image_url(self, obj):
         """Get card image URL."""
@@ -332,42 +333,42 @@ class HybridParkSerializer(serializers.ModelSerializer):
             "description",
             "status",
             "park_type",
-            
+
             # Dates and computed fields
             "opening_date",
             "closing_date",
             "opening_year",
             "operating_season",
-            
+
             # Location fields
             "city",
-            "state", 
+            "state",
             "country",
             "continent",
             "latitude",
             "longitude",
-            
+
             # Company relationships
             "operator_name",
             "property_owner_name",
-            
+
             # Statistics
             "size_acres",
             "average_rating",
             "ride_count",
             "coaster_count",
-            
+
             # Images
             "banner_image_url",
             "card_image_url",
-            
+
             # URLs
             "website",
             "url",
-            
+
             # Computed fields for filtering
             "search_text",
-            
+
             # Metadata
             "created_at",
             "updated_at",