Implement hybrid filtering strategy for parks and rides

- Added comprehensive documentation for hybrid filtering implementation, including architecture, API endpoints, performance characteristics, and usage examples.
- Developed a hybrid pagination and client-side filtering recommendation, detailing server-side responsibilities and client-side logic.
- Created a test script for hybrid filtering endpoints, covering various test cases including basic filtering, search functionality, pagination, and edge cases.

backend/apps/parks/models/parks.py

@@ -124,6 +124,25 @@ class Park(TrackedModel):
     # Frontend URL
     url = models.URLField(blank=True, help_text="Frontend URL for this park")
 
+    # Computed fields for hybrid filtering
+    opening_year = models.IntegerField(
+        null=True, 
+        blank=True, 
+        db_index=True,
+        help_text="Year the park opened (computed from opening_date)"
+    )
+    search_text = models.TextField(
+        blank=True, 
+        db_index=True,
+        help_text="Searchable text combining name, description, location, and operator"
+    )
+    
+    # Timezone for park operations
+    timezone = models.CharField(
+        max_length=50,
+        help_text="Timezone identifier for park operations (e.g., 'America/New_York')"
+    )
+
     class Meta:
         ordering = ["name"]
         constraints = [
@@ -198,6 +217,9 @@ class Park(TrackedModel):
         frontend_domain = getattr(settings, "FRONTEND_DOMAIN", "https://thrillwiki.com")
         self.url = f"{frontend_domain}/parks/{self.slug}/"
 
+        # Populate computed fields for hybrid filtering
+        self._populate_computed_fields()
+
         # Save the model
         super().save(*args, **kwargs)
 
@@ -209,6 +231,44 @@ class Park(TrackedModel):
                 slug=old_slug,
             )
 
+    def _populate_computed_fields(self) -> None:
+        """Populate computed fields for hybrid filtering"""
+        # Populate opening_year from opening_date
+        if self.opening_date:
+            self.opening_year = self.opening_date.year
+        else:
+            self.opening_year = None
+        
+        # Populate search_text for client-side filtering
+        search_parts = [self.name]
+        
+        if self.description:
+            search_parts.append(self.description)
+        
+        # Add location information if available
+        try:
+            if hasattr(self, 'location') and self.location:
+                if self.location.city:
+                    search_parts.append(self.location.city)
+                if self.location.state:
+                    search_parts.append(self.location.state)
+                if self.location.country:
+                    search_parts.append(self.location.country)
+        except Exception:
+            # Handle case where location relationship doesn't exist yet
+            pass
+        
+        # Add operator information
+        if self.operator:
+            search_parts.append(self.operator.name)
+        
+        # Add property owner information if different
+        if self.property_owner and self.property_owner != self.operator:
+            search_parts.append(self.property_owner.name)
+        
+        # Combine all parts into searchable text
+        self.search_text = ' '.join(filter(None, search_parts)).lower()
+
     def clean(self):
         super().clean()
         if self.operator and "OPERATOR" not in self.operator.roles: