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/rides/views.py

@@ -5,7 +5,8 @@ from django.db.models import Q
 from django.contrib.auth.mixins import LoginRequiredMixin
 from django.http import HttpRequest, HttpResponse, Http404
 from django.db.models import Count
-from .models.rides import Ride, RideModel, Categories
+from .models.rides import Ride, RideModel
+from .choices import RIDE_CATEGORIES
 from .models.company import Company
 from .forms import RideForm, RideSearchForm
 from .forms.search import MasterFilterForm
@@ -276,7 +277,10 @@ class RideListView(ListView):
         # Add filter form
         filter_form = MasterFilterForm(self.request.GET)
         context["filter_form"] = filter_form
-        context["category_choices"] = Categories
+        # Use Rich Choice registry directly
+        from apps.core.choices.registry import get_choices
+        choices = get_choices("categories", "rides")
+        context["category_choices"] = [(choice.value, choice.label) for choice in choices]
 
         # Add filter summary for display
         if filter_form.is_valid():
@@ -324,7 +328,11 @@ class SingleCategoryListView(ListView):
         if hasattr(self, "park"):
             context["park"] = self.park
             context["park_slug"] = self.kwargs["park_slug"]
-        context["category"] = dict(Categories).get(self.kwargs["category"])
+        # Find the category choice by value using Rich Choice registry
+        from apps.core.choices.registry import get_choices
+        choices = get_choices("categories", "rides")
+        category_choice = next((choice for choice in choices if choice.value == self.kwargs["category"]), None)
+        context["category"] = category_choice.label if category_choice else "Unknown"
         return context
 
 
@@ -419,14 +427,16 @@ def get_search_suggestions(request: HttpRequest) -> HttpResponse:
             )
 
         # Add category matches
-        for code, name in Categories:
-            if query in name.lower():
-                ride_count = Ride.objects.filter(category=code).count()
+        from apps.core.choices.registry import get_choices
+        choices = get_choices("categories", "rides")
+        for choice in choices:
+            if query in choice.label.lower():
+                ride_count = Ride.objects.filter(category=choice.value).count()
                 suggestions.append(
                     {
                         "type": "category",
-                        "code": code,
-                        "text": name,
+                        "code": choice.value,
+                        "text": choice.label,
                         "count": ride_count,
                     }
                 )
@@ -517,7 +527,10 @@ class RideRankingsView(ListView):
     def get_context_data(self, **kwargs):
         """Add context for rankings view."""
         context = super().get_context_data(**kwargs)
-        context["category_choices"] = Categories
+        # Use Rich Choice registry directly
+        from apps.core.choices.registry import get_choices
+        choices = get_choices("categories", "rides")
+        context["category_choices"] = [(choice.value, choice.label) for choice in choices]
         context["selected_category"] = self.request.GET.get("category", "all")
         context["min_riders"] = self.request.GET.get("min_riders", "")