feat(organisation): add dashboard-stats endpoint

GET /organisations/{organisation}/dashboard-stats returns members, events (with status breakdown + active count), persons, the first five members sorted by join date, and the five most recent activity log entries. Business logic lives in OrganisationDashboardService; access follows OrganisationPolicy@view. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 10:27:37 +02:00
parent 036fb3002f
commit 671e0c9889
5 changed files with 341 additions and 0 deletions
--- a/api/app/Services/OrganisationDashboardService.php
+++ b/api/app/Services/OrganisationDashboardService.php
@@ -0,0 +1,138 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services;
+
+use App\Models\Event;
+use App\Models\Organisation;
+use App\Models\Person;
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Support\Collection;
+use Spatie\Activitylog\Models\Activity;
+
+final class OrganisationDashboardService
+{
+    private const ACTIVE_STATUSES = ['published', 'registration_open', 'buildup', 'showday'];
+
+    private const STATUSES = [
+        'draft',
+        'published',
+        'registration_open',
+        'buildup',
+        'showday',
+        'teardown',
+        'closed',
+    ];
+
+    /** @return array<string, mixed> */
+    public function statsFor(Organisation $organisation): array
+    {
+        return [
+            'members_count' => $this->membersCount($organisation),
+            'events_count' => $this->eventsCount($organisation),
+            'events_by_status' => $this->eventsByStatus($organisation),
+            'active_events_count' => $this->activeEventsCount($organisation),
+            'persons_count' => $this->personsCount($organisation),
+            'top_members' => $this->topMembers($organisation),
+            'recent_activity' => $this->recentActivity($organisation),
+        ];
+    }
+
+    private function membersCount(Organisation $organisation): int
+    {
+        return $organisation->users()->count();
+    }
+
+    private function eventsCount(Organisation $organisation): int
+    {
+        return Event::withoutGlobalScope(OrganisationScope::class)
+            ->where('organisation_id', $organisation->id)
+            ->count();
+    }
+
+    /** @return array<string, int> */
+    private function eventsByStatus(Organisation $organisation): array
+    {
+        $counts = Event::withoutGlobalScope(OrganisationScope::class)
+            ->where('organisation_id', $organisation->id)
+            ->selectRaw('status, COUNT(*) as total')
+            ->groupBy('status')
+            ->pluck('total', 'status')
+            ->map(fn ($count) => (int) $count)
+            ->toArray();
+
+        $result = [];
+        foreach (self::STATUSES as $status) {
+            $result[$status] = $counts[$status] ?? 0;
+        }
+
+        return $result;
+    }
+
+    private function activeEventsCount(Organisation $organisation): int
+    {
+        return Event::withoutGlobalScope(OrganisationScope::class)
+            ->where('organisation_id', $organisation->id)
+            ->whereIn('status', self::ACTIVE_STATUSES)
+            ->count();
+    }
+
+    private function personsCount(Organisation $organisation): int
+    {
+        return Person::withoutGlobalScope(OrganisationScope::class)
+            ->whereIn(
+                'event_id',
+                Event::withoutGlobalScope(OrganisationScope::class)
+                    ->where('organisation_id', $organisation->id)
+                    ->select('id')
+            )
+            ->count();
+    }
+
+    /** @return array<int, array<string, mixed>> */
+    private function topMembers(Organisation $organisation): array
+    {
+        return $organisation->users()
+            ->orderBy('organisation_user.created_at', 'asc')
+            ->limit(5)
+            ->get()
+            ->map(fn ($user) => [
+                'id' => $user->id,
+                'name' => $user->full_name,
+                'email' => $user->email,
+                'avatar_url' => $user->avatar,
+                'role' => $user->pivot?->role,
+                'joined_at' => $user->pivot?->created_at?->toIso8601String(),
+            ])
+            ->all();
+    }
+
+    /** @return array<int, array<string, mixed>> */
+    private function recentActivity(Organisation $organisation): array
+    {
+        return Activity::query()
+            ->where('subject_type', Organisation::class)
+            ->where('subject_id', $organisation->id)
+            ->with('causer')
+            ->latest()
+            ->limit(5)
+            ->get()
+            ->map(function (Activity $activity): array {
+                /** @var \App\Models\User|null $causer */
+                $causer = $activity->causer;
+
+                return [
+                    'id' => $activity->id,
+                    'description' => $activity->description,
+                    'causer_name' => $causer?->full_name,
+                    'causer_avatar_url' => $causer?->avatar,
+                    'subject_type' => $activity->subject_type ? class_basename($activity->subject_type) : null,
+                    'subject_id' => $activity->subject_id,
+                    'properties' => $activity->attribute_changes?->toArray() ?? [],
+                    'created_at' => $activity->created_at?->toIso8601String(),
+                ];
+            })
+            ->all();
+    }
+}