Add models, enums, and services for user roles, theme preferences, slug history, and ID generation

2025-12-22 15:11:10 -05:00 · 2025-02-23 19:50:40 -05:00
parent 32aea21e48
commit 7e5d15eb46
55 changed files with 6462 additions and 4 deletions
--- a/app/Traits/HasParkStatistics.php
+++ b/app/Traits/HasParkStatistics.php
@@ -0,0 +1,202 @@
+<?php
+
+namespace App\Traits;
+
+trait HasParkStatistics
+{
+    /**
+     * Get the total ride count including all types.
+     */
+    public function getTotalRideCountAttribute(): int
+    {
+        return $this->total_rides ?? 0;
+    }
+
+    /**
+     * Get the percentage of coasters among all rides.
+     */
+    public function getCoasterPercentageAttribute(): float
+    {
+        if ($this->total_rides === 0) {
+            return 0;
+        }
+
+        return round(($this->total_coasters / $this->total_rides) * 100, 1);
+    }
+
+    /**
+     * Get a summary of ride types distribution.
+     *
+     * @return array<string, int>
+     */
+    public function getRideDistributionAttribute(): array
+    {
+        return [
+            'coasters' => $this->total_coasters ?? 0,
+            'flat_rides' => $this->total_flat_rides ?? 0,
+            'water_rides' => $this->total_water_rides ?? 0,
+        ];
+    }
+
+    /**
+     * Get a summary of area statistics.
+     *
+     * @return array<string, int>
+     */
+    public function getAreaDistributionAttribute(): array
+    {
+        return [
+            'total' => $this->total_areas ?? 0,
+            'operating' => $this->operating_areas ?? 0,
+            'closed' => $this->closed_areas ?? 0,
+        ];
+    }
+
+    /**
+     * Get the formatted daily capacity.
+     */
+    public function getFormattedDailyCapacityAttribute(): string
+    {
+        if (!$this->total_daily_capacity) {
+            return 'Unknown capacity';
+        }
+
+        return number_format($this->total_daily_capacity) . ' riders/day';
+    }
+
+    /**
+     * Get the formatted average wait time.
+     */
+    public function getFormattedWaitTimeAttribute(): string
+    {
+        if (!$this->average_wait_time) {
+            return 'Unknown wait time';
+        }
+
+        return $this->average_wait_time . ' minutes';
+    }
+
+    /**
+     * Get the rating display with stars.
+     */
+    public function getRatingDisplayAttribute(): string
+    {
+        if (!$this->average_rating) {
+            return 'Not rated';
+        }
+
+        $stars = str_repeat('★', floor($this->average_rating));
+        $stars .= str_repeat('☆', 5 - floor($this->average_rating));
+
+        return $stars . ' (' . number_format($this->average_rating, 1) . ')';
+    }
+
+    /**
+     * Get historical statistics summary.
+     *
+     * @return array<string, mixed>
+     */
+    public function getHistoricalStatsAttribute(): array
+    {
+        return [
+            'total_operated' => $this->total_rides_operated,
+            'total_retired' => $this->total_rides_retired,
+            'last_expansion' => $this->last_expansion_date?->format('M Y') ?? 'Never',
+            'last_update' => $this->last_major_update?->format('M Y') ?? 'Never',
+            'retirement_rate' => $this->getRetirementRate(),
+        ];
+    }
+
+    /**
+     * Get performance metrics summary.
+     *
+     * @return array<string, mixed>
+     */
+    public function getPerformanceMetricsAttribute(): array
+    {
+        return [
+            'utilization' => $this->utilization_rate ? $this->utilization_rate . '%' : 'Unknown',
+            'peak_attendance' => $this->peak_daily_attendance ? number_format($this->peak_daily_attendance) : 'Unknown',
+            'satisfaction' => $this->guest_satisfaction ? number_format($this->guest_satisfaction, 1) . '/5.0' : 'Unknown',
+        ];
+    }
+
+    /**
+     * Calculate the retirement rate (retired rides as percentage of total operated).
+     */
+    protected function getRetirementRate(): float
+    {
+        if ($this->total_rides_operated === 0) {
+            return 0;
+        }
+
+        return round(($this->total_rides_retired / $this->total_rides_operated) * 100, 1);
+    }
+
+    /**
+     * Update area counts.
+     */
+    public function updateAreaCounts(): void
+    {
+        $this->update([
+            'total_areas' => $this->areas()->count(),
+            'operating_areas' => $this->areas()->operating()->count(),
+            'closed_areas' => $this->areas()->whereNotNull('closing_date')->count(),
+        ]);
+    }
+
+    /**
+     * Update ride statistics.
+     */
+    public function updateRideStatistics(): void
+    {
+        $areas = $this->areas;
+        
+        $this->update([
+            'total_rides' => $areas->sum('ride_count'),
+            'total_coasters' => $areas->sum('coaster_count'),
+            'total_flat_rides' => $areas->sum('flat_ride_count'),
+            'total_water_rides' => $areas->sum('water_ride_count'),
+            'total_daily_capacity' => $areas->sum('daily_capacity'),
+        ]);
+    }
+
+    /**
+     * Update visitor statistics.
+     */
+    public function updateVisitorStats(): void
+    {
+        $areas = $this->areas()->whereNotNull('average_rating');
+        
+        $this->update([
+            'average_wait_time' => $areas->avg('peak_wait_time'),
+            'average_rating' => $areas->avg('average_rating'),
+        ]);
+    }
+
+    /**
+     * Record an expansion.
+     */
+    public function recordExpansion(): void
+    {
+        $this->update(['last_expansion_date' => now()]);
+    }
+
+    /**
+     * Record a major update.
+     */
+    public function recordMajorUpdate(): void
+    {
+        $this->update(['last_major_update' => now()]);
+    }
+
+    /**
+     * Update all statistics.
+     */
+    public function refreshStatistics(): void
+    {
+        $this->updateAreaCounts();
+        $this->updateRideStatistics();
+        $this->updateVisitorStats();
+    }
+}