expria-frontend/docs/DEPLOYMENT.md

DEPLOYMENT.md — Expria V2

Version 1.0 — Rédigé avant lancement Procédure officielle de bascule V1 → V2 sur expria.app À lire intégralement avant toute action de déploiement.

---

1. Architecture cible

Composant	V1 (actuel)	V2 (cible)
Frontend	Next.js sur Render	React/Vite sur Cloudflare Pages
Backend	Next.js API routes sur Render	Hono.js sur Render (déjà live)
DNS	Vercel	Vercel (inchangé)
Domaine	expria.app	expria.app (inchangé)
Auth	Supabase	Supabase (inchangé)
Paiement	Stripe	Stripe (inchangé)

---

2. Prérequis — ne pas lancer la bascule sans cocher tout

Code

• Tous les tests Vitest backend passent (0 échec)
• Tous les tests Vitest frontend passent (0 échec)
• npm run typecheck frontend → 0 erreur
• Smoke test complet (Groupe Z du GOLDEN_DATASET.md) validé en local

Infrastructure

• Backend V2 stable sur api.expria.app depuis au moins 48h sans erreur critique Sentry
• Sentry configuré et actif sur le frontend V2
• Variables d'environnement Cloudflare Pages configurées :
  • VITE_API_URL=https://api.expria.app
  • VITE_SUPABASE_URL=...
  • VITE_SUPABASE_ANON_KEY=...
  • VITE_ENABLE_T2_LIVE=false
• CNAME Cloudflare Pages créé et testé sur une URL de preview

Stripe

• Webhooks Stripe pointent vers api.expria.app (backend V2)
• Test de paiement réel effectué sur l'URL de preview Cloudflare Pages

Rollback DNS — valeurs de référence (ne pas supprimer)

• @ → A → 216.24.57.1 (frontend V1 Render)
• www → CNAME → expria.onrender.com (frontend V1 Render)
• api → CNAME → expria-backend.onrender.com (backend V2 — inchangé)

---

3. Procédure de bascule — dans l'ordre exact

Étape 1 — Mettre V1 en mode maintenance (2 min)

Dans Render, sur le service frontend V1 :

• Modifier la variable d'environnement MAINTENANCE_MODE=true
• Redéployer le service V1
• Vérifier que expria.app affiche la page de maintenance

⚠️ À partir de ce moment, expria.app est inaccessible pour les utilisateurs. Faire cette étape à une heure creuse (nuit, week-end).

Étape 2 — Configurer le CNAME dans Vercel (5 min)

Dans le dashboard Vercel → Domains → expria.app :

• Supprimer ou modifier l'enregistrement A/CNAME actuel qui pointe vers Render
• Ajouter un CNAME : expria.app → <projet>.pages.dev (URL Cloudflare Pages)
• Sauvegarder

Étape 3 — Configurer le domaine dans Cloudflare Pages (5 min)

Dans Cloudflare Pages → projet expria-frontend → Custom domains :

• Ajouter expria.app
• Cloudflare Pages vérifie le CNAME automatiquement
• Attendre la validation (peut prendre 1-5 min)

Étape 4 — Vérifier la propagation DNS (5-15 min)

Vérifier sur https://dnschecker.org que expria.app pointe vers Cloudflare Pages. Ne pas continuer avant que la propagation soit visible depuis au moins 3 régions.

Étape 5 — Smoke test en production (15 min)

Rejouer le Groupe Z du GOLDEN_DATASET.md sur expria.app :

• Z1 — Inscription + première simulation Free
• Z2 — Blocage quota Free
• Z3 — Simulation Standard complète
• Z4 — Mode examen bloqué en Standard
• Z5 — T2 live Premium
• Z6 — Mode examen EE complet
• Z7 — Paiement Free → Standard
• Z8 — Prorata Standard → Premium
• Z9 — Déconnexion + accès protégé
• Z10 — Responsive mobile Home + Login

Étape 6 — Vérifier Sentry (5 min)

• Ouvrir le dashboard Sentry projet expria-frontend
• Vérifier qu'aucune erreur critique n'apparaît dans les 5 premières minutes
• Si erreur critique → déclencher le rollback immédiatement

Étape 7 — Déclarer la bascule réussie

• Noter la date et l'heure dans ce fichier (section 6)
• Désactiver MAINTENANCE_MODE sur V1 (optionnel — V1 reste sur Render comme fallback 30 jours)

---

4. Rollback — si quelque chose casse

Objectif : revenir sur V1 en moins de 10 minutes.

Étape 1 — Désactiver V2 (2 min)

Dans Cloudflare Pages → projet expria-frontend :

• Désactiver le domaine personnalisé expria.app

Étape 2 — Remettre V1 en ligne (3 min)

Dans Vercel → Domains → expria.app :

• Remettre le CNAME/A record vers Render (valeur originale) Dans Render → service frontend V1 :
• Modifier MAINTENANCE_MODE=false
• Redéployer

Étape 3 — Vérifier (5 min)

• Vérifier que expria.app affiche à nouveau V1
• Vérifier que la connexion et une simulation fonctionnent

Étape 4 — Diagnostiquer

• Ouvrir Sentry V2 — identifier l'erreur critique
• Ne pas retenter la bascule avant d'avoir corrigé et rejoué le Groupe Z complet

---

5. Post-bascule — checks 24h après

• Sentry : aucune erreur critique nouvelle
• Stripe : webhooks reçus et traités correctement
• Supabase : aucune erreur d'auth dans les logs
• Au moins 1 simulation complète effectuée par un vrai utilisateur
• V1 sur Render toujours en ligne comme fallback (désactiver après 30 jours)

---

6. Historique des déploiements

Date	Version	Résultat	Notes
—	—	—	—

---

7. Historique du document

Version	Date	Changements
1.0	2026-04-19	Création initiale