feat: Implement ride management views and utility functions

- Added functions for checking user privileges, handling photo uploads, preparing form data, and managing form errors.
- Created views for listing, creating, updating, and displaying rides, including category-specific views.
- Integrated submission handling for ride changes and improved user feedback through messages.
- Enhanced data handling with appropriate context and queryset management for better performance and usability.

analytics/__init__.py

@@ -0,0 +1 @@
+default_app_config = 'analytics.apps.AnalyticsConfig'

analytics/admin.py

@@ -0,0 +1,3 @@
+from django.contrib import admin
+
+# Register your models here.

analytics/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+class AnalyticsConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'analytics'

analytics/management/commands/update_trending.py

@@ -0,0 +1,34 @@
+from django.core.management.base import BaseCommand
+from django.core.cache import cache
+from parks.models import Park
+from rides.models import Ride
+from analytics.models import PageView
+
+class Command(BaseCommand):
+    help = 'Updates trending parks and rides cache based on views in the last 24 hours'
+
+    def handle(self, *args, **kwargs):
+        """
+        Updates the trending parks and rides in the cache.
+        
+        This command is designed to be run every hour via cron to keep the trending
+        items up to date. It looks at page views from the last 24 hours and caches
+        the top 10 most viewed parks and rides.
+        
+        The cached data is used by the home page to display trending items without
+        having to query the database on every request.
+        """
+        # Get top 10 trending parks and rides from the last 24 hours
+        trending_parks = PageView.get_trending_items(Park, hours=24, limit=10)
+        trending_rides = PageView.get_trending_items(Ride, hours=24, limit=10)
+
+        # Cache the results for 1 hour
+        cache.set('trending_parks', trending_parks, 3600)  # 3600 seconds = 1 hour
+        cache.set('trending_rides', trending_rides, 3600)
+
+        self.stdout.write(
+            self.style.SUCCESS(
+                'Successfully updated trending parks and rides. '
+                'Cached 10 items each for parks and rides based on views in the last 24 hours.'
+            )
+        )

analytics/middleware.py

@@ -0,0 +1,39 @@
+from django.utils.deprecation import MiddlewareMixin
+from django.contrib.contenttypes.models import ContentType
+from django.views.generic.detail import DetailView
+from .models import PageView
+
+class PageViewMiddleware(MiddlewareMixin):
+    def process_view(self, request, view_func, view_args, view_kwargs):
+        # Only track GET requests
+        if request.method != 'GET':
+            return None
+
+        # Get view class if it exists
+        view_class = getattr(view_func, 'view_class', None)
+        if not view_class or not issubclass(view_class, DetailView):
+            return None
+
+        # Get the object if it's a detail view
+        try:
+            view_instance = view_class()
+            view_instance.request = request
+            view_instance.args = view_args
+            view_instance.kwargs = view_kwargs
+            obj = view_instance.get_object()
+        except (AttributeError, Exception):
+            return None
+
+        # Record the page view
+        try:
+            PageView.objects.create(
+                content_type=ContentType.objects.get_for_model(obj.__class__),
+                object_id=obj.pk,
+                ip_address=request.META.get('REMOTE_ADDR', ''),
+                user_agent=request.META.get('HTTP_USER_AGENT', '')[:512]
+            )
+        except Exception:
+            # Fail silently to not interrupt the request
+            pass
+
+        return None

analytics/migrations/0001_initial.py

@@ -0,0 +1,53 @@
+# Generated by Django 5.1.2 on 2024-11-04 00:46
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ("contenttypes", "0002_remove_content_type_name"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="PageView",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("object_id", models.PositiveIntegerField()),
+                ("timestamp", models.DateTimeField(auto_now_add=True, db_index=True)),
+                ("ip_address", models.GenericIPAddressField()),
+                ("user_agent", models.CharField(blank=True, max_length=512)),
+                (
+                    "content_type",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="page_views",
+                        to="contenttypes.contenttype",
+                    ),
+                ),
+            ],
+            options={
+                "indexes": [
+                    models.Index(
+                        fields=["timestamp"], name="analytics_p_timesta_835321_idx"
+                    ),
+                    models.Index(
+                        fields=["content_type", "object_id"],
+                        name="analytics_p_content_73920a_idx",
+                    ),
+                ],
+            },
+        ),
+    ]

analytics/models.py

@@ -0,0 +1,57 @@
+from django.db import models
+from django.contrib.contenttypes.fields import GenericForeignKey
+from django.contrib.contenttypes.models import ContentType
+from django.utils import timezone
+from django.db.models import Count
+from django.conf import settings
+
+class PageView(models.Model):
+    content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE, related_name='page_views')
+    object_id = models.PositiveIntegerField()
+    content_object = GenericForeignKey('content_type', 'object_id')
+    
+    timestamp = models.DateTimeField(auto_now_add=True, db_index=True)
+    ip_address = models.GenericIPAddressField()
+    user_agent = models.CharField(max_length=512, blank=True)
+
+    class Meta:
+        indexes = [
+            models.Index(fields=['timestamp']),
+            models.Index(fields=['content_type', 'object_id']),
+        ]
+
+    @classmethod
+    def get_trending_items(cls, model_class, hours=24, limit=10):
+        """Get trending items of a specific model class based on views in last X hours.
+        
+        Args:
+            model_class: The model class to get trending items for (e.g., Park, Ride)
+            hours (int): Number of hours to look back for views (default: 24)
+            limit (int): Maximum number of items to return (default: 10)
+        
+        Returns:
+            QuerySet: The trending items ordered by view count
+        """
+        content_type = ContentType.objects.get_for_model(model_class)
+        cutoff = timezone.now() - timezone.timedelta(hours=hours)
+        
+        # Query through the ContentType relationship
+        item_ids = cls.objects.filter(
+            content_type=content_type,
+            timestamp__gte=cutoff
+        ).values('object_id').annotate(
+            view_count=Count('id')
+        ).filter(
+            view_count__gt=0
+        ).order_by('-view_count').values_list('object_id', flat=True)[:limit]
+
+        # Get the actual items in the correct order
+        if item_ids:
+            # Convert the list to a string of comma-separated values
+            id_list = list(item_ids)
+            # Use Case/When to preserve the ordering
+            from django.db.models import Case, When
+            preserved = Case(*[When(pk=pk, then=pos) for pos, pk in enumerate(id_list)])
+            return model_class.objects.filter(pk__in=id_list).order_by(preserved)
+        
+        return model_class.objects.none()

analytics/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

analytics/views.py

@@ -0,0 +1,3 @@
+from django.shortcuts import render
+
+# Create your views here.