TenantAtlas/app/Filament/Resources/AlertDeliveryResource.php

<?php

declare(strict_types=1);

namespace App\Filament\Resources;

use App\Filament\Clusters\Monitoring\AlertsCluster;
use App\Filament\Resources\AlertDeliveryResource\Pages;
use App\Models\AlertDelivery;
use App\Models\Tenant;
use App\Models\User;
use App\Support\Ui\ActionSurface\ActionSurfaceDeclaration;
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceInspectAffordance;
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceProfile;
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceSlot;
use App\Support\Workspaces\WorkspaceContext;
use BackedEnum;
use Filament\Actions\ViewAction;
use Filament\Facades\Filament;
use Filament\Infolists\Components\TextEntry;
use Filament\Infolists\Components\ViewEntry;
use Filament\Resources\Resource;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Schema;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Filters\SelectFilter;
use Filament\Tables\Table;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use UnitEnum;

class AlertDeliveryResource extends Resource
{
    protected static bool $isScopedToTenant = false;

    protected static ?string $model = AlertDelivery::class;

    protected static ?string $slug = 'alert-deliveries';

    protected static ?string $cluster = AlertsCluster::class;

    protected static ?int $navigationSort = 1;

    protected static bool $isGloballySearchable = false;

    protected static ?string $recordTitleAttribute = 'id';

    protected static string|BackedEnum|null $navigationIcon = 'heroicon-o-clock';

    protected static string|UnitEnum|null $navigationGroup = 'Monitoring';

    protected static ?string $navigationLabel = 'Alert deliveries';

    public static function shouldRegisterNavigation(): bool
    {
        if (Filament::getCurrentPanel()?->getId() !== 'admin') {
            return false;
        }

        return parent::shouldRegisterNavigation();
    }

    public static function canViewAny(): bool
    {
        $user = auth()->user();

        if (! $user instanceof User) {
            return false;
        }

        return $user->can('viewAny', AlertDelivery::class);
    }

    public static function canView(Model $record): bool
    {
        $user = auth()->user();

        if (! $user instanceof User || ! $record instanceof AlertDelivery) {
            return false;
        }

        return $user->can('view', $record);
    }

    public static function actionSurfaceDeclaration(): ActionSurfaceDeclaration
    {
        return ActionSurfaceDeclaration::forResource(ActionSurfaceProfile::ListOnlyReadOnly)
            ->exempt(ActionSurfaceSlot::ListHeader, 'Read-only history list intentionally has no list-header actions.')
            ->satisfy(ActionSurfaceSlot::InspectAffordance, ActionSurfaceInspectAffordance::ClickableRow->value)
            ->exempt(ActionSurfaceSlot::ListRowMoreMenu, 'No secondary row actions are exposed for read-only deliveries.')
            ->exempt(ActionSurfaceSlot::ListBulkMoreGroup, 'No bulk actions are exposed for read-only deliveries.')
            ->exempt(ActionSurfaceSlot::ListEmptyState, 'Deliveries are generated by jobs and intentionally have no empty-state CTA.')
            ->exempt(ActionSurfaceSlot::DetailHeader, 'View page is informational with no mutating header actions.');
    }

    public static function getEloquentQuery(): Builder
    {
        $workspaceId = app(WorkspaceContext::class)->currentWorkspaceId(request());
        $user = auth()->user();

        return parent::getEloquentQuery()
            ->with(['tenant', 'rule', 'destination'])
            ->when(
                ! $user instanceof User,
                fn (Builder $query): Builder => $query->whereRaw('1 = 0'),
            )
            ->when(
                ! is_int($workspaceId),
                fn (Builder $query): Builder => $query->whereRaw('1 = 0'),
            )
            ->when(
                is_int($workspaceId),
                fn (Builder $query): Builder => $query->where('workspace_id', $workspaceId),
            )
            ->when(
                $user instanceof User,
                fn (Builder $query): Builder => $query->whereIn('tenant_id', $user->tenantMemberships()->select('tenant_id')),
            )
            ->when(
                Filament::getTenant() instanceof Tenant,
                fn (Builder $query): Builder => $query->where('tenant_id', (int) Filament::getTenant()->getKey()),
            )
            ->latest('id');
    }

    public static function form(Schema $schema): Schema
    {
        return $schema;
    }

