feat: Implement Entity Suggestion Manager and Modal components

- Added EntitySuggestionManager.vue to manage entity suggestions and authentication.
- Created EntitySuggestionModal.vue for displaying suggestions and adding new entities.
- Integrated AuthManager for user authentication within the suggestion modal.
- Enhanced signal handling in start-servers.sh for graceful shutdown of servers.
- Improved server startup script to ensure proper cleanup and responsiveness to termination signals.
- Added documentation for signal handling fixes and usage instructions.

backend/apps/rides/admin.py

@@ -5,6 +5,7 @@ from .models.company import Company
 from .models.rides import Ride, RideModel, RollerCoasterStats
 from .models.location import RideLocation
 from .models.reviews import RideReview
+from .models.rankings import RideRanking, RidePairComparison, RankingSnapshot
 
 
 class ManufacturerAdmin(admin.ModelAdmin):
@@ -484,4 +485,222 @@ class CompanyAdmin(admin.ModelAdmin):
         return ", ".join(obj.roles) if obj.roles else "No roles"
 
 
+@admin.register(RideRanking)
+class RideRankingAdmin(admin.ModelAdmin):
+    """Admin interface for ride rankings"""
+
+    list_display = (
+        "rank",
+        "ride_name",
+        "park_name",
+        "winning_percentage_display",
+        "wins",
+        "losses",
+        "ties",
+        "average_rating",
+        "mutual_riders_count",
+        "last_calculated",
+    )
+    list_filter = (
+        "ride__category",
+        "last_calculated",
+        "calculation_version",
+    )
+    search_fields = (
+        "ride__name",
+        "ride__park__name",
+    )
+    readonly_fields = (
+        "ride",
+        "rank",
+        "wins",
+        "losses",
+        "ties",
+        "winning_percentage",
+        "mutual_riders_count",
+        "comparison_count",
+        "average_rating",
+        "last_calculated",
+        "calculation_version",
+        "total_comparisons",
+    )
+    ordering = ["rank"]
+
+    fieldsets = (
+        (
+            "Ride Information",
+            {"fields": ("ride",)},
+        ),
+        (
+            "Ranking Metrics",
+            {
+                "fields": (
+                    "rank",
+                    "winning_percentage",
+                    "wins",
+                    "losses",
+                    "ties",
+                    "total_comparisons",
+                )
+            },
+        ),
+        (
+            "Additional Metrics",
+            {
+                "fields": (
+                    "average_rating",
+                    "mutual_riders_count",
+                    "comparison_count",
+                )
+            },
+        ),
+        (
+            "Calculation Info",
+            {
+                "fields": (
+                    "last_calculated",
+                    "calculation_version",
+                ),
+                "classes": ("collapse",),
+            },
+        ),
+    )
+
+    @admin.display(description="Ride")
+    def ride_name(self, obj):
+        return obj.ride.name
+
+    @admin.display(description="Park")
+    def park_name(self, obj):
+        return obj.ride.park.name
+
+    @admin.display(description="Win %")
+    def winning_percentage_display(self, obj):
+        return f"{obj.winning_percentage:.1%}"
+
+    def has_add_permission(self, request):
+        # Rankings are calculated automatically
+        return False
+
+    def has_change_permission(self, request, obj=None):
+        # Rankings are read-only
+        return False
+
+
+@admin.register(RidePairComparison)
+class RidePairComparisonAdmin(admin.ModelAdmin):
+    """Admin interface for ride pair comparisons"""
+
+    list_display = (
+        "comparison_summary",
+        "ride_a_name",
+        "ride_b_name",
+        "winner_display",
+        "ride_a_wins",
+        "ride_b_wins",
+        "ties",
+        "mutual_riders_count",
+        "last_calculated",
+    )
+    list_filter = ("last_calculated",)
+    search_fields = (
+        "ride_a__name",
+        "ride_b__name",
+        "ride_a__park__name",
+        "ride_b__park__name",
+    )
+    readonly_fields = (
+        "ride_a",
+        "ride_b",
+        "ride_a_wins",
+        "ride_b_wins",
+        "ties",
+        "mutual_riders_count",
+        "ride_a_avg_rating",
+        "ride_b_avg_rating",
+        "last_calculated",
+        "winner",
+        "is_tie",
+    )
+    ordering = ["-mutual_riders_count"]
+
+    @admin.display(description="Comparison")
+    def comparison_summary(self, obj):
+        return f"{obj.ride_a.name} vs {obj.ride_b.name}"
+
+    @admin.display(description="Ride A")
+    def ride_a_name(self, obj):
+        return obj.ride_a.name
+
+    @admin.display(description="Ride B")
+    def ride_b_name(self, obj):
+        return obj.ride_b.name
+
+    @admin.display(description="Winner")
+    def winner_display(self, obj):
+        if obj.is_tie:
+            return "TIE"
+        winner = obj.winner
+        if winner:
+            return winner.name
+        return "N/A"
+
+    def has_add_permission(self, request):
+        # Comparisons are calculated automatically
+        return False
+
+    def has_change_permission(self, request, obj=None):
+        # Comparisons are read-only
+        return False
+
+
+@admin.register(RankingSnapshot)
+class RankingSnapshotAdmin(admin.ModelAdmin):
+    """Admin interface for ranking history snapshots"""
+
+    list_display = (
+        "ride_name",
+        "park_name",
+        "rank",
+        "winning_percentage_display",
+        "snapshot_date",
+    )
+    list_filter = (
+        "snapshot_date",
+        "ride__category",
+    )
+    search_fields = (
+        "ride__name",
+        "ride__park__name",
+    )
+    readonly_fields = (
+        "ride",
+        "rank",
+        "winning_percentage",
+        "snapshot_date",
+    )
+    date_hierarchy = "snapshot_date"
+    ordering = ["-snapshot_date", "rank"]
+
+    @admin.display(description="Ride")
+    def ride_name(self, obj):
+        return obj.ride.name
+
+    @admin.display(description="Park")
+    def park_name(self, obj):
+        return obj.ride.park.name
+
+    @admin.display(description="Win %")
+    def winning_percentage_display(self, obj):
+        return f"{obj.winning_percentage:.1%}"
+
+    def has_add_permission(self, request):
+        # Snapshots are created automatically
+        return False
+
+    def has_change_permission(self, request, obj=None):
+        # Snapshots are read-only
+        return False
+
+
 admin.site.register(RideLocation, RideLocationAdmin)