feat(manage/media): let some roles wipe all game screenshots

app/Filament/Pages/ResourceAuditLog.php

@@ -175,6 +175,7 @@ protected function getEventColor(string $event): string
         return match ($event) {
             'approvedScreenshot' => 'success',
             'changedScreenshotType' => 'info',
+            'clearedScreenshots' => 'danger',
             'created' => 'success',
             'creditCreated' => 'success',
             'creditDeleted' => 'danger',

app/Filament/Resources/GameResource/RelationManagers/GameScreenshotsRelationManager.php

@@ -8,6 +8,7 @@
 use App\Models\GameScreenshot;
 use App\Models\User;
 use App\Platform\Actions\AddGameScreenshotAction;
+use App\Platform\Actions\ClearGameScreenshotsFromGamePageAction;
 use App\Platform\Enums\GameScreenshotStatus;
 use App\Platform\Enums\ScreenshotType;
 use App\Rules\DisallowAnimatedImageRule;
@@ -16,6 +17,7 @@
 use Filament\Actions\Action;
 use Filament\Actions\ActionGroup;
 use Filament\Actions\DeleteAction;
+use Filament\Actions\RestoreAction;
 use Filament\Forms;
 use Filament\Notifications\Notification;
 use Filament\Resources\RelationManagers\RelationManager;
@@ -64,6 +66,9 @@ public function table(Table $table): Table
         /** @var Game $game */
         $game = $this->getOwnerRecord();
 
+        /** @var User $user */
+        $user = Auth::user();
+
         return $table
             ->headerActions([
                 Action::make('upload_screenshot')
@@ -139,14 +144,42 @@ public function table(Table $table): Table
                             ->title("{$label} uploaded successfully")
                             ->send();
                     }),
+
+                ActionGroup::make([
+                    Action::make('clear_screenshots_from_game_page')
+                        ->label('Clear Screenshots')
+                        ->icon('heroicon-o-trash')
+                        ->color('danger')
+                        ->requiresConfirmation()
+                        ->modalHeading("Clear this game's screenshots?")
+                        ->modalDescription('All screenshots will be moved to the trash and the game will use placeholder images. You can restore them later.')
+                        ->modalSubmitActionLabel('Clear Screenshots')
+                        ->action(function () use ($game): void {
+                            $clearedCount = (new ClearGameScreenshotsFromGamePageAction())->execute($game);
+
+                            $this->logScreenshotActivity($game)
+                                ->event('clearedScreenshots')
+                                ->log("Cleared {$clearedCount} screenshot(s)");
+
+                            Notification::make()
+                                ->success()
+                                ->title('Screenshots cleared')
+                                ->send();
+                        }),
+                ])
+                    ->label('More')
+                    ->icon('heroicon-m-ellipsis-vertical')
+                    ->iconButton()
+                    ->tooltip('More actions')
+                    ->visible(fn (): bool => $user->can('clearScreenshots', $game) && $game->gameScreenshots()->exists()),
             ])
             ->modifyQueryUsing(function (Builder $query) {
                 /** @var Builder<GameScreenshot> $query */
                 $query->with(['media', 'game.system'])
                     ->orderByType()
                     ->orderBy('order_column');
 
-                if (!$this->shouldShowArchivedScreenshots()) {
+                if (!$this->shouldShowRejectedOrReplacedScreenshots()) {
                     $query->whereNotIn('status', [
                         GameScreenshotStatus::Rejected->value,
                         GameScreenshotStatus::Replaced->value,
@@ -212,6 +245,11 @@ public function table(Table $table): Table
                     )
                     ->color(fn (GameScreenshot $record): ?string => $record->has_wrong_resolution ? 'danger' : null)
                     ->icon(fn (GameScreenshot $record): ?string => $record->has_wrong_resolution ? 'heroicon-o-exclamation-triangle' : null),
+
+                Tables\Columns\TextColumn::make('deleted_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
             ])
             ->filters([
                 Tables\Filters\SelectFilter::make('type')
@@ -223,6 +261,11 @@ public function table(Table $table): Table
                     ->placeholder('Published + Pending')
                     ->options(fn (): array => $this->getStatusFilterOptions()),
 
+                Tables\Filters\TrashedFilter::make()
+                    ->label('Deleted screenshots')
+                    ->placeholder('Current screenshots')
+                    ->trueLabel('All screenshots')
+                    ->falseLabel('Deleted screenshots'),
             ])
             ->emptyStateHeading('No screenshots yet')
             ->emptyStateDescription('Upload screenshots using the button above.')
@@ -234,7 +277,7 @@ public function table(Table $table): Table
                     ->iconButton()
                     ->tooltip('Set as Primary')
                     ->requiresConfirmation()
-                    ->hidden(fn (GameScreenshot $record): bool => $record->is_primary)
+                    ->hidden(fn (GameScreenshot $record): bool => $record->is_primary || $record->trashed())
                     ->action(function (GameScreenshot $record) use ($game): void {
                         DB::transaction(function () use ($record) {
                             // Demote the current primary of the same type via Eloquent
@@ -269,7 +312,7 @@ public function table(Table $table): Table
                         ->label('Approve')
                         ->icon('heroicon-o-check-circle')
                         ->color('success')
-                        ->visible(fn (GameScreenshot $record): bool => $record->status !== GameScreenshotStatus::Approved)
+                        ->visible(fn (GameScreenshot $record): bool => !$record->trashed() && $record->status !== GameScreenshotStatus::Approved)
                         ->action(function (GameScreenshot $record) use ($game): void {
                             $oldStatus = $record->status;
 
@@ -288,6 +331,7 @@ public function table(Table $table): Table
                     Action::make('change_type')
                         ->label('Change Type')
                         ->icon('heroicon-o-tag')
+                        ->visible(fn (GameScreenshot $record): bool => !$record->trashed())
                         ->schema([
                             Forms\Components\Select::make('type')
                                 ->label('Type')
@@ -320,7 +364,7 @@ public function table(Table $table): Table
                         ->icon('heroicon-o-x-circle')
                         ->color('danger')
                         ->requiresConfirmation()
-                        ->visible(fn (GameScreenshot $record): bool => !$record->is_primary && $record->status !== GameScreenshotStatus::Rejected)
+                        ->visible(fn (GameScreenshot $record): bool => !$record->trashed() && !$record->is_primary && $record->status !== GameScreenshotStatus::Rejected)
                         ->action(function (GameScreenshot $record) use ($game): void {
                             $oldStatus = $record->status;
 
@@ -344,14 +388,15 @@ public function table(Table $table): Table
                         ->requiresConfirmation()
                         ->modalDescription(fn (GameScreenshot $record): string => $record->is_primary
                             ? 'This is a primary screenshot. The next published screenshot of this type will be promoted automatically, or the placeholder will be restored.'
-                            : 'Are you sure you want to delete this screenshot?')
+                            : 'Are you sure you want to permanently delete this screenshot?')
                         ->using(function (GameScreenshot $record) use ($game): void {
                             $screenshotUrl = $record->media?->getUrl();
+                            $media = $record->media;
                             $type = $record->type->label();
                             $wasPrimary = $record->is_primary;
 
-                            $record->media?->delete();
-                            $record->delete();
+                            $record->forceDelete();
+                            $media?->delete();
 
                             $this->logScreenshotActivity($game)
                                 ->withProperty('attributes', [
@@ -362,6 +407,8 @@ public function table(Table $table): Table
                                 ->event('deletedScreenshot')
                                 ->log('Deleted screenshot');
                         }),
+
+                    RestoreAction::make(),
                 ]),
             ]);
     }
@@ -382,8 +429,11 @@ private function getStatusFilterOptions(): array
         $game = $this->getOwnerRecord();
 
         $selectedType = data_get($this->getTableFilterState('type'), 'value');
+        $selectedTrashed = $this->getSelectedTrashedFilter();
 
         $counts = $game->gameScreenshots()
+            ->when($selectedTrashed === true, fn (Builder $query) => $query->withTrashed())
+            ->when($selectedTrashed === false, fn (Builder $query) => $query->onlyTrashed())
             ->when($selectedType, fn (Builder $query) => $query->where('type', $selectedType))
             ->whereIn('status', [
                 GameScreenshotStatus::Approved->value,
@@ -475,13 +525,29 @@ private function getScreenshotHelperText(): ?string
         return $text;
     }
 
-    private function shouldShowArchivedScreenshots(): bool
+    private function shouldShowRejectedOrReplacedScreenshots(): bool
     {
+        if ($this->getSelectedTrashedFilter() === false) {
+            return true;
+        }
+
         $selectedStatus = data_get($this->getTableFilterState('status'), 'value');
 
         return in_array($selectedStatus, [
             GameScreenshotStatus::Rejected->value,
             GameScreenshotStatus::Replaced->value,
         ], true);
     }
+
+    /**
+     * Normalize the trashed filter state to a tri-state value.
+     * Filament serializes booleans as '1'/'0' through the form layer,
+     * so === true / === false comparisons against the raw value silently fail.
+     */
+    private function getSelectedTrashedFilter(): ?bool
+    {
+        $value = data_get($this->getTableFilterState('trashed'), 'value');
+
+        return filter_var($value, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
+    }
 }

app/Models/GameScreenshot.php

@@ -15,13 +15,15 @@
 use Illuminate\Database\Eloquent\Casts\Attribute;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
 use Spatie\EloquentSortable\SortableTrait;
 use Spatie\MediaLibrary\MediaCollections\Models\Media;
 
 class GameScreenshot extends BaseModel
 {
     /** @use HasFactory<GameScreenshotFactory> */
     use HasFactory;
+    use SoftDeletes;
     use SortableTrait;
 
     protected $table = 'game_screenshots';

app/Platform/Actions/ClearGameScreenshotsFromGamePageAction.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Platform\Actions;
+
+use App\Models\Game;
+use App\Models\GameScreenshot;
+use App\Platform\Enums\ScreenshotType;
+use Illuminate\Support\Facades\DB;
+
+class ClearGameScreenshotsFromGamePageAction
+{
+    public function execute(Game $game): int
+    {
+        return DB::transaction(function () use ($game): int {
+            $screenshotIds = $game->gameScreenshots()
+                ->pluck('id');
+
+            if ($screenshotIds->isEmpty()) {
+                return 0;
+            }
+
+            GameScreenshot::whereKey($screenshotIds)
+                ->update(['is_primary' => false]);
+
+            $deletedCount = GameScreenshot::whereKey($screenshotIds)
+                ->delete();
+
+            $game->syncLegacyScreenshotFields(ScreenshotType::Title);
+            $game->syncLegacyScreenshotFields(ScreenshotType::Ingame);
+
+            return $deletedCount;
+        });
+    }
+}

app/Platform/Services/GameScreenshotValidationService.php

@@ -75,7 +75,10 @@ public function validateHash(UploadedFile $file, Game $game): string
         $hash = sha1_file($file->getRealPath());
 
         // Reject duplicates based on SHA1 within this game's non-rejected screenshots.
+        // Trashed screenshots are included so that re-uploading a cleared screenshot
+        // can't bypass the check and create a collision when the original is restored.
         $isDuplicate = $game->gameScreenshots()
+            ->withTrashed()
             ->where('status', '!=', GameScreenshotStatus::Rejected)
             ->whereHas('media', function ($query) use ($hash) {
                 $query->where('custom_properties->sha1', $hash);

app/Policies/GamePolicy.php

@@ -262,6 +262,15 @@ public function updateField(User $user, Game $game, string $fieldName): bool
         return in_array($fieldName, $allowedFieldsForUser, true);
     }
 
+    public function clearScreenshots(User $user, Game $game): bool
+    {
+        return $user->hasAnyRole([
+            Role::ADMINISTRATOR,
+            Role::GAME_EDITOR,
+            Role::MEDIA_EDITOR,
+        ]);
+    }
+
     public static function canDeveloperJuniorUpdateGame(User $user, Game $game): bool
     {
         // If the user has a DEVELOPER_JUNIOR role, they need to have a claim

database/migrations/2026_05_03_000000_add_deleted_at_to_game_screenshots_table.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up(): void
+    {
+        Schema::table('game_screenshots', function (Blueprint $table) {
+            $table->softDeletes()->after('updated_at');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('game_screenshots', function (Blueprint $table) {
+            $table->dropSoftDeletes();
+        });
+    }
+};

lang/en/filament.php

@@ -16,6 +16,7 @@
             'achievementsAssignedToGroup' => 'Achievements assigned to group',
             'approvedScreenshot' => 'Approved screenshot',
             'changedScreenshotType' => 'Changed screenshot type',
+            'clearedScreenshots' => 'Cleared screenshots',
             'created' => 'Created',
             'creditCreated' => 'Credit added',
             'creditDeleted' => 'Credit removed',