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

113 lines
No EOL
2.9 KiB
Markdown

# Déploiement Vercel - Guide Rapide
## 🚀 Configuration pour demo.odentas.fr
### 1. Ajouter le domaine dans Vercel
```bash
# 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
```bash
# 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 :
- **https://demo.odentas.fr** → Mode démo automatique
- **https://paie.odentas.fr** → Mode normal
- **Même codebase** → Comportements différents
### 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
```bash
# 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é :
```bash
# 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