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/models/company.py

@@ -7,20 +7,15 @@ from django.conf import settings
 
 from apps.core.history import HistoricalSlug
 from apps.core.models import TrackedModel
+from apps.core.choices.fields import RichChoiceField
 
 
 @pghistory.track()
 class Company(TrackedModel):
-    class CompanyRole(models.TextChoices):
-        MANUFACTURER = "MANUFACTURER", "Ride Manufacturer"
-        DESIGNER = "DESIGNER", "Ride Designer"
-        OPERATOR = "OPERATOR", "Park Operator"
-        PROPERTY_OWNER = "PROPERTY_OWNER", "Property Owner"
-
     name = models.CharField(max_length=255)
     slug = models.SlugField(max_length=255, unique=True)
     roles = ArrayField(
-        models.CharField(max_length=20, choices=CompanyRole.choices),
+        RichChoiceField(choice_group="company_roles", domain="rides", max_length=20),
         default=list,
         blank=True,
     )
@@ -64,7 +59,6 @@ class Company(TrackedModel):
     def get_absolute_url(self):
         # This will need to be updated to handle different roles
         return reverse("companies:detail", kwargs={"slug": self.slug})
-        return "#"
 
     @classmethod
     def get_by_slug(cls, slug):
@@ -73,14 +67,19 @@ class Company(TrackedModel):
             return cls.objects.get(slug=slug), False
         except cls.DoesNotExist:
             # Check pghistory first
-            history_model = cls.get_history_model()
-            history_entry = (
-                history_model.objects.filter(slug=slug)
-                .order_by("-pgh_created_at")
-                .first()
-            )
-            if history_entry:
-                return cls.objects.get(id=history_entry.pgh_obj_id), True
+            try:
+                from django.apps import apps
+                history_model = apps.get_model('rides', f'{cls.__name__}Event')
+                history_entry = (
+                    history_model.objects.filter(slug=slug)
+                    .order_by("-pgh_created_at")
+                    .first()
+                )
+                if history_entry:
+                    return cls.objects.get(id=history_entry.pgh_obj_id), True
+            except LookupError:
+                # History model doesn't exist, skip pghistory check
+                pass
 
             # Check manual slug history as fallback
             try:
@@ -91,7 +90,7 @@ class Company(TrackedModel):
             except (HistoricalSlug.DoesNotExist, cls.DoesNotExist):
                 raise cls.DoesNotExist("No company found with this slug")
 
-    class Meta:
+    class Meta(TrackedModel.Meta):
         app_label = "rides"
         ordering = ["name"]
         verbose_name_plural = "Companies"