espace-paie-odentas/SIGNATURE_SALARIE_UNIFIED_FEATURE.md

Page Signature Salarié Unifiée - Contrats et Avenants

Résumé

La page /signature-salarie a été adaptée pour gérer à la fois les contrats CDDU et les avenants, offrant une expérience unifiée au lieu de créer deux pages séparées.

Modifications réalisées

1. API Routes

/api/signature-salarie/check-status (route.ts)

• ✅ Recherche dans les deux tables :
  1. Cherche d'abord dans cddu_contracts via employee_docuseal_slug
  2. Si non trouvé, cherche dans avenants via employee_docuseal_slug
• ✅ Nouveau champ retourné : documentType ('contrat' ou 'avenant')
• ✅ Gestion des données :
  • Pour les contrats : utilise directement les champs du contrat
  • Pour les avenants : utilise les données du contrat parent via la relation
• ✅ Variables unifiées :
  • employeeId, orgId, docusealSubmissionId, pdfS3Key, documentId
  • Permet de gérer les deux types de documents avec le même code

/api/signature-salarie/verify-birthdate (route.ts)

• ✅ Recherche dans les deux tables :
  1. Cherche d'abord dans cddu_contracts
  2. Si non trouvé, cherche dans avenants avec jointure sur cddu_contracts
• ✅ Récupération du salarié :
  • Utilise employeeId extrait du contrat ou de l'avenant
  • Vérifie la date de naissance de manière identique pour les deux types

2. Composants UI

SignatureSalarieContent.tsx

• ✅ État signatureData étendu :

  {
    contract: any;
    signed_at: string | null;
    downloadUrl: string | null;
    documentType?: 'contrat' | 'avenant'; // Nouveau
  }
  

• ✅ Titre dynamique :
  • "Signature électronique - Contrat" ou "Signature électronique - Avenant"
• ✅ Props transmis :
  • AlreadySignedCard et ToSignCard reçoivent documentType

AlreadySignedCard.tsx

• ✅ Nouveau prop : documentType?: 'contrat' | 'avenant'
• ✅ Textes adaptés :
  • Header : "Contrat signé" → "Avenant signé" (selon le type)
  • Message : "Vous avez signé électroniquement ce contrat." → "...cet avenant."

ToSignCard.tsx

• ✅ Nouveau prop : documentType?: 'contrat' | 'avenant'
• ✅ Textes adaptés :
  • Alerte : "Contrat en attente de signature" → "Avenant en attente..."
  • Instructions : "...prendre connaissance du contrat..." → "...de l'avenant..."
  • Section : "Détails du contrat" → "Détails de l'avenant"
  • Bouton : "Voir et signer votre contrat" → "Voir et signer votre avenant"

3. Webhook

/api/webhooks/docuseal-amendment (route.ts)

• ✅ Lien de signature :
  • Redirige vers : https://paie.odentas.fr/signature-salarie/?docuseal_id=xxx
  • Utilise la même page que les contrats

Architecture

┌─────────────────────────────────────────────────┐
│  /signature-salarie/?docuseal_id=xxx            │
└─────────────────────────────────────────────────┘
                     │
                     ▼
    ┌────────────────────────────────────┐
    │  SignatureSalarieContent.tsx       │
    │  - Vérifie le statut               │
    │  - Affiche modal de vérification   │
    └────────────────────────────────────┘
                     │
                     ▼
    ┌────────────────────────────────────┐
    │  /api/signature-salarie/           │
    │  check-status                      │
    │                                    │
    │  1. Cherche dans cddu_contracts    │
    │  2. Sinon cherche dans avenants    │
    │  3. Retourne documentType          │
    └────────────────────────────────────┘
                     │
         ┌───────────┴───────────┐
         ▼                       ▼
┌──────────────────┐   ┌──────────────────┐
│ AlreadySignedCard│   │  ToSignCard      │
│ + documentType   │   │  + documentType  │
│                  │   │                  │
│ "Avenant signé"  │   │ "Signer avenant" │
└──────────────────┘   └──────────────────┘

Base de données

Tables impliquées

cddu_contracts

• Champ utilisé : employee_docuseal_slug
• Contient : Les contrats CDDU classiques

avenants

• Champ utilisé : employee_docuseal_slug
• Relation : cddu_contracts (foreign key)
• Contient : Les avenants aux contrats existants

Requêtes Supabase

Recherche de contrat :

const { data: contract } = await supabase
  .from('cddu_contracts')
  .select('*')
  .eq('employee_docuseal_slug', docuseal_id)
  .maybeSingle();

Recherche d'avenant :

const { data: avenant } = await supabase
  .from('avenants')
  .select(`
    *,
    cddu_contracts!inner (
      employee_id,
      contract_number,
      ...
    )
  `)
  .eq('employee_docuseal_slug', docuseal_id)
  .maybeSingle();

Tests à effectuer

Test 1 : Signature d'un contrat classique

1. ✅ Envoyer un contrat CDDU à un salarié
2. ✅ Le salarié reçoit un email avec lien /signature-salarie/?docuseal_id=xxx
3. ✅ La page affiche "Contrat" dans le titre
4. ✅ Le salarié signe
5. ✅ La page affiche "Contrat signé"

Test 2 : Signature d'un avenant

1. ✅ Envoyer un avenant à un salarié (depuis l'interface Staff)
2. ✅ L'employeur signe l'avenant
3. ✅ Le salarié reçoit un email avec lien /signature-salarie/?docuseal_id=xxx
4. ✅ La page affiche "Avenant" dans le titre
5. ✅ Les textes sont adaptés ("Signer votre avenant")
6. ✅ Le salarié signe
7. ✅ La page affiche "Avenant signé"

Test 3 : Vérification date de naissance

1. ✅ Pour un contrat : vérifie dans cddu_contracts → salaries
2. ✅ Pour un avenant : vérifie dans avenants → cddu_contracts → salaries
3. ✅ Date de naissance correcte : accès autorisé
4. ✅ Date de naissance incorrecte : accès refusé

Avantages de l'approche unifiée

✅ Avantages

1. UX cohérente : Même expérience pour contrats et avenants
2. Moins de code : Pas de duplication de pages
3. Maintenance simplifiée : Une seule page à maintenir
4. Évolutivité : Facile d'ajouter d'autres types de documents

⚠️ Points d'attention

1. TypeScript : Vérifier que documentType est toujours défini
2. Tests : Tester les deux flux (contrat ET avenant)
3. Logs : Vérifier que les logs distinguent bien contrat/avenant

Commit

feat: Page signature-salarie adaptée pour contrats et avenants

- check-status: cherche dans cddu_contracts ET avenants
- verify-birthdate: cherche dans les deux tables
- Retourne documentType ('contrat' ou 'avenant')
- UI adaptée: AlreadySignedCard et ToSignCard affichent le type
- Titre dynamique: 'Contrat' ou 'Avenant' selon le document
- Textes adaptés: 'Voir et signer votre avenant/contrat'

Hash : 58e8fa4

Prochaines étapes suggérées

1. ✅ Tester le flux complet avec un avenant réel
2. ⏳ Ajouter des analytics PostHog pour tracker les signatures d'avenants
3. ⏳ Créer une page de liste des avenants signés (côté salarié)
4. ⏳ Ajouter des notifications push pour les avenants en attente

---

Date de création : $(date +%Y-%m-%d) Auteur : GitHub Copilot Version : 1.0