    public static function infolist(Schema $schema): Schema
    {
        return $schema
            ->schema([
                Section::make('Delivery')
                    ->schema([
                        TextEntry::make('status')
                            ->badge()
                            ->formatStateUsing(fn (?string $state): string => self::statusLabel((string) $state))
                            ->color(fn (?string $state): string => self::statusColor((string) $state)),
                        TextEntry::make('event_type')
                            ->label('Event')
                            ->badge()
                            ->formatStateUsing(fn (?string $state): string => AlertRuleResource::eventTypeLabel((string) $state)),
                        TextEntry::make('severity')
                            ->badge()
                            ->formatStateUsing(fn (?string $state): string => ucfirst((string) $state))
                            ->placeholder('—'),
                        TextEntry::make('tenant.name')
                            ->label('Tenant'),
                        TextEntry::make('rule.name')
                            ->label('Rule')
                            ->placeholder('—'),
                        TextEntry::make('destination.name')
                            ->label('Destination')
                            ->placeholder('—'),
                        TextEntry::make('attempt_count')
                            ->label('Attempts'),
                        TextEntry::make('fingerprint_hash')
                            ->label('Fingerprint')
                            ->copyable(),
                        TextEntry::make('send_after')
                            ->dateTime()
                            ->placeholder('—'),
                        TextEntry::make('sent_at')
                            ->dateTime()
                            ->placeholder('—'),
                        TextEntry::make('last_error_code')
                            ->label('Last error code')
                            ->placeholder('—'),
                        TextEntry::make('last_error_message')
                            ->label('Last error message')
                            ->placeholder('—')
                            ->columnSpanFull(),
                        TextEntry::make('created_at')
                            ->dateTime(),
                        TextEntry::make('updated_at')
                            ->dateTime(),
                    ])
                    ->columns(2)
                    ->columnSpanFull(),
                Section::make('Payload')
                    ->schema([
                        ViewEntry::make('payload')
                            ->label('')
                            ->view('filament.infolists.entries.snapshot-json')
                            ->state(fn (AlertDelivery $record): array => is_array($record->payload) ? $record->payload : [])
                            ->columnSpanFull(),
                    ])
                    ->columnSpanFull(),
            ]);
    }

    public static function table(Table $table): Table
    {
        return $table
            ->defaultSort('id', 'desc')
            ->recordUrl(fn (AlertDelivery $record): ?string => static::canView($record)
                ? static::getUrl('view', ['record' => $record])
                : null)
            ->columns([
                TextColumn::make('created_at')
                    ->label('Created')
                    ->since(),
                TextColumn::make('tenant.name')
                    ->label('Tenant')
                    ->searchable(),
                TextColumn::make('event_type')
                    ->label('Event')
                    ->badge(),
                TextColumn::make('severity')
                    ->badge()
                    ->formatStateUsing(fn (?string $state): string => ucfirst((string) $state))
                    ->placeholder('—'),
                TextColumn::make('status')
                    ->badge()
                    ->formatStateUsing(fn (?string $state): string => self::statusLabel((string) $state))
                    ->color(fn (?string $state): string => self::statusColor((string) $state)),
                TextColumn::make('rule.name')
                    ->label('Rule')
                    ->placeholder('—'),
                TextColumn::make('destination.name')
                    ->label('Destination')
                    ->placeholder('—'),
                TextColumn::make('attempt_count')
                    ->label('Attempts'),
            ])
            ->filters([
                SelectFilter::make('status')
                    ->options([
                        AlertDelivery::STATUS_QUEUED => 'Queued',
                        AlertDelivery::STATUS_DEFERRED => 'Deferred',
                        AlertDelivery::STATUS_SENT => 'Sent',
                        AlertDelivery::STATUS_FAILED => 'Failed',
                        AlertDelivery::STATUS_SUPPRESSED => 'Suppressed',
                        AlertDelivery::STATUS_CANCELED => 'Canceled',
                    ]),
            ])
            ->actions([
                ViewAction::make()->label('View'),
            ])
            ->bulkActions([]);
    }

    public static function getPages(): array
    {
        return [
            'index' => Pages\ListAlertDeliveries::route('/'),
            'view' => Pages\ViewAlertDelivery::route('/{record}'),
        ];
    }

    private static function statusLabel(string $status): string
    {
        return match ($status) {
            AlertDelivery::STATUS_QUEUED => 'Queued',
            AlertDelivery::STATUS_DEFERRED => 'Deferred',
            AlertDelivery::STATUS_SENT => 'Sent',
            AlertDelivery::STATUS_FAILED => 'Failed',
            AlertDelivery::STATUS_SUPPRESSED => 'Suppressed',
            AlertDelivery::STATUS_CANCELED => 'Canceled',
            default => ucfirst($status),
        };
    }

    private static function statusColor(string $status): string
    {
        return match ($status) {
            AlertDelivery::STATUS_QUEUED => 'gray',
            AlertDelivery::STATUS_DEFERRED => 'warning',
            AlertDelivery::STATUS_SENT => 'success',
            AlertDelivery::STATUS_FAILED => 'danger',
            AlertDelivery::STATUS_SUPPRESSED => 'info',
            AlertDelivery::STATUS_CANCELED => 'gray',
            default => 'gray',
        };
    }
}