Update tenant lifecycle tooling and retire docs/process

app/Filament/Resources/TenantResource.php

@@ -6,18 +6,25 @@ use App\Filament\Clusters\DailyOps\DailyOpsCluster;
 use App\Filament\Resources\TenantResource\Pages;
 use App\Filament\Resources\TenantResource\RelationManagers\PackagePurchasesRelationManager;
 use App\Filament\Resources\TenantResource\RelationManagers\TenantPackagesRelationManager;
+use App\Filament\Resources\TenantResource\Schemas\TenantInfolist;
+use App\Jobs\AnonymizeAccount;
 use App\Models\Tenant;
+use App\Notifications\InactiveTenantDeletionWarning;
 use BackedEnum;
+use Carbon\Carbon;
 use Filament\Actions;
+use Filament\Facades\Filament;
 use Filament\Forms;
 use Filament\Forms\Components\KeyValue;
 use Filament\Forms\Components\Select;
 use Filament\Forms\Components\TextInput;
 use Filament\Forms\Components\Toggle;
+use Filament\Notifications\Notification;
 use Filament\Resources\Resource;
 use Filament\Schemas\Schema;
 use Filament\Tables;
 use Filament\Tables\Table;
+use Illuminate\Support\Facades\Notification as NotificationFacade;
 use Illuminate\Support\Facades\Route;
 use UnitEnum;
 
@@ -93,6 +100,11 @@ class TenantResource extends Resource
         ])->columns(2);
     }
 
+    public static function infolist(Schema $schema): Schema
+    {
+        return TenantInfolist::configure($schema);
+    }
+
     public static function table(Table $table): Table
     {
 
@@ -132,6 +144,23 @@ class TenantResource extends Resource
                 Tables\Columns\IconColumn::make('is_active')
                     ->boolean()
                     ->color(fn (bool $state): string => $state ? 'success' : 'danger'),
+                Tables\Columns\IconColumn::make('is_suspended')
+                    ->label(__('admin.tenants.fields.is_suspended'))
+                    ->boolean()
+                    ->color(fn (bool $state): string => $state ? 'warning' : 'success')
+                    ->toggleable(isToggledHiddenByDefault: true),
+                Tables\Columns\TextColumn::make('pending_deletion_at')
+                    ->label(__('admin.tenants.fields.pending_deletion_at'))
+                    ->dateTime()
+                    ->toggleable(isToggledHiddenByDefault: true),
+                Tables\Columns\TextColumn::make('deletion_warning_sent_at')
+                    ->label(__('admin.tenants.fields.deletion_warning_sent_at'))
+                    ->dateTime()
+                    ->toggleable(isToggledHiddenByDefault: true),
+                Tables\Columns\TextColumn::make('anonymized_at')
+                    ->label(__('admin.tenants.fields.anonymized_at'))
+                    ->dateTime()
+                    ->toggleable(isToggledHiddenByDefault: true),
                 Tables\Columns\TextColumn::make('last_activity_at')->since()->label(__('admin.common.last_activity')),
                 Tables\Columns\TextColumn::make('created_at')->dateTime()->toggleable(isToggledHiddenByDefault: true),
             ])
@@ -171,18 +200,15 @@ class TenantResource extends Resource
                             'metadata' => ['reason' => $data['reason'] ?? 'manual assignment'],
                         ]);
                     }),
-                Actions\Action::make('suspend')
-                    ->label('Suspendieren')
-                    ->color('danger')
-                    ->requiresConfirmation()
-                    ->authorize(fn (Tenant $record): bool => auth()->user()?->can('suspend', $record) ?? false)
-                    ->action(fn (Tenant $record) => $record->update(['is_suspended' => true])),
                 Actions\Action::make('export')
                     ->label('Daten exportieren')
                     ->icon('heroicon-o-arrow-down-tray')
                     ->url(fn (Tenant $record) => Route::has('admin.tenants.export') ? route('admin.tenants.export', $record) : null)
                     ->visible(fn () => Route::has('admin.tenants.export'))
                     ->openUrlInNewTab(),
+                Actions\ActionGroup::make(static::lifecycleActions())
+                    ->label(__('admin.tenants.actions.lifecycle'))
+                    ->icon('heroicon-o-shield-exclamation'),
             ])
             ->bulkActions([
                 Actions\DeleteBulkAction::make(),
@@ -206,4 +232,107 @@ class TenantResource extends Resource
             PackagePurchasesRelationManager::class,
         ];
     }
