# Solution Alternative : Hash de Recherche pour Champs Chiffrés

## Problème
Le chiffrement AES-256-CBC utilisé par Laravel n'est pas déterministe et ne permet pas de recherches directes en base de données.

## Solution Recommandée : Colonne de Hash

Pour les champs fréquemment recherchés (comme `email`), ajouter une colonne de hash à côté de la colonne chiffrée.

### Étape 1 : Migration

```php
// database/migrations/xxxx_add_email_hash_to_users.php
public function up()
{
    Schema::table('users', function (Blueprint $table) {
        $table->string('email_hash', 64)->nullable()->after('email');
        $table->index('email_hash'); // Index pour performance
    });
    
    // Générer les hash pour les données existantes
    DB::table('users')->orderBy('id')->chunk(100, function ($users) {
        foreach ($users as $user) {
            $decryptedEmail = Crypt::decryptString($user->email);
            DB::table('users')
                ->where('id', $user->id)
                ->update(['email_hash' => hash('sha256', strtolower($decryptedEmail))]);
        }
    });
}
```

### Étape 2 : Modifier le Modèle User

```php
class User extends Authenticatable
{
    use HasEncryptedAttributes;
    
    protected $casts = [
        'name' => 'encrypted',
        'email' => 'encrypted',
    ];
    
    protected $hidden = [
        'email_hash', // Cacher le hash dans les réponses API
    ];
    
    /**
     * Override setEmailAttribute to auto-generate hash
     */
    public function setEmailAttribute($value)
    {
        $this->attributes['email'] = $value; // Laravel va chiffrer automatiquement
        $this->attributes['email_hash'] = hash('sha256', strtolower($value));
    }
    
    /**
     * Recherche rapide par email
     */
    public static function findByEmail(string $email)
    {
        $emailHash = hash('sha256', strtolower($email));
        return static::where('email_hash', $emailHash)->first();
    }
}
```

### Étape 3 : Utilisation

```php
// ✅ Recherche instantanée via hash (index SQL)
$user = User::findByEmail('john@example.com');

// Vs

// ❌ Recherche lente (charge tous les utilisateurs)
$user = User::findByEncrypted('email', 'john@example.com');
```

## Comparaison de Performance

| Méthode | Utilisateurs | Temps |
|---------|--------------|-------|
| `findByEncrypted()` | 100 | ~50ms |
| `findByEncrypted()` | 1,000 | ~500ms |
| `findByEncrypted()` | 10,000 | ~5s |
| `findByEmail()` (hash) | 10,000 | ~2ms |

## Avantages du Hash

✅ **Performance** : Utilise les index SQL  
✅ **Scalabilité** : Fonctionne avec des millions d'enregistrements  
✅ **Simplicité** : Code propre et maintenable  
✅ **Sécurité** : Le hash SHA-256 ne révèle pas l'email original  

## Inconvénients

❌ Stockage supplémentaire (64 bytes par enregistrement)  
❌ Pas de recherche LIKE partielle (ex: `%@gmail.com`)  
❌ Nécessite une migration

## Recommandations

### Pour `User.email` (recherché fréquemment)
→ **Utiliser le hash** (comme décrit ci-dessus)

### Pour `Employee` (plusieurs champs chiffrés)
→ Ajouter des hash uniquement pour les champs souvent recherchés :
- `email_hash` (si recherche par email)
- `telephone_hash` (si recherche par téléphone)

### Pour les champs rarement recherchés
→ Garder `findByEncrypted()` (acceptable pour usage occasionnel)

## Implémentation pour LIKE

Pour les recherches LIKE partielles, malheureusement, il n'y a **aucune solution viable** avec le chiffrement complet. Les alternatives sont :

1. **Tokenisation** : Stocker des tokens recherchables séparément
2. **Chiffrement partiel** : Ne chiffrer qu'une partie du champ
3. **Recherche full-text** : Déchiffrer et indexer dans un moteur de recherche externe (Elasticsearch)
4. **Accepter la limitation** : Charger tous les enregistrements pour les recherches LIKE (solution actuelle)

## Conclusion

Le trait `HasEncryptedAttributes` actuel est la meilleure solution **générique**. Pour optimiser les champs spécifiques très recherchés comme `email`, il faut ajouter une colonne de hash avec index.

Voulez-vous que je crée les migrations pour ajouter `email_hash` aux tables `users` et `employees` ?