++ consolidamento funzionalità Backup

app/Jobs/CreateBackupArchive.php

@@ -87,6 +87,25 @@ class CreateBackupArchive implements ShouldQueue
         $stato->markCompleted($this->operationId, $risultato);
     }
 
+    /**
+     * Chiamato da Laravel quando il job muore per cause che handle() non puo'
+     * intercettare: il timeout del worker (che uccide il processo), un errore
+     * fatale, una dipendenza non risolvibile.
+     *
+     * Senza, l'operazione resterebbe "in corso" e terrebbe occupato il posto
+     * unico fino alla scadenza del puntatore: un'ora in cui nessuno puo'
+     * avviare un backup e la pagina mostra una barra che non avanzera' mai.
+     */
+    public function failed(?\Throwable $e): void
+    {
+        app(BackupOperationState::class)->markFailed(
+            $this->operationId,
+            $e?->getMessage() ?: 'Creazione del backup interrotta (timeout o errore del worker).'
+        );
+
+        @unlink(self::percorso($this->operationId));
+    }
+
     public static function percorso(string $operationId): string
     {
         return storage_path('app/backups/' . $operationId . '.zip');