+
+    /**
+     * @return array<int, Actions\Action>
+     */
+    public static function lifecycleActions(): array
+    {
+        return [
+            Actions\Action::make('activate')
+                ->label(__('admin.tenants.actions.activate'))
+                ->icon('heroicon-o-check-circle')
+                ->color('success')
+                ->visible(fn (Tenant $record): bool => ! $record->is_active && ! $record->anonymized_at)
+                ->authorize(fn (Tenant $record): bool => Filament::auth()->user()?->can('update', $record) ?? false)
+                ->action(fn (Tenant $record): bool => $record->update(['is_active' => true])),
+            Actions\Action::make('deactivate')
+                ->label(__('admin.tenants.actions.deactivate'))
+                ->icon('heroicon-o-no-symbol')
+                ->color('danger')
+                ->requiresConfirmation()
+                ->visible(fn (Tenant $record): bool => (bool) $record->is_active && ! $record->anonymized_at)
+                ->authorize(fn (Tenant $record): bool => Filament::auth()->user()?->can('update', $record) ?? false)
+                ->action(fn (Tenant $record): bool => $record->update(['is_active' => false])),
+            Actions\Action::make('suspend')
+                ->label(__('admin.tenants.actions.suspend'))
+                ->icon('heroicon-o-pause-circle')
+                ->color('warning')
+                ->requiresConfirmation()
+                ->visible(fn (Tenant $record): bool => ! $record->is_suspended && ! $record->anonymized_at)
+                ->authorize(fn (Tenant $record): bool => Filament::auth()->user()?->can('suspend', $record) ?? false)
+                ->action(fn (Tenant $record): bool => $record->update(['is_suspended' => true])),
+            Actions\Action::make('unsuspend')
+                ->label(__('admin.tenants.actions.unsuspend'))
+                ->icon('heroicon-o-play-circle')
+                ->color('success')
+                ->visible(fn (Tenant $record): bool => (bool) $record->is_suspended && ! $record->anonymized_at)
+                ->authorize(fn (Tenant $record): bool => Filament::auth()->user()?->can('suspend', $record) ?? false)
+                ->action(fn (Tenant $record): bool => $record->update(['is_suspended' => false])),
+            Actions\Action::make('schedule_deletion')
+                ->label(__('admin.tenants.actions.schedule_deletion'))
+                ->icon('heroicon-o-calendar-days')
+                ->color('warning')
+                ->visible(fn (Tenant $record): bool => ! $record->anonymized_at && $record->pending_deletion_at === null)
+                ->authorize(fn (Tenant $record): bool => Filament::auth()->user()?->can('update', $record) ?? false)
+                ->form([
+                    Forms\Components\DateTimePicker::make('pending_deletion_at')
+                        ->label(__('admin.tenants.fields.pending_deletion_at'))
+                        ->required()
+                        ->minDate(now()->addDay()),
+                    Toggle::make('send_warning')
+                        ->label(__('admin.tenants.actions.send_warning'))
+                        ->default(true),
+                ])
+                ->action(function (Tenant $record, array $data): void {
+                    $plannedDeletion = Carbon::parse($data['pending_deletion_at']);
+                    $update = [
+                        'pending_deletion_at' => $plannedDeletion,
+                    ];
+
+                    if (($data['send_warning'] ?? false) === true) {
+                        $email = $record->contact_email
+                            ?? $record->email
+                            ?? $record->user?->email;
+
+                        if ($email) {
+                            NotificationFacade::route('mail', $email)
+                                ->notify(new InactiveTenantDeletionWarning($record, $plannedDeletion));
+                            $update['deletion_warning_sent_at'] = now();
+                        } else {
+                            Notification::make()
+                                ->danger()
+                                ->title(__('admin.tenants.actions.send_warning_missing_title'))
+                                ->body(__('admin.tenants.actions.send_warning_missing_body'))
+                                ->send();
+                        }
+                    }
+
+                    $record->forceFill($update)->save();
+                })
+                ->successNotificationTitle(__('admin.tenants.actions.schedule_deletion_success')),
+            Actions\Action::make('cancel_deletion')
+                ->label(__('admin.tenants.actions.cancel_deletion'))
+                ->icon('heroicon-o-x-circle')
+                ->requiresConfirmation()
+                ->visible(fn (Tenant $record): bool => $record->pending_deletion_at !== null && ! $record->anonymized_at)
+                ->authorize(fn (Tenant $record): bool => Filament::auth()->user()?->can('update', $record) ?? false)
+                ->action(function (Tenant $record): void {
+                    $record->forceFill([
+                        'pending_deletion_at' => null,
+                        'deletion_warning_sent_at' => null,
+                    ])->save();
+                })
+                ->successNotificationTitle(__('admin.tenants.actions.cancel_deletion_success')),
+            Actions\Action::make('anonymize_now')
+                ->label(__('admin.tenants.actions.anonymize_now'))
+                ->icon('heroicon-o-trash')
+                ->color('danger')
+                ->requiresConfirmation()
+                ->visible(fn (Tenant $record): bool => ! $record->anonymized_at)
+                ->authorize(fn (Tenant $record): bool => Filament::auth()->user()?->can('update', $record) ?? false)
+                ->action(fn (Tenant $record) => AnonymizeAccount::dispatch(null, $record->id))
+                ->successNotificationTitle(__('admin.tenants.actions.anonymize_success')),
+        ];
+    }
 }

