✨ **Enhance API functionality and localizations**

- 🌐 Added API documentation annotations for multiple controllers (Meetups, Cities, Countries, Courses, Highscores, Venues), improving public and developer-facing endpoint clarity. - ➕ Integrated and configured the `dedoc/scramble` package for automated OpenAPI documentation generation. - 🔒 Excluded internal routes and actions from API documentation using `ExcludeRouteFromDocs` attributes. - 🌍 Added new localization keys for API Token features across multiple languages (`lv`, `es`, etc.). - 🛠️ Introduced `Group`, `Response`, and `QueryParameter` attributes for better request descriptions and structured documentation. - 🚀 Enhanced functionality for listing operations in controllers with filters and query parameters like `search` and `selected`.
2026-06-11 02:50:29 +00:00 · 2026-06-08 00:09:59 +02:00
parent 5a325b1b28
commit 351dd87fa9
29 changed files with 1178 additions and 421 deletions
@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Models\MeetupEvent;
+use Carbon\Carbon;
+use Dedoc\Scramble\Attributes\Group;
+use Dedoc\Scramble\Attributes\PathParameter;
+use Illuminate\Support\Collection;
+
+#[Group(name: 'Meetups', weight: 3)]
+class MeetupEventController extends Controller
+{
+    /**
+     * Meetup-Termine auflisten
+     *
+     * Liefert kommende/vergangene Meetup-Termine. Mit optionalem Datum wird auf den
+     * jeweiligen Monat dieses Datums gefiltert.
+     *
+     * @return Collection<int, array<string, mixed>>
+     */
+    #[PathParameter(name: 'date', description: 'Optionales Datum (Y-m-d); filtert auf den Monat dieses Datums.', required: false, type: 'string')]
+    public function __invoke(?string $date = null): Collection
+    {
+        if ($date) {
+            $date = Carbon::parse($date);
+        }
+        $events = MeetupEvent::query()
+            ->with([
+                'meetup.city.country',
+                'meetup.media',
+            ])
+            ->when(
+                $date,
+                fn ($query) => $query
+                    ->where('start', '>=', $date)
+                    ->where('start', '<=', $date->copy()->endOfMonth()),
+            )
+            ->get();
+
+        return $events->map(fn ($event) => [
+            'start' => $event->start->format('Y-m-d H:i'),
+            'location' => $event->location,
+            'description' => $event->description,
+            'link' => $event->link,
+            'meetup.name' => $event->meetup->name,
+            'meetup.portalLink' => url()->route(
+                'meetups.landingpage',
+                [
+                    'country' => $event->meetup->city->country,
+                    'meetup' => $event->meetup,
+                ],
+            ),
+            'meetup.url' => $event->meetup->telegram_link ?? $event->meetup->webpage,
+            'meetup.country' => str($event->meetup->city->country->code)->upper(),
+            'meetup.city' => $event->meetup->city->name,
+            'meetup.longitude' => (float) $event->meetup->city->longitude,
+            'meetup.latitude' => (float) $event->meetup->city->latitude,
+            'meetup.twitter_username' => $event->meetup->twitter_username,
+            'meetup.website' => $event->meetup->webpage,
+            'meetup.simplex' => $event->meetup->simplex,
+            'meetup.signal' => $event->meetup->signal,
+            'meetup.nostr' => $event->meetup->nostr,
+            'meetup.logo' => $event->meetup->getFirstMediaUrl('logo'),
+        ],
+        );
+    }
+}