feat: Refactor rides app with unique constraints, mixins, and enhanced documentation

- Added migration to convert unique_together constraints to UniqueConstraint for RideModel.
- Introduced RideFormMixin for handling entity suggestions in ride forms.
- Created comprehensive code standards documentation outlining formatting, docstring requirements, complexity guidelines, and testing requirements.
- Established error handling guidelines with a structured exception hierarchy and best practices for API and view error handling.
- Documented view pattern guidelines, emphasizing the use of CBVs, FBVs, and ViewSets with examples.
- Implemented a benchmarking script for query performance analysis and optimization.
- Developed security documentation detailing measures, configurations, and a security checklist.
- Compiled a database optimization guide covering indexing strategies, query optimization patterns, and computed fields.

backend/apps/parks/managers.py

@@ -127,16 +127,17 @@ class ParkQuerySet(StatusQuerySet, ReviewableQuerySet, LocationQuerySet):
                 | Q(location__state__icontains=query)
             )
             .select_related("operator", "location")
-            .values(
-                "id",
-                "name",
-                "slug",
-                "location__city",
-                "location__state",
-                "operator__name",
+            .only(
+                "id", "name", "slug",
+                "location__city", "location__state",
+                "operator__name"
             )[:limit]
         )
 
+    def with_location(self):
+        """Always prefetch location for park queries."""
+        return self.select_related("operator").prefetch_related("location")
+
 
 class ParkManager(StatusManager, ReviewableManager, LocationManager):
     """Custom manager for Park model."""
@@ -162,6 +163,10 @@ class ParkManager(StatusManager, ReviewableManager, LocationManager):
     def for_map_display(self, *, bounds=None):
         return self.get_queryset().for_map_display(bounds=bounds)
 
+    def with_location(self):
+        """Always prefetch location for park queries."""
+        return self.get_queryset().with_location()
+
 
 class ParkAreaQuerySet(BaseQuerySet):
     """QuerySet for ParkArea model."""
@@ -300,3 +305,33 @@ class CompanyManager(BaseManager):
 
     def major_operators(self, *, min_parks: int = 5):
         return self.get_queryset().major_operators(min_parks=min_parks)
+
+    def manufacturers_with_ride_count(self):
+        """Get manufacturers with ride count annotation for list views."""
+        return (
+            self.get_queryset()
+            .manufacturers()
+            .annotate(ride_count=Count("manufactured_rides", distinct=True))
+            .only('id', 'name', 'slug', 'roles', 'description')
+            .order_by("name")
+        )
+
+    def designers_with_ride_count(self):
+        """Get designers with ride count annotation for list views."""
+        return (
+            self.get_queryset()
+            .filter(roles__contains=["DESIGNER"])
+            .annotate(ride_count=Count("designed_rides", distinct=True))
+            .only('id', 'name', 'slug', 'roles', 'description')
+            .order_by("name")
+        )
+
+    def operators_with_park_count(self):
+        """Get operators with park count annotation for list views."""
+        return (
+            self.get_queryset()
+            .operators()
+            .with_park_counts()
+            .only('id', 'name', 'slug', 'roles', 'description')
+            .order_by("name")
+        )