SXXXXXXX_BackupTools/doc/Italian-manual.md

Backup Manager Pro - Manuale Italiano

1. Introduzione

Benvenuto in Backup Manager Pro! Questa applicazione ti aiuta a creare archivi di backup compressi (file ZIP) delle tue cartelle importanti, con opzioni flessibili per escludere file e gestire diversi profili di backup.

2. Panoramica dell'Interfaccia Principale

La finestra principale di Backup Manager Pro è suddivisa in diverse sezioni:

• Gestione Profili: Carica, salva ed elimina profili di backup. Un profilo memorizza una configurazione specifica (sorgente, destinazione, esclusioni, descrizione).
• Cartella Sorgente: La cartella di cui vuoi effettuare il backup.
• Cartella Destinazione: La cartella in cui verrà salvato il file ZIP di backup.
• Esclusioni File: Un elenco di pattern separati da virgola per escludere file dal backup.
• Descrizione Backup: Una descrizione opzionale che verrà salvata all'interno dell'archivio di backup.
• Pulsante Azione: "Analizza e Crea Backup" avvia il processo.
• Barra di Progresso e Stato: Mostra l'avanzamento delle operazioni di scansione e backup.

3. Iniziare: Il Tuo Primo Backup

1. Avvia Backup Manager Pro.
2. Seleziona Cartella Sorgente:
   • Clicca il pulsante "Sfoglia..." accanto a "Cartella Sorgente".
   • Naviga e seleziona la cartella di cui desideri eseguire il backup.
   • Esempio: C:\Utenti\TuoNome\Documenti\Progetti
3. Seleziona Cartella Destinazione:
   • Clicca il pulsante "Sfoglia..." accanto a "Cartella Destinazione".
   • Scegli una cartella in cui verrà creato il file ZIP di backup.
   • Esempio: D:\Backup
4. Configura Esclusioni File (Opzionale):
   • Nell'area di testo "Esclusioni File", inserisci i pattern per i file o i tipi di file che vuoi escludere, separati da virgole.
   • Il testo andrà a capo automaticamente se è lungo.
   • Esempi:
     • Per escludere tutti i file di log e i file temporanei: .log, .tmp, *.bak
     • Per escludere una cartella specifica chiamata build all'interno della sorgente: build/ (usa barre oblique per i percorsi)
     • Per escludere tutti i file che iniziano con temp_: temp_*
   • Dopo aver digitato le tue esclusioni, clicca il pulsante "Aggiorna Lista Esclusioni" per elaborarle e applicarle. Questo riformatterà anche la visualizzazione nell'area di testo.
5. Aggiungi una Descrizione del Backup (Opzionale):
   • Digita una breve descrizione nell'area di testo "Descrizione Backup" (es., "Backup settimanale dei file ProgettoMio"). Questo aiuta a identificare il backup in seguito.
6. Avvia il Processo di Backup:
   • Clicca il pulsante "Analizza e Crea Backup".
   • L'applicazione eseguirà prima una scansione della cartella sorgente per determinare quali file includere ed escludere. L'avanzamento sarà visualizzato.
7. Conferma Backup:
   • Apparirà una finestra di conferma che mostra il numero di file e la dimensione totale del backup.
   • Puoi cliccare su:
     • "Dettagli Lista File": Per vedere un elenco dettagliato di tutti i file inclusi ed esclusi.
     • "Stat. Est. Incluse": Per vedere statistiche (conteggio e dimensione) dei file inclusi, raggruppati per estensione.
     • "Stat. Est. Escluse": Per vedere statistiche dei file esclusi, raggruppati per estensione.
     • "Procedi con Backup": Per iniziare a creare l'archivio ZIP.
     • "Annulla": Per interrompere il backup.
8. Creazione del Backup:
   • Se procedi, l'applicazione creerà il file ZIP nella cartella di destinazione. La barra di progresso mostrerà il processo di compressione.
   • Il file ZIP sarà nominato con una marca temporale e il nome della cartella sorgente (es., 20240507_153000_Progetti.zip).
