================================================================================
  SAFEVAULT - ISTRUZIONI DI INSTALLAZIONE RAPIDA
================================================================================

Benvenuto in SafeVault! Segui questi semplici passi per installare
l'applicazione sul tuo server.

================================================================================
REQUISITI MINIMI
================================================================================

- PHP 8.0 o superiore
- MySQL 5.7+ o MariaDB 10.2+
- Server web Apache o Nginx
- Estensioni PHP: pdo_mysql, openssl, mbstring

================================================================================
PASSO 1: CARICA I FILE
================================================================================

Carica tutti i file del progetto sul tuo server web.
La struttura finale dovrebbe essere:

tuosito.com/
  ├── public/
  ├── includes/
  ├── assets/
  ├── database.sql
  └── README.md

================================================================================
PASSO 2: CREA IL DATABASE
================================================================================

1. Accedi a phpMyAdmin o alla console MySQL
2. Crea un nuovo database chiamato "safevault_db" (o altro nome a tua scelta)
3. Importa il file "database.sql" nel database appena creato

Oppure da terminale:

  mysql -u root -p
  CREATE DATABASE safevault_db;
  exit
  mysql -u root -p safevault_db < database.sql

================================================================================
PASSO 3: CONFIGURA IL DATABASE
================================================================================

1. Apri il file: includes/config.php
2. Modifica le seguenti righe con le tue credenziali:

   define('DB_HOST', 'localhost');        // Host del database
   define('DB_NAME', 'safevault_db');     // Nome del database
   define('DB_USER', 'root');             // Username MySQL
   define('DB_PASS', 'tuapassword');      // Password MySQL

================================================================================
PASSO 4: CAMBIA LA CHIAVE DI CRITTOGRAFIA (IMPORTANTE!)
================================================================================

Nel file includes/config.php, trova questa riga:

define('ENCRYPTION_KEY', 'your-secure-32-character-key-here-change-this!');

E sostituiscila con una chiave casuale di 32 caratteri.

Puoi generarne una con:
  php -r "echo bin2hex(random_bytes(16));"

Esempio:
  define('ENCRYPTION_KEY', 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6');

⚠️ ATTENZIONE: Non cambiare mai questa chiave dopo aver salvato credenziali,
   altrimenti non potrai più decrittografare le password salvate!

================================================================================
PASSO 5: CONFIGURA HTTPS (Se disponibile)
================================================================================

Se hai un certificato SSL installato:

1. Nel file includes/config.php, cambia:
   ini_set('session.cookie_secure', 1);

2. Nel file .htaccess, decommenta le righe HTTPS:
   RewriteEngine On
   RewriteCond %{HTTPS} off
   RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

================================================================================
PASSO 6: VERIFICA PERMESSI FILE
================================================================================

Assicurati che i file abbiano i permessi corretti:

  chmod 755 public/
  chmod 644 public/*.php
  chmod 600 includes/config.php

Su Windows non è necessario modificare i permessi.

================================================================================
PASSO 7: ACCEDI ALL'APPLICAZIONE
================================================================================

Visita il tuo sito nel browser:

  http://tuosito.com/public/

Oppure, se hai installato nella root:

  http://tuosito.com/

Dovresti vedere la pagina di login. Clicca su "Registrati" per creare
il tuo primo account!

================================================================================
RISOLUZIONE PROBLEMI
================================================================================

ERRORE: "Errore di connessione al database"
  → Verifica le credenziali in includes/config.php
  → Controlla che MySQL sia in esecuzione
  → Verifica che il database esista

ERRORE: Pagina bianca
  → Attiva gli errori PHP aggiungendo in config.php:
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
  → Controlla i log del server

ERRORE: "Accesso non autorizzato"
  → Assicurati di accedere tramite index.php o le pagine in public/

PASSWORD DECRITTOGRAFATE INCORRETTE
  → Hai cambiato ENCRYPTION_KEY dopo aver salvato le credenziali
  → La chiave deve rimanere invariata per tutto il ciclo di vita dell'app

================================================================================
SICUREZZA
================================================================================

✓ Usa HTTPS in produzione
✓ Cambia ENCRYPTION_KEY con una chiave unica
✓ Usa password forti per l'account MySQL
✓ Fai backup regolari del database
✓ Mantieni PHP e MySQL aggiornati
✓ Non condividere il file config.php

================================================================================
SUPPORTO
================================================================================

Per ulteriori informazioni, consulta:

  - README.md (documentazione completa)
  - public/about.php (informazioni sul progetto)

Per bug o domande, visita:
  https://github.com/tuousername/safevault/issues

================================================================================

Buon utilizzo di SafeVault! 🔐

================================================================================