app/Filament/Resources/TenantResource/Pages/ViewTenant.php

@@ -3,9 +3,18 @@
 namespace App\Filament\Resources\TenantResource\Pages;
 
 use App\Filament\Resources\TenantResource;
+use Filament\Actions;
 use Filament\Resources\Pages\ViewRecord;
 
 class ViewTenant extends ViewRecord
 {
     protected static string $resource = TenantResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Actions\EditAction::make(),
+            ...TenantResource::lifecycleActions(),
+        ];
+    }
 }

app/Filament/Resources/TenantResource/Schemas/TenantInfolist.php

@@ -0,0 +1,188 @@
+<?php
+
+namespace App\Filament\Resources\TenantResource\Schemas;
+
+use App\Models\Tenant;
+use Filament\Infolists\Components\IconEntry;
+use Filament\Infolists\Components\RepeatableEntry;
+use Filament\Infolists\Components\TextEntry;
+use Filament\Schemas\Components\Section;
+use Filament\Schemas\Schema;
+use Illuminate\Support\Str;
+
+class TenantInfolist
+{
+    public static function configure(Schema $schema): Schema
+    {
+        return $schema->components([
+            Section::make(__('admin.tenants.sections.profile'))
+                ->columns(3)
+                ->schema([
+                    TextEntry::make('name')->label(__('admin.tenants.fields.name')),
+                    TextEntry::make('slug')->label(__('admin.tenants.fields.slug')),
+                    TextEntry::make('contact_email')->label(__('admin.tenants.fields.contact_email')),
+                    TextEntry::make('user.full_name')
+                        ->label(__('admin.tenants.fields.owner'))
+                        ->state(fn (Tenant $record) => $record->user?->full_name ?? '—'),
+                    TextEntry::make('paddle_customer_id')
+                        ->label('Paddle Customer ID')
+                        ->placeholder('—'),
+                    TextEntry::make('total_revenue')
+                        ->label(__('admin.tenants.fields.total_revenue'))
+                        ->money('EUR'),
+                    TextEntry::make('active_reseller_package_id')
+                        ->label(__('admin.tenants.fields.active_reseller_package'))
+                        ->state(fn (Tenant $record) => $record->activeResellerPackage?->name ?? '—'),
+                    TextEntry::make('remaining_events')
+                        ->label(__('admin.tenants.fields.remaining_events'))
+                        ->state(fn (Tenant $record) => $record->activeResellerPackage?->remaining_events ?? 0),
+                    TextEntry::make('package_expires_at')
+                        ->label(__('admin.tenants.fields.package_expires_at'))
+                        ->state(fn (Tenant $record) => $record->activeResellerPackage?->expires_at)
+                        ->dateTime(),
+                ]),
+            Section::make(__('admin.tenants.sections.lifecycle'))
+                ->columns(3)
+                ->schema([
+                    IconEntry::make('is_active')
+                        ->label(__('admin.tenants.fields.is_active'))
+                        ->boolean(),
+                    IconEntry::make('is_suspended')
+                        ->label(__('admin.tenants.fields.is_suspended'))
+                        ->boolean(),
+                    TextEntry::make('subscription_expires_at')
+                        ->label(__('admin.tenants.fields.subscription_expires_at'))
+                        ->dateTime()
+                        ->placeholder('—'),
+                    TextEntry::make('pending_deletion_at')
+                        ->label(__('admin.tenants.fields.pending_deletion_at'))
+                        ->dateTime()
+                        ->placeholder('—'),
+                    TextEntry::make('deletion_warning_sent_at')
+                        ->label(__('admin.tenants.fields.deletion_warning_sent_at'))
+                        ->dateTime()
+                        ->placeholder('—'),
+                    TextEntry::make('anonymized_at')
+                        ->label(__('admin.tenants.fields.anonymized_at'))
+                        ->dateTime()
+                        ->placeholder('—'),
+                ]),
+            Section::make(__('admin.tenants.sections.timeline'))
+                ->schema([
+                    RepeatableEntry::make('lifecycle_timeline')
+                        ->label(__('admin.tenants.sections.timeline'))
+                        ->state(fn (Tenant $record) => static::buildTimeline($record))
+                        ->schema([
+                            TextEntry::make('title')
+                                ->label(__('admin.tenants.timeline.title'))
+                                ->columnSpanFull(),
+                            TextEntry::make('details')
+                                ->label(__('admin.tenants.timeline.details'))
+                                ->columnSpanFull()
+                                ->placeholder('—'),
+                            TextEntry::make('tone')
+                                ->label(__('admin.tenants.timeline.status'))
+                                ->badge()
+                                ->color(fn (?string $state) => $state ?? 'gray')
+                                ->formatStateUsing(fn (?string $state) => $state
+                                    ? __('admin.tenants.timeline.tone.'.$state)
+                                    : __('admin.tenants.timeline.tone.muted')),
+                            TextEntry::make('occurred_at')
+                                ->label(__('admin.tenants.timeline.occurred_at'))
+                                ->dateTime(),
+                        ])
+                        ->columns(2),
+                ]),
+        ]);
+    }
+
+    private static function buildTimeline(Tenant $tenant): array
+    {
+        $events = [
+            static::timelineEntry(
+                __('admin.tenants.timeline.created'),
+                __('admin.tenants.timeline.created_details'),
+                $tenant->created_at,
+                'success'
+            ),
+        ];
+
+        if ($tenant->last_activity_at) {
+            $events[] = static::timelineEntry(
+                __('admin.tenants.timeline.last_activity'),
+                __('admin.tenants.timeline.last_activity_details'),
+                $tenant->last_activity_at,
+                'info'
+            );
+        }
+
+        if ($tenant->deletion_warning_sent_at) {
+            $events[] = static::timelineEntry(
+                __('admin.tenants.timeline.deletion_warning'),
+                __('admin.tenants.timeline.deletion_warning_details'),
+                $tenant->deletion_warning_sent_at,
+                'warning'
+            );
+        }
+
+        if ($tenant->pending_deletion_at) {
+            $events[] = static::timelineEntry(
+                __('admin.tenants.timeline.deletion_scheduled'),
+                __('admin.tenants.timeline.deletion_scheduled_details'),
+                $tenant->pending_deletion_at,
+                'warning'
+            );
+        }
+
+        if ($tenant->anonymized_at) {
+            $events[] = static::timelineEntry(
+                __('admin.tenants.timeline.anonymized'),
+                __('admin.tenants.timeline.anonymized_details'),
+                $tenant->anonymized_at,
+                'danger'
+            );
+        }
+
+        $logs = $tenant->notificationLogs()
+            ->latest('sent_at')
+            ->limit(10)
+            ->get();
+
+        foreach ($logs as $log) {
+            $status = $log->status === 'failed' ? 'danger' : 'info';
+            $eventTitle = $log->status === 'failed'
+                ? __('admin.tenants.timeline.notification_failed')
+                : __('admin.tenants.timeline.notification_sent');
+
+            $details = collect([
+                Str::headline($log->type),
+                $log->channel ? Str::upper($log->channel) : null,
+                $log->recipient,
+                $log->failure_reason ? 'reason: '.$log->failure_reason : null,
+            ])->filter()->implode(' - ');
+
+            $events[] = static::timelineEntry(
+                $eventTitle,
+                $details,
+                $log->sent_at ?? $log->failed_at ?? $log->created_at,
+                $status
+            );
+        }
+
+        return collect($events)
+            ->filter(fn (array $event) => $event['occurred_at'] !== null)
+            ->sortByDesc('occurred_at')
+            ->values()
+            ->all();
+    }
+
+    private static function timelineEntry(string $title, ?string $details, $occurredAt, string $tone): array
+    {
+        return [
+            'title' => $title,
+            'details' => $details,
+            'occurred_at' => $occurredAt,
+            'tone' => $tone,
+        ];
+    }
+}

app/Models/Tenant.php

@@ -25,6 +25,9 @@ class Tenant extends Model
         'settings' => 'array',
         'notification_preferences' => 'array',
         'last_activity_at' => 'datetime',
+        'anonymized_at' => 'datetime',
+        'pending_deletion_at' => 'datetime',
+        'deletion_warning_sent_at' => 'datetime',
         'total_revenue' => 'decimal:2',
         'settings_updated_at' => 'datetime',
         'subscription_expires_at' => 'datetime',