9. Completamento:
   • Un messaggio ti informerà se il backup è stato completato con successo o se si sono verificati errori.

4. Utilizzo dei Profili

I profili ti consentono di salvare e ricaricare rapidamente diverse configurazioni di backup.

4.1. Salvare un Profilo

1. Configura la Cartella Sorgente, la Cartella Destinazione, le Esclusioni e la Descrizione come desiderato.
2. Assicurati che le tue esclusioni siano aggiornate cliccando "Aggiorna Lista Esclusioni" se hai apportato modifiche nell'area di testo.
3. Clicca il pulsante "Salva Corrente come Profilo".
4. Una finestra di dialogo chiederà un nome per il profilo.
   • Se hai un profilo già selezionato nel menu a tendina "Profilo Attivo", il suo nome verrà suggerito. Puoi usarlo per aggiornare il profilo esistente o digitare un nuovo nome.
   • Inserisci un nome univoco (es., "Backup_Documenti_Lavoro").
5. Clicca "OK".
   • Se il nome esiste già (ed è diverso da un profilo attualmente selezionato che stai aggiornando), ti verrà chiesto di confermare la sovrascrittura.
   • Il profilo verrà salvato e diventerà il profilo attivo nel menu a tendina.

4.2. Caricare un Profilo

1. Clicca il menu a tendina "Profilo Attivo".
2. Seleziona il nome del profilo desiderato dalla lista.
3. I campi Sorgente, Destinazione, Esclusioni e Descrizione si popoleranno automaticamente con le impostazioni del profilo selezionato.

4.3. Eliminare un Profilo

1. Seleziona il profilo che desideri eliminare dal menu a tendina "Profilo Attivo".
2. Clicca il pulsante "Elimina Profilo Selezionato".
3. Conferma l'eliminazione quando richiesto.
   • Il profilo verrà rimosso dalla lista. I campi dell'interfaccia utente verranno tipicamente reimpostati ai valori predefiniti globali o svuotati.

5. Gestione delle Esclusioni File

• Formato Input: Inserisci i pattern di esclusione nell'area di testo, separati da virgole (es., .obj, *.tmp, node_modules/).
• Aggiornamento della Lista: Dopo aver digitato o modificato i pattern nell'area di testo, devi cliccare il pulsante "Aggiorna Lista Esclusioni". Questa azione:
  1. Analizza il tuo input.
  2. Rimuove eventuali pattern vuoti derivanti da virgole o spazi extra.
  3. Rimuove i pattern duplicati.
  4. Ordina i pattern alfabeticamente.
  5. Aggiorna la lista interna delle esclusioni che verrà utilizzata per il backup.
  6. Ricarica l'area di testo per mostrare la lista pulita e formattata (usando ", " come separatore).
• Esempi di Pattern:
  • .exe: Esclude tutti i file con estensione .exe.
  • *.log: Esclude tutti i file che terminano con .log.
  • temp/: Esclude qualsiasi cartella chiamata temp e il suo contenuto a qualsiasi livello all'interno della sorgente. (Nota: assicurati che la logica di scansione gestisca correttamente i pattern di directory).
  • output_*.dat: Esclude file come output_01.dat, output_final.dat.

6. Note

• La configurazione dell'applicazione, inclusi i profili e le ultime impostazioni utilizzate, viene salvata in un file backup_config.json situato nella stessa directory dell'eseguibile dell'applicazione (o nella directory principale dello script se eseguito dal codice sorgente).
• Le operazioni lunghe come la scansione dei file e la compressione ZIP vengono eseguite in background per mantenere reattiva l'applicazione. Attendi il loro completamento.
• Se la cartella di destinazione per il backup non esiste, l'applicazione tenterà di crearla.

Grazie per aver utilizzato Backup Manager Pro!