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/serializers/reviews.py

@@ -10,16 +10,17 @@ from apps.accounts.models import User
 
 class ReviewUserSerializer(serializers.ModelSerializer):
     """Serializer for user information in reviews."""
+
     avatar_url = serializers.SerializerMethodField()
     display_name = serializers.SerializerMethodField()
 
     class Meta:
         model = User
-        fields = ['username', 'display_name', 'avatar_url']
+        fields = ["username", "display_name", "avatar_url"]
 
     def get_avatar_url(self, obj):
         """Get the user's avatar URL."""
-        if hasattr(obj, 'profile') and obj.profile:
+        if hasattr(obj, "profile") and obj.profile:
             return obj.profile.get_avatar()
         return "/static/images/default-avatar.png"
 
@@ -30,6 +31,7 @@ class ReviewUserSerializer(serializers.ModelSerializer):
 
 class LatestReviewSerializer(serializers.Serializer):
     """Serializer for latest reviews combining park and ride reviews."""
+
     id = serializers.IntegerField()
     type = serializers.CharField()  # 'park' or 'ride'
     title = serializers.CharField()
@@ -52,35 +54,35 @@ class LatestReviewSerializer(serializers.Serializer):
         """Convert review instance to serialized representation."""
         if isinstance(instance, ParkReview):
             return {
-                'id': instance.pk,
-                'type': 'park',
-                'title': instance.title,
-                'content_snippet': self._get_content_snippet(instance.content),
-                'rating': instance.rating,
-                'created_at': instance.created_at,
-                'user': ReviewUserSerializer(instance.user).data,
-                'subject_name': instance.park.name,
-                'subject_slug': instance.park.slug,
-                'subject_url': f"/parks/{instance.park.slug}/",
-                'park_name': None,
-                'park_slug': None,
-                'park_url': None,
+                "id": instance.pk,
+                "type": "park",
+                "title": instance.title,
+                "content_snippet": self._get_content_snippet(instance.content),
+                "rating": instance.rating,
+                "created_at": instance.created_at,
+                "user": ReviewUserSerializer(instance.user).data,
+                "subject_name": instance.park.name,
+                "subject_slug": instance.park.slug,
+                "subject_url": f"/parks/{instance.park.slug}/",
+                "park_name": None,
+                "park_slug": None,
+                "park_url": None,
             }
         elif isinstance(instance, RideReview):
             return {
-                'id': instance.pk,
-                'type': 'ride',
-                'title': instance.title,
-                'content_snippet': self._get_content_snippet(instance.content),
-                'rating': instance.rating,
-                'created_at': instance.created_at,
-                'user': ReviewUserSerializer(instance.user).data,
-                'subject_name': instance.ride.name,
-                'subject_slug': instance.ride.slug,
-                'subject_url': f"/parks/{instance.ride.park.slug}/rides/{instance.ride.slug}/",
-                'park_name': instance.ride.park.name,
-                'park_slug': instance.ride.park.slug,
-                'park_url': f"/parks/{instance.ride.park.slug}/",
+                "id": instance.pk,
+                "type": "ride",
+                "title": instance.title,
+                "content_snippet": self._get_content_snippet(instance.content),
+                "rating": instance.rating,
+                "created_at": instance.created_at,
+                "user": ReviewUserSerializer(instance.user).data,
+                "subject_name": instance.ride.name,
+                "subject_slug": instance.ride.slug,
+                "subject_url": f"/parks/{instance.ride.park.slug}/rides/{instance.ride.slug}/",
+                "park_name": instance.ride.park.name,
+                "park_slug": instance.ride.park.slug,
+                "park_url": f"/parks/{instance.ride.park.slug}/",
             }
         return {}
 
@@ -91,7 +93,7 @@ class LatestReviewSerializer(serializers.Serializer):
 
         # Find the last complete word within the limit
         snippet = content[:max_length]
-        last_space = snippet.rfind(' ')
+        last_space = snippet.rfind(" ")
         if last_space > 0:
             snippet = snippet[:last_space]