# SafeVault - Guida Utente

## 🎯 Benvenuto in SafeVault!

Questa guida ti aiuterà a utilizzare SafeVault al meglio per gestire le tue password in modo sicuro.

## 📝 Registrazione

### Primo Accesso

1. Visita la pagina di SafeVault sul tuo browser
2. Clicca su **"Registrati qui"**
3. Compila il form di registrazione:
   - **Username**: Scegli un nome utente unico (3-50 caratteri)
   - **Email**: Inserisci la tua email valida
   - **Password**: Crea una password forte (minimo 8 caratteri)
   - **Conferma Password**: Ripeti la password

### Suggerimenti per la Password del Tuo Account

✅ **Usa una password forte**:
- Almeno 12 caratteri
- Combina maiuscole e minuscole
- Aggiungi numeri (0-9)
- Includi simboli (!@#$%^&*)

✅ **Esempi di password forti**:
- `MyS@feV4ult2025!`
- `P@ssw0rd!Secure#123`
- `Tr0v@t0r3!DiPassword`

❌ **Evita**:
- Password ovvie (123456, password, qwerty)
- Informazioni personali (nome, data di nascita)
- Parole del dizionario

### Indicatore Forza Password

Durante la registrazione, vedrai un indicatore che mostra:
- 🔴 **Molto debole** / **Debole**: Migliora la password
- 🟡 **Media**: Accettabile ma può essere migliorata
- 🟢 **Forte** / **Molto forte**: Ottima scelta!

## 🔐 Login

1. Dalla homepage, inserisci:
   - **Username o Email**: Puoi usare uno dei due
   - **Password**: La password che hai scelto

2. Clicca **"Accedi"**

3. Se le credenziali sono corrette, sarai reindirizzato alla Dashboard

### Problemi di Login?

- ❌ **"Username o password non corretti"**
  - Verifica di aver inserito i dati corretti
  - Controlla il CAPS LOCK
  - La password è case-sensitive (maiuscole/minuscole)

## 🎨 Dashboard

La Dashboard è il cuore di SafeVault. Qui puoi:

### Statistiche in Alto

- 📊 **Credenziali Salvate**: Numero totale di password memorizzate
- 🛡️ **Sicurezza**: Livello di sicurezza del sistema
- 🔐 **Crittografia**: Tipo di crittografia usata (AES-256)

### Barra di Navigazione

- **SafeVault**: Logo/nome dell'app
- **Ciao, [Nome]**: Il tuo username
- **Info**: Vai alla pagina informazioni
- **Esci**: Logout sicuro

## ➕ Aggiungere una Nuova Credenziale

### Passo per Passo

1. Clicca sul pulsante **"+ Aggiungi Nuova Credenziale"**

2. Si aprirà un modal con il form. Compila i campi:

   **📌 Campi Obbligatori:**
   - **Nome Servizio**: Es. "Gmail", "Facebook", "Netflix"
   - **Username/Email**: Il tuo username o email per quel servizio
   - **Password**: La password del servizio

   **📌 Campi Opzionali:**
   - **URL**: Link al sito (es. https://www.gmail.com)
   - **Note**: Eventuali note aggiuntive

3. **Generare una Password Sicura** (consigliato):
   - Clicca il pulsante verde **"Genera"**
   - Verrà creata una password casuale di 16 caratteri
   - Copia e usa questa password quando crei l'account sul servizio

4. Clicca **"Salva"**

5. La credenziale apparirà nella tabella sottostante

### Esempio Pratico

```
Nome Servizio: Gmail
Username: mario.rossi@gmail.com
Password: [Clicca "Genera"] → aB9#xK2$mP4&qR7@
URL: https://mail.google.com
Note: Account personale principale
```

## 👁️ Visualizzare le Password

### Nella Tabella

Le password sono nascoste per sicurezza (`••••••••`).

Per vederle:
1. Clicca sull'icona 👁️ (occhio) accanto alla password
2. La password diventerà visibile
3. Clicca di nuovo per nasconderla

### Copiare la Password

1. Clicca sull'icona 📋 (clipboard) accanto alla password
2. Vedrai un messaggio: "Password copiata negli appunti!"
3. Vai sul sito e incolla (Ctrl+V / Cmd+V)

⚠️ **Sicurezza**: La password copiata rimane negli appunti finché non copi altro. Assicurati di incollarla subito e poi svuota gli appunti se necessario.

## ✏️ Modificare una Credenziale

1. Trova la credenziale nella tabella
2. Clicca su **"Modifica"** nella colonna Azioni
3. Si apre il modal con i dati esistenti pre-compilati
4. Modifica i campi che vuoi cambiare
   - Se NON vuoi cambiare la password, lascia il campo vuoto
   - Se vuoi una nuova password, inseriscila o usa "Genera"
5. Clicca **"Salva"**

## 🗑️ Eliminare una Credenziale

1. Trova la credenziale nella tabella
2. Clicca su **"Elimina"** (rosso) nella colonna Azioni
3. Conferma l'eliminazione nel dialog
4. La credenziale sarà rimossa definitivamente

⚠️ **Attenzione**: L'eliminazione è permanente e non può essere annullata!

## 🔑 Generatore di Password

Il generatore crea password sicure con:
- **Lunghezza**: 16 caratteri
- **Maiuscole**: A-Z
- **Minuscole**: a-z
- **Numeri**: 0-9
- **Simboli**: !@#$%^&*()_+-=[]{}|

### Come Usarlo

1. Nel form di aggiunta/modifica credenziale
2. Clicca **"Genera"** accanto al campo Password
3. Una password casuale apparirà nel campo
4. Puoi cliccare più volte per generare nuove password
5. Quando sei soddisfatto, salva la credenziale

### Esempio di Password Generate

```
aB9#xK2$mP4&qR7@
Xm3!pL9@nV5#dQ2$
F8&tH5$wR2!kJ9@z
```

## 🔒 Logout

### Come Uscire in Sicurezza

1. Clicca sul pulsante rosso **"Esci"** in alto a destra
2. Sarai disconnesso immediatamente
3. Verrai reindirizzato alla pagina di login

### Quando Fare Logout

✅ **Sempre** quando:
- Hai finito di usare SafeVault
- Lasci il computer incustodito
- Sei su un computer condiviso/pubblico
- Termini la tua sessione di lavoro

❌ **Mai** lasciare SafeVault aperto se:
- Ti allontani dal computer
- Qualcun altro può accedere al tuo device

## 💡 Consigli e Best Practices

### Sicurezza Account

1. **Password Forte**: Usa una password master forte per il tuo account SafeVault
2. **Logout**: Esci sempre quando hai finito
3. **Non Condividere**: Non condividere le credenziali del tuo account SafeVault
4. **Computer Sicuro**: Usa SafeVault solo su computer fidati

### Gestione Credenziali

1. **Organizzazione**:
   - Usa nomi servizio chiari e riconoscibili
   - Aggiungi URL per identificare rapidamente il servizio
   - Usa le note per informazioni aggiuntive

2. **Password Sicure**:
   - Usa il generatore per tutte le nuove password
   - Non riutilizzare la stessa password su più servizi
   - Cambia password periodicamente (es. ogni 6 mesi)

3. **Backup**:
   - Chiedi all'amministratore del sistema di fare backup regolari
   - Conserva le credenziali più critiche anche offline (in un posto sicuro)

### Cosa Salvare in SafeVault

✅ **Consigliato**:
- Password di siti web
- Username e email
- Codici PIN
- Note di sicurezza
- Domande di sicurezza e risposte

❌ **Non Salvare**:
- Numeri di carte di credito (usa un wallet dedicato)
- Informazioni bancarie sensibili
- Documenti di identità

## ❓ Domande Frequenti (FAQ)

### Ho dimenticato la password del mio account SafeVault. Cosa faccio?

Attualmente SafeVault non ha un sistema di recupero password automatico. Contatta l'amministratore del sistema che può resettare manualmente la tua password nel database.

### Posso accedere a SafeVault da più dispositivi?

Sì, se SafeVault è installato su un server web, puoi accedervi da qualsiasi browser su qualsiasi dispositivo (computer, tablet, smartphone).

### Le mie password sono al sicuro?

Sì! SafeVault usa:
- Crittografia AES-256 per le password salvate
- Hash bcrypt per la password del tuo account
- Connessioni sicure (se HTTPS è abilitato)

### Cosa succede se qualcuno accede al database?

Le password salvate sono crittografate. Anche con accesso al database, non possono essere lette senza la chiave di crittografia (che è nel file di configurazione del server, non nel database).

### Posso esportare le mie credenziali?

Nella versione 1.0 non è ancora disponibile l'esportazione. È pianificata per versioni future.

### SafeVault funziona offline?

No, SafeVault richiede connessione al server dove è installato. È un'applicazione web, non un'app offline.

### Quanto è sicuro il generatore di password?

Il generatore usa il random number generator JavaScript del browser, che è sufficientemente sicuro per password. Ogni password è unica e casuale.

## 🆘 Supporto

### Problemi Tecnici

Se riscontri problemi:
1. Prova a ricaricare la pagina (F5)
2. Svuota la cache del browser
3. Prova un altro browser
4. Contatta l'amministratore del sistema

### Segnalare Bug

Se trovi un errore:
1. Annota cosa stavi facendo
2. Fai uno screenshot (se possibile)
3. Contatta l'amministratore o apri un issue su GitHub

## 📱 Compatibilità Browser

SafeVault funziona su tutti i browser moderni:
- ✅ Google Chrome / Edge (versione 90+)
- ✅ Mozilla Firefox (versione 88+)
- ✅ Safari (versione 14+)
- ✅ Opera (versione 75+)

## 🎓 Video Tutorial (Futuro)

_Tutorial video in arrivo nelle prossime versioni!_

## 📧 Contatti

Per assistenza o domande, consulta la pagina **Info** (About) dall'applicazione.

---

**Ricorda**: La sicurezza delle tue password inizia con una password forte per il tuo account SafeVault. Scegli saggiamente! 🔐

---

**SafeVault** - Versione 1.0.0
Ultimo aggiornamento guida: 2025-01-03