# 🚀 SafeVault - Quick Start Guide

## ⚡ Installazione Rapida (5 minuti)

### Passo 1: Prepara il Server
```bash
# Verifica PHP
php -v  # Deve essere 8.0 o superiore

# Verifica MySQL
mysql --version  # Deve essere 5.7 o superiore
```

### Passo 2: Importa il Database
```bash
mysql -u root -p
```
```sql
CREATE DATABASE safevault_db;
exit
```
```bash
mysql -u root -p safevault_db < database.sql
```

### Passo 3: Configura l'App
Apri `includes/config.php` e modifica:
```php
define('DB_USER', 'root');              // Il tuo username MySQL
define('DB_PASS', 'tuapassword');       // La tua password MySQL
define('ENCRYPTION_KEY', 'genera-una-chiave-casuale-32-caratteri');
```

Genera chiave:
```bash
php -r "echo bin2hex(random_bytes(16));"
```

### Passo 4: Apri nel Browser
```
http://localhost/passmanager/public/
```

### Passo 5: Registrati
- Clicca "Registrati qui"
- Crea il tuo account
- Inizia ad usare SafeVault!

---

## 📚 Documentazione

| File | Descrizione |
|------|-------------|
| [README.md](README.md) | Documentazione completa |
| [INSTALL.txt](INSTALL.txt) | Istruzioni installazione dettagliate |
| [USER_GUIDE.md](USER_GUIDE.md) | Guida per utenti finali |
| [SECURITY.md](SECURITY.md) | Politica di sicurezza |
| [CHANGELOG.md](CHANGELOG.md) | Storia delle versioni |
| [SUMMARY.md](SUMMARY.md) | Riepilogo progetto |
| [FLOW.md](FLOW.md) | Diagrammi di flusso |
| [TEST_CREDENTIALS.md](TEST_CREDENTIALS.md) | Credenziali per testing |

---

## 🎯 Funzionalità Principali

✅ **Autenticazione Sicura**
- Registrazione e login
- Password hashate con bcrypt
- Sessioni sicure

✅ **Gestione Credenziali**
- Aggiungi, modifica, elimina
- Visualizza password (toggle)
- Copia negli appunti

✅ **Generatore Password**
- Password sicure 16 caratteri
- Mix completo di caratteri
- Generazione instant

✅ **Crittografia AES-256**
- Password crittografate nel DB
- Decrittografia on-demand
- IV unico per ogni password

---

## 🔒 Sicurezza

- 🛡️ **Crittografia**: AES-256-CBC
- 🔐 **Hashing**: bcrypt (cost 12)
- 🚫 **SQL Injection**: Prepared statements
- 🛑 **XSS**: Input sanitization
- 🔒 **HTTPS**: Supporto SSL/TLS

---

## 📱 Interfaccia

- 🎨 Design moderno con Tailwind CSS
- 📱 Responsive (mobile, tablet, desktop)
- ⚡ Veloce e reattivo
- 🎯 UX intuitiva

---

## 🏗️ Struttura

```
passmanager/
├── public/          # Frontend
├── includes/        # Backend
├── assets/          # CSS + JS
└── database.sql     # Schema DB
```

---

## 💻 Tecnologie

- PHP 8+
- MySQL 5.7+
- Tailwind CSS
- JavaScript ES6+

---

## ⚡ Comandi Utili

### Reset Database
```sql
DROP DATABASE safevault_db;
CREATE DATABASE safevault_db;
USE safevault_db;
SOURCE database.sql;
```

### Backup Database
```bash
mysqldump -u root -p safevault_db > backup_$(date +%Y%m%d).sql
```

### Genera Chiave Crittografia
```bash
php -r "echo bin2hex(random_bytes(16));"
```

### Verifica Permessi
```bash
chmod 755 public/
chmod 644 public/*.php
chmod 600 includes/config.php
```

---

## 🐛 Troubleshooting

**Errore: "Accesso non autorizzato"**
- Assicurati di accedere via `public/index.php`

**Errore: "Connessione database"**
- Verifica credenziali in `config.php`
- Controlla che MySQL sia attivo

**Pagina bianca**
- Attiva display_errors in `config.php`
- Controlla log Apache/PHP

**Password decifrate male**
- Non hai cambiato `ENCRYPTION_KEY` dopo aver salvato dati?

---

## 📞 Supporto

- 📖 Leggi la [documentazione completa](README.md)
- 🔐 Consulta [SECURITY.md](SECURITY.md)
- 👤 Vedi [USER_GUIDE.md](USER_GUIDE.md)

---

## 📊 Checklist Pre-Produzione

- [ ] HTTPS attivo
- [ ] ENCRYPTION_KEY cambiata
- [ ] Password MySQL forte
- [ ] File config.php protetto (600)
- [ ] Display errors OFF
- [ ] Backup automatici configurati
- [ ] Firewall attivo
- [ ] TEST_CREDENTIALS.md eliminato
- [ ] Account di test rimossi

---

## 🎓 Primi Passi Dopo l'Installazione

1. **Registra il tuo account**
2. **Aggiungi la prima credenziale**
3. **Prova il generatore password**
4. **Testa modifica ed eliminazione**
5. **Fai logout e riaccedi**

---

## ✨ Caratteristiche Uniche

- 🔐 Crittografia end-to-end nel database
- 🎲 Generatore password integrato
- 📋 Copia password con un click
- 👁️ Toggle visibilità password
- 📊 Dashboard con statistiche
- 🎨 UI moderna e professionale

---

## 🚀 Da 0 a SafeVault in 5 Step

```bash
# 1. Crea il database
mysql -u root -p -e "CREATE DATABASE safevault_db"

# 2. Importa schema
mysql -u root -p safevault_db < database.sql

# 3. Genera chiave
php -r "echo bin2hex(random_bytes(16));"

# 4. Modifica config.php con le tue credenziali

# 5. Apri nel browser e registrati!
```

---

**SafeVault v1.0.0** - Password Manager Sicuro e Moderno

🔐 La tua sicurezza, il tuo controllo.

---

_Per informazioni dettagliate, consulta [README.md](README.md)_