++ add reset program

This commit is contained in:
2026-07-29 14:26:36 +02:00
parent c6abef977d
commit 588910b893
14 changed files with 1524 additions and 183 deletions

View File

@@ -3,61 +3,79 @@
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Livewire\Settings\XmlExchange;
use App\Services\BackupArchive;
use App\Jobs\CreateBackupArchive;
use App\Jobs\RestoreBackupArchive;
use App\Services\BackupOperationState;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Str;
/**
* Backup e ripristino dell'intera applicazione in un unico pacchetto .zip:
* dati gestionali, utenti e file caricati.
* Trasferimento dei file di backup: consegna dell'archivio prodotto e
* ricezione di quello da ripristinare.
*
* Non e' un componente Livewire come il resto della pagina Import: lo scarico
* di un Livewire streamDownload passa il file base64 dentro la risposta JSON,
* e un archivio con tutti i PDF dei territori non ci sta. Sono due rotte HTTP
* normali, gia' protette da `settings.manage` nel gruppo di rotte.
* Non e' un componente Livewire come il resto della pagina: lo `streamDownload`
* di Livewire passa il file base64 dentro la risposta JSON, e un archivio con
* tutti i PDF dei territori non ci sta. L'avvio delle operazioni e la barra di
* avanzamento vivono invece in Livewire\Settings\BackupManager, che interroga
* BackupOperationState. Entrambe le rotte sono nel gruppo `settings.manage`.
*/
class BackupController extends Controller
{
public function __construct(
private readonly BackupArchive $archive,
private readonly BackupOperationState $stato,
) {
}
/**
* Tetto di tempo per comprimere/estrarre un archivio con molti PDF.
* Sopra c'e' comunque `fastcgi_read_timeout 300` in docker/nginx/
* default.conf: alzare questo valore da solo non serve a nulla.
* Consegna l'archivio prodotto da un'operazione di backup e annota che e'
* stato servito.
*
* L'annotazione e' meta' del blocco che protegge l'azzeramento: senza un
* `servito_at` il pulsante di conferma rifiuta di procedere, quindi non
* esiste una strada che cancelli i dati senza che l'archivio sia almeno
* uscito dal server. L'altra meta' e' la conferma umana in
* BackupManager::confermaAzzeramento().
*
* Il completamento del trasferimento *non* e' verificabile da qui: con
* `fastcgi_buffering on` (il default, e docker/nginx/default.conf non lo
* disattiva) nginx accetta l'intera risposta dal processo PHP e la inoltra
* per conto suo. PHP finisce di scrivere e prosegue anche se il browser ha
* chiuso la connessione al primo byte, quindi far scattare l'azzeramento
* "dopo l'ultimo byte" azzererebbe anche su un download annullato.
*/
private const SECONDI_MAX = 300;
public function download(XmlExchange $exchange)
public function file(string $operationId)
{
set_time_limit(self::SECONDI_MAX);
$operazione = $this->stato->get($operationId);
$path = $this->archive->create($exchange->currentXmlBackup());
abort_if($operazione === null, 404, 'Backup non piu\' disponibile: rigeneralo.');
$name = 'termanager2-backup-' . now()->format('Ymd-His') . '.zip';
$percorso = CreateBackupArchive::percorso($operationId);
abort_unless(is_file($percorso), 404, 'Archivio di backup non trovato: rigeneralo.');
$nome = $operazione['result']['nome_download'] ?? 'termanager2-backup.zip';
$this->stato->update($operationId, function (array $state) {
$state['result']['servito_at'] = now()->toDateTimeString();
return $state;
});
return response()
->download($path, $name, ['Content-Type' => 'application/zip'])
->deleteFileAfterSend(true);
->download($percorso, $nome, [
'Content-Type' => 'application/zip',
'Content-Length' => (string) filesize($percorso),
]);
}
/**
* Ripristina un pacchetto di backup.
* Riceve il pacchetto da ripristinare e mette in coda il lavoro.
*
* Ordine deliberato: i file vengono prima estratti in staging (cosi' un
* archivio corrotto fallisce mentre i dati correnti sono ancora intatti),
* poi si riscrive il database in transazione, poi si sostituiscono i file.
* L'inverso lascerebbe il disco pieno di file di un'installazione e il
* database di un'altra.
* Risponde JSON perche' il form viene inviato via XMLHttpRequest: e' l'unico
* modo di avere una barra di caricamento reale sull'upload, che per un
* archivio di centinaia di MB e' la parte piu' lunga dell'operazione.
*/
public function restore(Request $request, XmlExchange $exchange)
public function upload(Request $request)
{
set_time_limit(self::SECONDI_MAX);
// 256 MB e' il tetto reale della pila, non una scelta di questa
// validazione: piu' in su intervengono prima `client_max_body_size` di
// nginx e `upload_max_filesize`/`post_max_size` di PHP, che rifiutano
@@ -70,68 +88,29 @@ class BackupController extends Controller
'backupZip.max' => 'Il pacchetto supera i 256 MB accettati dal server.',
]);
$staging = null;
$operationId = (string) Str::uuid();
try {
$extracted = $this->archive->extract($request->file('backupZip')->getRealPath());
$staging = $extracted['staging'];
$result = $exchange->importXmlFromContent($extracted['xml']);
if (isset($result['error'])) {
return back()->withErrors(['backupZip' => $result['error']]);
}
$fileCount = $this->archive->restoreFiles($staging);
$utentiBloccati = $this->requirePasswordChangeForEveryone();
} catch (\Throwable $e) {
Log::error('Ripristino del backup non riuscito.', ['exception' => $e]);
return back()->withErrors(['backupZip' => $e->getMessage()]);
} finally {
if ($staging !== null) {
$this->archive->deleteDirectory($staging);
}
}
$stats = $result['stats'];
$message = sprintf(
'Ripristino completato: %d territori, %d proclamatori, %d assegnazioni e %d file ripristinati. '
. 'Per sicurezza tutti i %d account devono impostare una nuova password.',
$stats['territori_importati'] ?? 0,
$stats['proclamatori_importati'] ?? 0,
$stats['assegnazioni_importate'] ?? 0,
$fileCount,
$utentiBloccati
// Il file dell'upload vive in una cartella temporanea che sparisce a
// fine richiesta: il job lo troverebbe gia' cancellato.
$percorso = $request->file('backupZip')->storeAs(
'backup-restore-in',
$operationId . '.zip',
'local'
);
return redirect()->route('password.change')
->with('success', $message)
->with('importStats', $stats)
->with('importIssues', $result['issues']);
}
$this->stato->initialize(
$operationId,
BackupOperationState::TIPO_RESTORE,
'In coda'
);
$this->stato->log($operationId, 'Archivio ricevuto. In attesa del worker di coda.');
/**
* Blocca ogni account finche' non sceglie una password nuova,
* l'amministratore che sta ripristinando compreso.
*
* Il pacchetto contiene gli hash bcrypt di tutti gli utenti: chi ha avuto
* il file fra le mani ha potuto tentarne il crack con calma, quindi dopo un
* ripristino nessuna delle vecchie password si puo' considerare segreta.
* Anche i remember_token vengono azzerati: sono credenziali persistenti a
* tutti gli effetti e stanno pure loro nel backup.
*
* Scritto con il query builder di proposito — un update di massa su
* Eloquent qui non aggiungerebbe nulla e toccherebbe updated_at su tutte le
* righe appena importate con i loro timestamp originali.
*/
private function requirePasswordChangeForEveryone(): int
{
return DB::table('users')->update([
'password_change_required' => true,
'remember_token' => null,
]);
RestoreBackupArchive::dispatch(
$operationId,
storage_path('app/' . $percorso),
(int) auth()->id()
);
return response()->json(['operation_id' => $operationId]);
}
}