espace-paie-odentas/DEPLOYMENT.md
2025-10-12 17:05:46 +02:00

2.9 KiB

Déploiement Vercel - Guide Rapide

🚀 Configuration pour demo.odentas.fr

1. Ajouter le domaine dans Vercel

# Si vous utilisez Vercel CLI
vercel domains add demo.odentas.fr

# Ou via l'interface web:
# Dashboard → Settings → Domains → Add → demo.odentas.fr

2. Configuration DNS

Chez votre registraire DNS :

Type: CNAME
Name: demo  
Value: cname.vercel-dns.com
TTL: 300

3. Test de la configuration

# Test local (avec le serveur en marche)
./scripts/test-demo-domains.sh

# Test manuel
curl -H "Host: demo.odentas.fr" http://localhost:3001/api/me

4. Vérification du déploiement

Une fois déployé, vous devriez avoir :

5. Fonctionnalités automatiques

Le fichier vercel.json configure automatiquement :

  • Détection du domaine : Auto-activation sur demo.odentas.fr
  • Header injection : x-demo-mode: true
  • Redirection : / → /contrats pour montrer les données
  • Optimisations : Timeouts API adaptés

6. Banner démo intelligent

Le système affiche automatiquement :

  • Sur demo.odentas.fr : Banner complet avec liens contact
  • En développement : Banner simple de démo
  • Sur paie.odentas.fr : Aucun banner (mode normal)

🔧 Dépannage

Problème : demo.odentas.fr ne fonctionne pas

  1. Vérifier la configuration DNS : nslookup demo.odentas.fr
  2. Vérifier dans Vercel Dashboard que le domaine est ajouté
  3. Attendre la propagation DNS (jusqu'à 24h)

Problème : Mode démo non détecté

  1. Vérifier les logs : 🎭 [DEMO MIDDLEWARE] doit apparaître
  2. Tester avec header : curl -H "x-demo-mode: true" ...
  3. Vérifier vercel.json est bien déployé

Test complet

# Lancer le script de test
cd "/Users/renaud/Projet Nouvel Espace Paie"
./scripts/test-demo-domains.sh

📋 Checklist de déploiement

  • Domaine demo.odentas.fr ajouté dans Vercel
  • DNS configuré (CNAME demo → cname.vercel-dns.com)
  • vercel.json présent dans le repo
  • Test local passant avec ./scripts/test-demo-domains.sh
  • Déploiement Vercel effectué
  • Test production : https://demo.odentas.fr/api/me
  • Vérification mode normal : https://paie.odentas.fr

🎯 URLs de test

Une fois déployé :

# Mode démo
curl https://demo.odentas.fr/api/me
curl https://demo.odentas.fr/api/contrats
curl "https://demo.odentas.fr/api/search?q=alice"

# Mode normal  
curl https://paie.odentas.fr/api/me

💡 Avantages de cette configuration

  • Un seul codebase → Maintenance simplifiée
  • Détection automatique → Pas de variables d'env
  • SEO friendly → URLs propres sans paramètres
  • Déploiement atomique → Cohérence garantie
  • Isolation sécurisée → Pas de risque de fuite de données