refactor: upgrade PHPStan to level 6 with type annotations (#189)

## Summary
- Upgrade PHPStan from level 1 to level 6
- Add proper PHPDoc annotations across events module and app
- Fix type safety issues identified by stricter analysis

## Changes
- `phpstan.neon`: level 1 → level 6
- Events models: proper `@property`, `@return`, and `@param` annotations
- Filament resources: type-safe static analysis fixes
- App support files: improved type annotations

## Testing
- [ ] `composer phpstan` passes

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

## Release Notes

* **Bug Fixes**
  * Improved null-safety when retrieving event attendance information
* Fixed potential null reference issues when checking event
participation status

* **Refactor**
  * Enhanced type safety and null-checking throughout the application
  * Optimized queries for participant and attendance lookups

* **Chores**
* Increased static code analysis strictness to improve overall code
quality
* Improved code documentation and type annotations for better
maintainability

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: danielhe4rt

.gitignore

@@ -41,3 +41,4 @@ _ide_helper_models.php
 tests/Browser/Screenshots
 /.github/git-commit-instructions.md
 /.laracord
+.claude

app-modules/events/src/Actions/AttendEventAction.php

@@ -6,6 +6,7 @@
 
 use Exception;
 use He4rt\Events\Models\EventModel;
+use He4rt\Events\Models\Pivot\EventAttend;
 
 final class AttendEventAction
 {
@@ -14,7 +15,9 @@ final class AttendEventAction
      */
     public function execute(EventModel $eventModel): void
     {
-        $attendingStatus = $eventModel->attendees()->first()->pivot->status;
+        /** @var EventAttend|null $pivot */
+        $pivot = $eventModel->attendees()->first()?->pivot;
+        $attendingStatus = $pivot->status;
         $eventModel->attend(auth()->user()->id, $attendingStatus);
     }
 }

app-modules/events/src/Filament/Admin/Resources/EventAgenda/EventAgendaResource.php

@@ -153,6 +153,7 @@ public static function getGloballySearchableAttributes(): array
 
     public static function getGlobalSearchResultDetails(Model $record): array
     {
+        /** @var EventAgenda $record */
         $details = [];
 
         if ($record->tenant) {

app-modules/events/src/Filament/Admin/Resources/Events/RelationManagers/AttendeesRelationManager.php

@@ -11,6 +11,7 @@
 use Filament\Tables\Columns\IconColumn;
 use Filament\Tables\Columns\TextColumn;
 use Filament\Tables\Table;
+use He4rt\Events\Models\EventModel;
 use He4rt\Identity\Filament\Admin\Resources\Users\UserResource;
 use He4rt\Identity\User\Models\User;
 use Illuminate\Database\Eloquent\Model;
@@ -27,6 +28,7 @@ class AttendeesRelationManager extends RelationManager
 
     public static function getBadge(Model $ownerRecord, string $pageClass): ?string
     {
+        /** @var EventModel $ownerRecord */
         return (string) $ownerRecord->attendees()->count();
     }
 
@@ -48,7 +50,11 @@ public function table(Table $table): Table
             ])
             ->recordActions([
                 DetachAction::make()
-                    ->using(fn (User $record) => $this->getOwnerRecord()->leave($record->getKey())),
+                    ->using(function (User $record): void {
+                        /** @var EventModel $ownerRecord */
+                        $ownerRecord = $this->getOwnerRecord();
+                        $ownerRecord->leave($record->getKey());
+                    }),
             ]);
     }
 }

app-modules/events/src/Filament/Admin/Resources/Events/RelationManagers/TalksRelationManager.php

@@ -10,6 +10,7 @@
 use Filament\Support\Icons\Heroicon;
 use Filament\Tables\Table;
 use He4rt\Events\Filament\Admin\Resources\Talks\TalkResource;
+use He4rt\Events\Models\EventModel;
 use Illuminate\Database\Eloquent\Model;
 
 class TalksRelationManager extends RelationManager
@@ -20,6 +21,7 @@ class TalksRelationManager extends RelationManager
 
     public static function getBadge(Model $ownerRecord, string $pageClass): ?string
     {
+        /** @var EventModel $ownerRecord */
         return (string) $ownerRecord->talks()->count();
     }
 

app-modules/events/src/Filament/App/EventModels/Pages/ListEventModels.php

