# Guide de Migration - Inscriptions Publiques

## 📋 État Actuel

**Migrations en attente** :
- ✅ `2026_01_20_000000_create_public_registration_tokens_table` - Pending
- ✅ `2026_01_20_100000_add_seminar_fields_to_registrations_table` - Pending
- ⚠️ `2024_01_15_090000_create_cache_table` - Pending (optionnel, pour cache Laravel)

**Rôle 'guest'** :
- ✅ Déjà ajouté dans `RoleSeeder.php`
- ⚠️ À créer en base si pas encore fait

---

## 🚀 ÉTAPES DE MIGRATION

### Étape 1 : Vérifier l'état actuel

```bash
cd d:\dev\eventshbf\api
php artisan migrate:status
```

### Étape 2 : Exécuter les migrations

```bash
# Exécuter toutes les migrations en attente
php artisan migrate

# OU si vous voulez forcer en production (sans confirmation)
php artisan migrate --force
```

**Migrations qui seront exécutées** :
1. `create_public_registration_tokens_table` - Table pour tokens de vérification email
2. `add_seminar_fields_to_registrations_table` - Champs Séminaire dans registrations
3. `create_cache_table` - Table cache Laravel (optionnel)

### Étape 3 : Créer le rôle 'guest'

```bash
# Exécuter le seeder pour créer le rôle 'guest'
php artisan db:seed --class=RoleSeeder
```

**OU** si vous voulez exécuter tous les seeders :

```bash
php artisan db:seed
```

### Étape 4 : Vérifier que tout est OK

```bash
# Vérifier l'état des migrations
php artisan migrate:status

# Vérifier que le rôle 'guest' existe
php artisan tinker
# Puis dans tinker :
# \Spatie\Permission\Models\Role::all()->pluck('name');
# Devrait afficher : ["admin", "treasurer", "delegate_lead", "participant", "guest"]
```

### Étape 5 : Vérifier la structure de la table registrations

```bash
php artisan tinker
# Puis :
# \Illuminate\Support\Facades\Schema::getColumnListing('registrations');
# Devrait inclure : nationality, is_haggai_leader, seminar_intent, etc.
```

---

## 🔍 VÉRIFICATIONS POST-MIGRATION

### 1. Vérifier la table `public_registration_tokens`

```sql
-- Dans MySQL/HeidiSQL
DESCRIBE public_registration_tokens;
-- Devrait avoir : id, registration_id, token, expires_at, used_at, timestamps
```

### 2. Vérifier les colonnes ajoutées à `registrations`

```sql
DESCRIBE registrations;
-- Devrait inclure :
-- nationality
-- is_haggai_leader
-- seminar_intent
-- seminar_question_or_concern
-- recommended_full_name
-- recommended_profession
-- recommended_residence_country
-- recommended_phone_whatsapp
-- recommended_email
```

### 3. Vérifier l'index pour déduplication

```sql
SHOW INDEXES FROM registrations WHERE Key_name = 'idx_email_event';
-- Devrait exister
```

### 4. Vérifier le rôle 'guest'

```sql
SELECT * FROM roles WHERE name = 'guest';
-- Devrait retourner 1 ligne
```

---

## ⚠️ POINTS D'ATTENTION

### Migration `add_seminar_fields_to_registrations_table`

**⚠️ IMPORTANT** : Cette migration ajoute des colonnes **nullable**, donc :
- ✅ Pas de perte de données
- ✅ Pas de breaking change
- ✅ Les inscriptions existantes continuent de fonctionner

**Si des doublons existent** :
- La migration peut échouer si vous activez la contrainte unique `(user_id, event_id)`
- Pour l'instant, cette contrainte est **commentée** dans la migration
- À activer manuellement après nettoyage des doublons si nécessaire

### Migration `create_public_registration_tokens_table`

- ✅ Table créée uniquement si `REGISTRATION_PUBLIC_REQUIRE_EMAIL_VERIFICATION=true`
- ✅ Peut rester vide si vérification email désactivée

---

## 🧪 TESTS POST-MIGRATION

### Test 1 : Vérifier que les nouvelles colonnes existent

```bash
php artisan tinker
```

```php
$registration = \App\Models\Registration::first();
$registration->nationality = 'Test';
$registration->save();
// Si pas d'erreur, les colonnes existent ✅
```

### Test 2 : Vérifier le rôle guest

```php
$role = \Spatie\Permission\Models\Role::where('name', 'guest')->first();
// Devrait retourner un objet Role ✅
```

### Test 3 : Vérifier la table tokens

```php
\Illuminate\Support\Facades\DB::table('public_registration_tokens')->count();
// Devrait retourner 0 (table vide au début) ✅
```

---

## 📝 COMMANDES COMPLÈTES (Copier-Coller)

```bash
# 1. Aller dans le dossier API
cd d:\dev\eventshbf\api

# 2. Exécuter les migrations
php artisan migrate

# 3. Créer le rôle 'guest'
php artisan db:seed --class=RoleSeeder

# 4. Vérifier l'état
php artisan migrate:status

# 5. (Optionnel) Tester avec tinker
php artisan tinker
# Puis dans tinker :
# \Spatie\Permission\Models\Role::where('name', 'guest')->exists(); // true
# \Illuminate\Support\Facades\Schema::hasColumn('registrations', 'nationality'); // true
```

---

## 🔄 ROLLBACK (Si nécessaire)

Si vous devez annuler les migrations :

```bash
# Annuler la dernière batch de migrations
php artisan migrate:rollback

# OU annuler un nombre spécifique
php artisan migrate:rollback --step=2
```

**⚠️ ATTENTION** : Le rollback supprimera :
- Les colonnes ajoutées à `registrations`
- La table `public_registration_tokens`
- Les données dans ces colonnes/tables

---

## ✅ CHECKLIST FINALE

- [ ] Migrations exécutées sans erreur
- [ ] Rôle 'guest' créé en base
- [ ] Colonnes Séminaire présentes dans `registrations`
- [ ] Table `public_registration_tokens` créée
- [ ] Index `idx_email_event` créé
- [ ] Tests tinker passent
- [ ] Aucune erreur dans les logs

---

## 🚨 EN CAS D'ERREUR

### Erreur : "Column already exists"
- Les colonnes existent déjà → Migration peut être ignorée
- Solution : Commenter les lignes dans la migration ou utiliser `Schema::hasColumn()`

### Erreur : "Table already exists"
- La table existe déjà → Migration peut être ignorée
- Solution : Utiliser `Schema::hasTable()` dans la migration

### Erreur : "Duplicate entry for key"
- Doublons dans la base → Nettoyer avant d'activer la contrainte unique
- Solution : Vérifier et supprimer les doublons manuellement

---

**Document généré le** : 2026-01-XX  
**Version** : 1.0