# SafeVault - Flusso Applicazione

## 🔄 Diagramma di Flusso Principale

```
┌─────────────────┐
│   index.php     │
│  (Entry Point)  │
└────────┬────────┘
         │
    ┌────▼────┐
    │ Loggato?│
    └────┬────┘
         │
    ┌────┴────┐
    │         │
   NO        SI
    │         │
    │    ┌────▼────────┐
    │    │ dashboard.  │
    │    │    php      │
    │    └─────────────┘
    │
┌───▼────────┐
│ login.php  │
└───┬────────┘
    │
    │  ┌──────────────┐
    └──► register.php │
       └──────────────┘
```

## 🔐 Flusso di Autenticazione

### Registrazione

```
User → register.php
        │
        ▼
    Input Form
    ┌─────────────┐
    │ - Username  │
    │ - Email     │
    │ - Password  │
    │ - Confirm   │
    └─────┬───────┘
          │
    ┌─────▼──────┐
    │ Validazione│
    │  Frontend  │
    └─────┬──────┘
          │
    ┌─────▼──────┐
    │  POST to   │
    │  Server    │
    └─────┬──────┘
          │
    ┌─────▼──────┐
    │ Validazione│
    │  Backend   │
    └─────┬──────┘
          │
    ┌─────▼──────────┐
    │ Check esistenza│
    │ Username/Email │
    └─────┬──────────┘
          │
    ┌─────▼──────┐
    │  Hash PWD  │
    │  (bcrypt)  │
    └─────┬──────┘
          │
    ┌─────▼──────┐
    │  INSERT    │
    │  Database  │
    └─────┬──────┘
          │
    ┌─────▼──────┐
    │ Redirect → │
    │ login.php  │
    └────────────┘
```

### Login

```
User → login.php
        │
        ▼
    Input Form
    ┌─────────────┐
    │ - Username/ │
    │   Email     │
    │ - Password  │
    └─────┬───────┘
          │
    ┌─────▼──────┐
    │  POST to   │
    │  Server    │
    └─────┬──────┘
          │
    ┌─────▼──────┐
    │  SELECT    │
    │  User DB   │
    └─────┬──────┘
          │
    ┌─────▼──────────┐
    │ password_verify│
    │   (bcrypt)     │
    └─────┬──────────┘
          │
    ┌─────┴─────┐
    │           │
   OK         FAIL
    │           │
    │      ┌────▼────┐
    │      │  Error  │
    │      └─────────┘
    │
┌───▼────────┐
│ Create     │
│ Session    │
└───┬────────┘
    │
┌───▼────────┐
│ Update     │
│ last_login │
└───┬────────┘
    │
┌───▼────────┐
│ Redirect → │
│ dashboard  │
└────────────┘
```

## 📊 Flusso Dashboard

```
User → dashboard.php
        │
        ▼
    ┌────────────┐
    │ isLoggedIn?│
    └─────┬──────┘
          │
    ┌─────┴─────┐
    │           │
   NO          YES
    │           │
    │      ┌────▼────────┐
    │      │   SELECT    │
    │      │ Credentials │
    │      │  FROM DB    │
    │      └────┬────────┘
    │           │
    │      ┌────▼────────┐
    │      │  Decrypt    │
    │      │  Passwords  │
    │      └────┬────────┘
    │           │
    │      ┌────▼────────┐
    │      │  Render     │
    │      │   Table     │
    │      └────┬────────┘
    │           │
    │      ┌────▼────────┐
    │      │ User can:   │
    │      │ - Add       │
    │      │ - Edit      │
    │      │ - Delete    │
    │      │ - View      │
    │      │ - Copy      │
    │      └─────────────┘
    │
┌───▼────────┐
│ Redirect → │
│ login.php  │
└────────────┘
```

## ➕ Flusso CRUD - Aggiungi Credenziale

```
Dashboard → Click "Aggiungi"
              │
              ▼
        ┌──────────┐
        │ Open     │
        │ Modal    │
        └────┬─────┘
             │
        ┌────▼─────────┐
        │ Fill Form:   │
        │ - Service    │
        │ - Username   │
        │ - Password   │
        │ - URL        │
        │ - Notes      │
        └────┬─────────┘
             │
             │ (opzionale)
        ┌────▼─────────┐
        │ Generate     │
        │ Password     │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Submit Form  │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Validazione  │
        │ Frontend JS  │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ POST to      │
        │ dashboard.php│
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Validazione  │
        │ Backend PHP  │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Encrypt      │
        │ Password     │
        │ (AES-256)    │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Encrypt      │
        │ Notes        │
        │ (se presenti)│
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ INSERT       │
        │ Database     │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Show Success │
        │ Message      │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Reload       │
        │ Dashboard    │
        └──────────────┘
```

## ✏️ Flusso CRUD - Modifica Credenziale

```
Dashboard → Click "Modifica"
              │
              ▼
        ┌──────────┐
        │ Open     │
        │ Modal    │
        └────┬─────┘
             │
        ┌────▼─────────┐
        │ Pre-fill     │
        │ Form with    │
        │ Existing     │
        │ Data         │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ User Edits   │
        │ Fields       │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Submit       │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ POST with    │
        │ action=edit  │
        │ + ID         │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Validate     │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Encrypt new  │
        │ Password     │
        │ (if changed) │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ UPDATE       │
        │ Database     │
        │ WHERE id     │
        │ AND user_id  │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Show Success │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Reload       │
        └──────────────┘
```