@@ -40,6 +40,10 @@ public function leave(string|int $eventModelId): void
             ->send();
     }
 
+    /**
+     * @param  Builder<EventModel>  $query
+     * @return Builder<EventModel>
+     */
     protected function modifyQueryWithActiveTab(Builder $query, bool $isResolvingRecord = false): Builder
     {
         return $query->where('active', true)->with('attendees')->latest('end_at');

app-modules/events/src/Filament/Events/EventLandingPage.php

@@ -6,18 +6,21 @@
 
 use Filament\Pages\Dashboard;
 use Filament\Support\Enums\Width;
+use He4rt\Identity\Tenant\Models\Tenant;
 
 class EventLandingPage extends Dashboard
 {
-    public $tenant;
+    public ?Tenant $tenant = null;
 
     protected static bool $shouldRegisterNavigation = false;
 
     protected Width|string|null $maxContentWidth = Width::Full;
 
     public function mount(): void
     {
-        $this->tenant = filament()->getTenant();
+        /** @var Tenant|null $tenant */
+        $tenant = filament()->getTenant();
+        $this->tenant = $tenant;
     }
 
     public function getView(): string

app-modules/events/src/Filament/Events/ParticipantDashboard.php

@@ -11,11 +11,9 @@
 use He4rt\Identity\Tenant\Models\Tenant;
 use Illuminate\Contracts\Support\Htmlable;
 
-/** @property Tenant $tenant */
 class ParticipantDashboard extends Page
 {
-    /** @var Tenant|null */
-    public $tenant;
+    public ?Tenant $tenant = null;
 
     /** @var EventModel|null */
     public $event;
@@ -34,14 +32,16 @@ public function getTitle(): string|Htmlable
 
     public function mount(): void
     {
-        $this->tenant = filament()->getTenant();
+        /** @var Tenant $tenant */
+        $tenant = filament()->getTenant();
+        $this->tenant = $tenant;
 
         $this->event = $this->tenant
             ->events()
             ->where('active', true)
             ->first();
 
-        abort_unless($this->event, 404);
+        abort_unless($this->event !== null, 404);
     }
 
     public function getView(): string

app-modules/events/src/Filament/Resources/EventSubmissionSpeakerResource.php

@@ -110,20 +110,21 @@ public static function getEloquentQuery(): Builder
 
     public static function getGlobalSearchEloquentQuery(): Builder
     {
-        return parent::getGlobalSearchEloquentQuery()->with(['event', 'user']);
+        return parent::getGlobalSearchEloquentQuery()->with(['submission.event', 'user']);
     }
 
     public static function getGloballySearchableAttributes(): array
     {
-        return ['event.title', 'user.name'];
+        return ['submission.event.title', 'user.name'];
     }
 
     public static function getGlobalSearchResultDetails(Model $record): array
     {
+        /** @var EventSubmissionSpeaker $record */
         $details = [];
 
-        if ($record->event) {
-            $details['Event'] = $record->event->title;
+        if ($record->submission?->event) {
+            $details['Event'] = $record->submission->event->title;
         }
 
         if ($record->user) {

app-modules/events/src/Filament/Shared/EventLogin.php

@@ -174,8 +174,9 @@ public function defaultMultiFactorChallengeForm(Schema $schema): Schema
                     return [];
                 }
 
-                $authProvider = Filament::auth()->getProvider();
-                /** @phpstan-ignore-line */
+                /** @var SessionGuard $guard */
+                $guard = Filament::auth();
+                $authProvider = $guard->getProvider();
                 $user = $authProvider->retrieveById(decrypt($this->userUndertakingMultiFactorAuthentication));
 
                 $enabledMultiFactorAuthenticationProviders = array_filter(
@@ -341,8 +342,9 @@ protected function getRememberFormComponent(): Component
 
     protected function getMultiFactorProviderFormComponent(): ?Component
     {
-        $authProvider = Filament::auth()->getProvider();
-        /** @phpstan-ignore-line */
+        /** @var SessionGuard $guard */
+        $guard = Filament::auth();
+        $authProvider = $guard->getProvider();
         $user = $authProvider->retrieveById(decrypt($this->userUndertakingMultiFactorAuthentication));
 
         $enabledMultiFactorAuthenticationProviders = array_filter(