Files
crewli/api/app/Services/OrganisationDashboardService.php
bert.hausmans 671e0c9889 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

139 lines
4.5 KiB
PHP

<?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();
}
}