espace-paie-odentas/SIGNATURE_SALARIE_FEATURE.md

72 lines
2.5 KiB
Markdown

# Page de Signature pour les Salariés
## 📄 Fichiers créés
### 1. `/app/signature-salarie/page.tsx`
Page principale qui charge le composant de signature dans un Suspense
### 2. `/app/signature-salarie/SignatureSalarieContent.tsx`
Composant client qui affiche le formulaire DocuSeal
### 3. Modification du `/middleware.ts`
Ajout de `/signature-salarie` aux pages publiques (pas d'authentification requise)
## 🎯 Fonctionnalités
**Page publique** - Accessible sans authentification
**Sans Header/Sidebar** - Design épuré comme `dl-contrat-signe`
**DocuSeal intégré** - Widget de signature électronique
**Détection d'erreurs** - Gestion des documents inexistants
**Safari iOS compatible** - Classe CSS spéciale si nécessaire
**Événement de complétion** - Log quand le formulaire est signé
## 🔗 Utilisation
La page est accessible via :
```
https://paie.odentas.fr/signature-salarie?docuseal_id=XXXXX
```
`XXXXX` est le slug DocuSeal du document à signer.
## 📱 Options DocuSeal configurées
- ✅ Langue française (`data-language="fr"`)
- ✅ Pas de bouton d'envoi de copie (`data-with-send-copy-button="false"`)
- ✅ Pas de ressoumission (`data-allow-to-resubmit="false"`)
- ✅ Pas de signature tapée (`data-allow-typed-signature="false"`)
- ✅ Mémorisation de la signature (`data-remember-signature="true"`)
- ✅ Pas de titre (`data-with-title="false"`)
- ✅ Message de complétion personnalisé
## 🔧 Messages d'erreur
### Lien invalide
Si aucun `docuseal_id` n'est fourni dans l'URL, affiche :
> "Le lien de signature est invalide ou incomplet. Veuillez vérifier le lien reçu par email."
### Document inexistant
Si DocuSeal retourne une erreur "Unable to find form with slug", affiche :
> "Ce document n'existe pas ou a été supprimé pour cause de modification. Dans ce cas, vous avez reçu un e-mail pour signer la nouvelle version."
## 🎨 Design
- Header simple avec logo Odentas centré
- Fond blanc épuré
- Conteneur max-width 4xl pour le formulaire
- Responsive et mobile-friendly
## 🚀 Déploiement
Aucune configuration supplémentaire nécessaire. Les fichiers sont prêts à être déployés.
## 📧 Intégration avec les emails
Pour utiliser cette page dans les emails de signature envoyés aux salariés, utilisez le lien :
```html
<a href="https://paie.odentas.fr/signature-salarie?docuseal_id={{docuseal_slug}}">
Signer le document
</a>
```
`{{docuseal_slug}}` est le slug DocuSeal récupéré depuis l'API.