## 🗑️ Flusso CRUD - Elimina Credenziale

```
Dashboard → Click "Elimina"
              │
              ▼
        ┌──────────┐
        │ Confirm  │
        │ Dialog   │
        │ JavaScript│
        └────┬─────┘
             │
        ┌────┴─────┐
        │          │
      Cancel      OK
        │          │
        │     ┌────▼─────────┐
        │     │ POST with    │
        │     │ action=delete│
        │     │ + ID         │
        │     └────┬─────────┘
        │          │
        │     ┌────▼─────────┐
        │     │ DELETE FROM  │
        │     │ credentials  │
        │     │ WHERE id     │
        │     │ AND user_id  │
        │     └────┬─────────┘
        │          │
        │     ┌────▼─────────┐
        │     │ Show Success │
        │     └────┬─────────┘
        │          │
        │     ┌────▼─────────┐
        │     │ Reload       │
        │     └──────────────┘
        │
    ┌───▼─────┐
    │  Stay   │
    └─────────┘
```

## 🔑 Flusso Crittografia

### Salvataggio Password

```
User Input → "MySecretPass123!"
              │
              ▼
        ┌──────────────┐
        │ encryptData()│
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Generate     │
        │ Random IV    │
        │ (16 bytes)   │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ openssl_     │
        │ encrypt()    │
        │ AES-256-CBC  │
        │ + IV + KEY   │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Combine:     │
        │ IV +         │
        │ Encrypted    │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ base64_      │
        │ encode()     │
        └────┬─────────┘
             │
        ┌────▼─────────┐
        │ Store in DB  │
        │ (TEXT field) │
        └──────────────┘
```

### Recupero Password

```
Database → Encrypted String
            │
            ▼
      ┌──────────────┐
      │ decryptData()│
      └────┬─────────┘
           │
      ┌────▼─────────┐
      │ base64_      │
      │ decode()     │
      └────┬─────────┘
           │
      ┌────▼─────────┐
      │ Extract IV   │
      │ (first 16    │
      │  bytes)      │
      └────┬─────────┘
           │
      ┌────▼─────────┐
      │ Extract      │
      │ Encrypted    │
      │ (rest)       │
      └────┬─────────┘
           │
      ┌────▼─────────┐
      │ openssl_     │
      │ decrypt()    │
      │ + IV + KEY   │
      └────┬─────────┘
           │
      ┌────▼─────────┐
      │ Return       │
      │ Plain Text   │
      └──────────────┘
Display → "MySecretPass123!"
```

## 🔓 Flusso Logout

```
User → Click "Esci"
        │
        ▼
   ┌──────────┐
   │ logout.  │
   │   php    │
   └────┬─────┘
        │
   ┌────▼─────────┐
   │ Destroy      │
   │ Session Vars │
   │ $_SESSION=[] │
   └────┬─────────┘
        │
   ┌────▼─────────┐
   │ Delete       │
   │ Session      │
   │ Cookie       │
   └────┬─────────┘
        │
   ┌────▼─────────┐
   │ session_     │
   │ destroy()    │
   └────┬─────────┘
        │
   ┌────▼─────────┐
   │ Redirect →   │
   │ login.php    │
   └──────────────┘
```

## 🛡️ Flusso di Sicurezza

```
Ogni Request
    │
    ▼
┌─────────────┐
│ Check       │
│ Session     │
└────┬────────┘
     │
┌────▼────────┐
│ Sanitize    │
│ All Input   │
│ (POST/GET)  │
└────┬────────┘
     │
┌────▼────────┐
│ Validate    │
│ Input       │
└────┬────────┘
     │
┌────▼────────┐
│ PDO         │
│ Prepared    │
│ Statement   │
└────┬────────┘
     │
┌────▼────────┐
│ Execute     │
│ Query       │
└────┬────────┘
     │
┌────▼────────┐
│ Process     │
│ Result      │
└────┬────────┘
     │
┌────▼────────┐
│ Escape      │
│ Output      │
│ (HTML)      │
└────┬────────┘
     │
┌────▼────────┐
│ Send to     │
│ User        │
└─────────────┘
```

## 📱 Responsiveness Flow

```
User Device
    │
    ├─────────┬─────────┬─────────┐
    │         │         │         │
  Mobile   Tablet   Desktop   4K+
    │         │         │         │
    ▼         ▼         ▼         ▼
  CSS      CSS       CSS       CSS
 Media    Media     Media     Media
 Queries  Queries   Queries   Queries
    │         │         │         │
    └─────────┴─────────┴─────────┘
              │
         ┌────▼────┐
         │Tailwind │
         │ Classes │
         │ Applied │
         └────┬────┘
              │
         ┌────▼────┐
         │ Layout  │
         │Adjusted │
         └─────────┘
```

---

Questo documento visualizza tutti i flussi principali dell'applicazione SafeVault.