espace-paie-odentas/STAFF_RESEND_INVITATION_FEATURE.md

# Feature: Relance d'invitation auto-déclaration

## 📝 Description

Cette fonctionnalité permet au staff de renvoyer l'email d'invitation à l'auto-déclaration à un salarié directement depuis la page `/staff/salaries`.

## 🎯 Objectif

Permettre de relancer facilement un salarié qui :
- N'a pas reçu l'email initial
- N'a pas complété son profil
- A besoin d'un nouveau lien (token expiré après 7 jours)
- Doit mettre à jour ses documents

## 🔧 Fichiers créés/modifiés

### 1. `/components/staff/ResendInvitationModal.tsx` (NOUVEAU)

Composant modal de confirmation avant envoi de la relance.

**Fonctionnalités :**
- Affichage des informations du salarié (nom, matricule, email)
- Validation de la présence d'un email
- Message explicatif du contenu de l'email
- Confirmation visuelle avant envoi
- Feedback pendant l'envoi (loader)
- Notification de succès/erreur

### 2. `/components/staff/SalariesGridSimple.tsx` (MODIFIÉ)

**Ajouts :**
- Import de `ResendInvitationModal`
- État `isResendInvitationOpen` pour gérer l'ouverture de la modale
- Bouton "Envoyer une relance justifs" en gradient bleu/indigo
- Intégration de la modale avec le salarié sélectionné

**Emplacement du bouton :**
- Au dessus de la card "Informations personnelles"
- Pleine largeur avec icône mail
- Design attrayant en gradient

### 3. API utilisée : `/api/auto-declaration/generate-token/route.ts` (EXISTANTE)

L'API existante est réutilisée. Elle :
- Génère un nouveau token sécurisé
- Supprime les anciens tokens du salarié
- Envoie l'email d'invitation avec le lien personnalisé
- Retourne le statut d'envoi

## 🎨 Interface utilisateur

### Bouton de relance
```
┌─────────────────────────────────────┐
│  📧 Envoyer une relance justifs     │
│  (Gradient bleu → indigo)           │
└─────────────────────────────────────┘
```

### Modale de confirmation

```
┌───────────────────────────────────────┐
│ 📧 Relancer le salarié           ✕   │
├───────────────────────────────────────┤
│                                       │
│  ✓ Email d'invitation à              │
│    l'auto-déclaration                 │
│                                       │
│  Le salarié recevra un email avec    │
│  un lien sécurisé...                  │
│                                       │
│  Salarié:      Jean Dupont            │
│  Matricule:    MAT001                 │
│  Email:        jean.dupont@mail.com   │
│                                       │
│  💡 Contenu: Lien valide 7 jours...   │
│                                       │
│           [Annuler] [Envoyer] 📧      │
└───────────────────────────────────────┘
```

## 📧 Contenu de l'email envoyé

L'email envoyé est **exactement le même** que lors de la création du salarié :

**Template :** `auto-declaration-invitation`

**Contenu :**
- Salutation personnalisée avec prénom
- Nom de l'organisation employeur
- Matricule du salarié
- **Lien d'accès sécurisé** avec token unique
- Instructions pour :
  - Compléter les informations personnelles
  - Uploader les justificatifs (CNI, attestation Sécu, RIB, etc.)
  - Accepter les conditions RGPD

**Validité :** 7 jours

## 🔐 Sécurité

- ✅ Vérification de l'authentification staff
- ✅ Validation de la présence d'un email
- ✅ Génération d'un nouveau token sécurisé (32 bytes hex)
- ✅ Suppression automatique des anciens tokens
- ✅ Token unique par salarié
- ✅ Expiration automatique après 7 jours

## ⚙️ Comportement

1. **Clic sur le bouton** → Ouverture de la modale
2. **Vérification email** → Si absent, message d'erreur et bouton désactivé
3. **Confirmation** → Appel API pour générer token et envoyer email
4. **Pendant l'envoi** → Loader et désactivation des boutons
5. **Succès** → Toast de confirmation et fermeture de la modale
6. **Erreur** → Toast d'erreur avec message détaillé

## 📊 Cas d'usage

### ✅ Cas valides
- Salarié avec email valide
- Besoin de renvoyer l'invitation
- Token expiré (> 7 jours)
- Email initial non reçu
- Salarié n'a pas complété son profil

### ❌ Cas bloqués
- Salarié sans email → Bouton désactivé avec message d'erreur
- Pendant l'envoi → Boutons désactivés
- Erreur API → Toast d'erreur

## 🎯 Flow complet

```
Staff sélectionne salarié
    ↓
Clic "Envoyer une relance justifs"
    ↓
Modale s'ouvre avec infos salarié
    ↓
Validation email présent
    ↓
Staff confirme "Envoyer"
    ↓
API génère nouveau token
    ↓
Supprime anciens tokens
    ↓
Envoie email avec lien
    ↓
Toast succès + fermeture modale
    ↓
Salarié reçoit email
    ↓
Clique sur lien → /auto-declaration?token=...
    ↓
Complète son profil et upload documents
```

## 💡 Avantages

1. **Simplicité** : Un seul clic depuis la fiche salarié
2. **Confirmation** : Modale explicative avant envoi
3. **Feedback** : Messages clairs de succès/erreur
4. **Sécurité** : Nouveau token à chaque envoi
5. **Traçabilité** : Logs des envois côté serveur
6. **UX** : Bouton visible et design attrayant

## ✅ Tests recommandés

1. **Envoi réussi**
   - Salarié avec email valide
   - Vérifier réception de l'email
   - Vérifier que le lien fonctionne
   - Vérifier expiration après 7 jours

2. **Salarié sans email**
   - Bouton doit être désactivé
   - Message d'erreur affiché
   - Pas d'appel API

3. **Erreur réseau**
   - Simuler échec API
   - Vérifier toast d'erreur
   - Modale reste ouverte

4. **Double envoi**
   - Envoyer 2 fois de suite
   - Vérifier que seul le dernier token est valide
   - Ancien token doit être supprimé

5. **Changement de salarié**
   - Ouvrir modale pour salarié A
   - Changer vers salarié B
   - Vérifier que la modale affiche les bonnes infos

## 🔄 Intégration avec l'existant

- Utilise l'API `/api/auto-declaration/generate-token` existante
- Utilise le service `autoDeclarationTokenService` existant
- Utilise les templates d'email existants
- Compatible avec le système d'auto-déclaration actuel
- Pas de modification de la base de données nécessaire

## 📈 Prochaines améliorations possibles

- [ ] Historique des relances envoyées
- [ ] Indication de la dernière relance envoyée
- [ ] Statistiques de complétion après relance
- [ ] Envoi groupé à plusieurs salariés
- [ ] Personnalisation du message
- [ ] Rappel automatique après X jours

---

**Date de création** : 12 octobre 2025
**Version** : 1.0.0