============================================================
                VAULTSPHERE - DOCUMENTAZIONE
============================================================

1. COS'È VAULTSPHERE
VaultSphere è una web application di Cloud Storage privato, 
progettata per gestire in sicurezza il caricamento, la 
conservazione e il download di file. È una soluzione leggera, 
performante e pronta all'uso per ambienti hosting Linux 
(ottimizzata per Aruba).

2. A CHI È RIVOLTO
- Piccole e Medie Imprese (PMI): Per condividere file con 
  dipendenti o clienti in modo controllato.
- Liberi Professionisti: Per archiviare documenti personali 
  e accedervi da qualsiasi luogo.
- Privati: Per creare un proprio "Dropbox" personale senza 
  canoni mensili e con il controllo totale sui dati.

3. FUNZIONALITÀ PRINCIPALI
- Autenticazione Sicura: Registrazione e login con password 
  criptate (bcrypt).
- Cartelle Personali: Ogni utente ha uno spazio isolato; 
  nessuno può vedere i file degli altri.
- Gestione File: Caricamento (Upload), Scaricamento (Download) 
  ed Eliminazione.
- Controllo Quota: L'amministratore può impostare un limite di 
  spazio (es. 100MB, 1GB) per ogni utente.
- Filtro Estensioni: Possibilità di limitare i tipi di file 
  caricabili (es. solo PDF e Immagini).
- Pannello Super Admin:
    * Dashboard con statistiche globali sull'uso del disco.
    * Gestione completa utenti (Attivazione, Sospensione, Blocco).
    * Esplora File Globale: Visualizzazione di tutti i file 
      caricati organizzati in "cartelle utente".
- Sicurezza Avanzata: I file non sono accessibili direttamente 
  tramite URL (protezione .htaccess).

4. GUIDA DETTAGLIATA ALL'INSTALLAZIONE (ARUBA)

PASSO 1: Preparazione Database
1. Accedi al tuo Pannello di Controllo Aruba.
2. Vai nella sezione "Database MySQL".
3. Apri "phpMyAdmin".
4. Seleziona il tuo database e importa il file `schema.sql` 
   fornito nel pacchetto. Questo creerà le tabelle necessarie.

PASSO 2: Configurazione Connessione
1. Apri il file `config/db.php` con un editor di testo.
2. Sostituisci i valori con i tuoi dati Aruba:
   - DB_HOST: Solitamente l'IP fornito da Aruba (es. 62.149.150.x)
   - DB_NAME: Il nome del tuo database (es. SqlXXXXXX_1)
   - DB_USER: Il tuo username (es. SqlXXXXXX)
   - DB_PASS: La tua password del database.

PASSO 3: Caricamento File
1. Utilizza un client FTP (come FileZilla).
2. Carica tutte le cartelle e i file del progetto nella root 
   del tuo spazio web (solitamente la cartella principale 
   o `public_html`).

PASSO 4: Permessi Scrittura
1. Assicurati che la cartella `uploads/` abbia i permessi di 
   scrittura (Chmod 755 o 777). Questo è fondamentale per 
   permettere il caricamento dei file.

PASSO 5: Creazione Primo Admin
1. Apri il browser e vai su: `https://www.tuosito.it/setup.php`
2. Se la configurazione è corretta, apparirà il messaggio 
   "Super Admin creato con successo!".
3. **IMPORTANTE**: Elimina immediatamente il file `setup.php` 
   dal server tramite FTP per evitare che altri possano 
   resettare l'admin.

PASSO 6: Accesso
1. Vai su `https://www.tuosito.it/`
2. Effettua il login con:
   - Email: `admin@vaultsphere.com`
   - Password: `admin123`
3. Dal Pannello Admin potrai ora creare nuovi utenti o 
   modificare le impostazioni di quelli esistenti.

------------------------------------------------------------
VaultSphere - Sicurezza, Semplicità, Controllo.
------------------------------------------------------------

