Add comprehensive API documentation for ThrillWiki integration and features

- Introduced Next.js integration guide for ThrillWiki API, detailing authentication, core domain APIs, data structures, and implementation patterns.
- Documented the migration to Rich Choice Objects, highlighting changes for frontend developers and enhanced metadata availability.
- Fixed the missing `get_by_slug` method in the Ride model, ensuring proper functionality of ride detail endpoints.
- Created a test script to verify manufacturer syncing with ride models, ensuring data integrity across related models.

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

@@ -13,6 +13,7 @@ from drf_spectacular.utils import (
 )
 from config.django import base as settings
 from .shared import ModelChoices
+from apps.core.choices.serializers import RichChoiceFieldSerializer
 
 
 # === RIDE SERIALIZERS ===
@@ -24,6 +25,12 @@ class RideParkOutputSerializer(serializers.Serializer):
     id = serializers.IntegerField()
     name = serializers.CharField()
     slug = serializers.CharField()
+    url = serializers.SerializerMethodField()
+
+    @extend_schema_field(serializers.URLField())
+    def get_url(self, obj) -> str:
+        """Generate the frontend URL for this park."""
+        return f"{settings.FRONTEND_DOMAIN}/parks/{obj.slug}/"
 
 
 class RideModelOutputSerializer(serializers.Serializer):
@@ -73,8 +80,14 @@ class RideListOutputSerializer(serializers.Serializer):
     id = serializers.IntegerField()
     name = serializers.CharField()
     slug = serializers.CharField()
-    category = serializers.CharField()
-    status = serializers.CharField()
+    category = RichChoiceFieldSerializer(
+        choice_group="categories",
+        domain="rides"
+    )
+    status = RichChoiceFieldSerializer(
+        choice_group="statuses",
+        domain="rides"
+    )
     description = serializers.CharField()
 
     # Park info
@@ -164,9 +177,19 @@ class RideDetailOutputSerializer(serializers.Serializer):
     id = serializers.IntegerField()
     name = serializers.CharField()
     slug = serializers.CharField()
-    category = serializers.CharField()
-    status = serializers.CharField()
-    post_closing_status = serializers.CharField(allow_null=True)
+    category = RichChoiceFieldSerializer(
+        choice_group="categories",
+        domain="rides"
+    )
+    status = RichChoiceFieldSerializer(
+        choice_group="statuses",
+        domain="rides"
+    )
+    post_closing_status = RichChoiceFieldSerializer(
+        choice_group="post_closing_statuses",
+        domain="rides",
+        allow_null=True
+    )
     description = serializers.CharField()
 
     # Park info
@@ -449,10 +472,10 @@ class RideCreateInputSerializer(serializers.Serializer):
 
     name = serializers.CharField(max_length=255)
     description = serializers.CharField(allow_blank=True, default="")
-    category = serializers.ChoiceField(choices=[])  # Choices set dynamically
+    category = serializers.ChoiceField(choices=ModelChoices.get_ride_category_choices())
     status = serializers.ChoiceField(
-        choices=[], default="OPERATING"
-    )  # Choices set dynamically
+        choices=ModelChoices.get_ride_status_choices(), default="OPERATING"
+    )
 
     # Required park
     park_id = serializers.IntegerField()
@@ -531,11 +554,11 @@ class RideUpdateInputSerializer(serializers.Serializer):
     name = serializers.CharField(max_length=255, required=False)
     description = serializers.CharField(allow_blank=True, required=False)
     category = serializers.ChoiceField(
-        choices=[], required=False
-    )  # Choices set dynamically
+        choices=ModelChoices.get_ride_category_choices(), required=False
+    )
     status = serializers.ChoiceField(
-        choices=[], required=False
-    )  # Choices set dynamically
+        choices=ModelChoices.get_ride_status_choices(), required=False
+    )
     post_closing_status = serializers.ChoiceField(
         choices=ModelChoices.get_ride_post_closing_choices(),
         required=False,
@@ -603,13 +626,13 @@ class RideFilterInputSerializer(serializers.Serializer):
 
     # Category filter
     category = serializers.MultipleChoiceField(
-        choices=[], required=False
-    )  # Choices set dynamically
+        choices=ModelChoices.get_ride_category_choices(), required=False
+    )
 
     # Status filter
     status = serializers.MultipleChoiceField(
-        choices=[],
-        required=False,  # Choices set dynamically
+        choices=ModelChoices.get_ride_status_choices(),
+        required=False,
     )
 
     # Park filter
@@ -695,12 +718,21 @@ class RollerCoasterStatsOutputSerializer(serializers.Serializer):
     inversions = serializers.IntegerField()
     ride_time_seconds = serializers.IntegerField(allow_null=True)
     track_type = serializers.CharField()
-    track_material = serializers.CharField()
-    roller_coaster_type = serializers.CharField()
+    track_material = RichChoiceFieldSerializer(
+        choice_group="track_materials",
+        domain="rides"
+    )
+    roller_coaster_type = RichChoiceFieldSerializer(
+        choice_group="coaster_types",
+        domain="rides"
+    )
     max_drop_height_ft = serializers.DecimalField(
         max_digits=6, decimal_places=2, allow_null=True
     )
-    launch_type = serializers.CharField()
+    launch_type = RichChoiceFieldSerializer(
+        choice_group="launch_systems",
+        domain="rides"
+    )
     train_style = serializers.CharField()
     trains_count = serializers.IntegerField(allow_null=True)
     cars_per_train = serializers.IntegerField(allow_null=True)