Filament global search with relation fields and quick actions

<?php

namespace App\Filament\Resources\Candidates;

use App\Filament\Resources\Candidates\Pages\ListCandidates;
use App\Models\Candidate;
use Filament\Actions\Action;
use Filament\Resources\Resource;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;

class CandidateResource extends Resource
{
    protected static ?string $model = Candidate::class;

    // The title of each hit in the search dropdown.
    protected static ?string $recordTitleAttribute = 'name';

    // Search the candidate and two related models. Dotted names go through relations.
    public static function getGlobalSearchAttributes(): array
    {
        return ['name', 'phone', 'job.title', 'tags.name'];
    }

    // Eager load what the details below read, or each hit costs extra queries.
    public static function getGlobalSearchEloquentQuery(): Builder
    {
        return parent::getGlobalSearchEloquentQuery()
            ->with(['job', 'stage'])
            ->where('is_archived', false);   // never surface archived people
    }

    // The grey lines shown under each title.
    public static function getGlobalSearchResultDetails(Model $record): array
    {
        return [
            'Job' => $record->job?->title ?? 'Unassigned',
            'Stage' => $record->stage?->name ?? 'New',
        ];
    }

    // Quick buttons beside every hit.
    public static function getGlobalSearchResultActions(Model $record): array
    {
        return [
            Action::make('profile')
                ->label('Open profile')
                ->url(static::getUrl('view', ['record' => $record])),
            Action::make('edit')
                ->url(static::getUrl('edit', ['record' => $record]))
                ->visible(fn () => auth()->user()->can('update', $record)),
        ];
    }

    // Keep the dropdown short; the full list page still has everything.
    public static function getGlobalSearchResultsLimit(): int
    {
        return 5;
    }

    public static function getPages(): array
    {
        return ['index' => ListCandidates::route('/')];
    }
}

// Panel provider tuning:
//   ->globalSearchDebounce('500ms')
//   ->globalSearchKeyBindings(['command+k', 'ctrl+k'])