DOC
Accueil/ Projets/ MJY Task Platform/ Guide de Déploiement Netlify - Plateforme MJY Holding

Guide de Déploiement Netlify - Plateforme MJY Holding

Ce guide détaille la procédure de configuration et de déploiement (manuel et continu) de l'application MJY Holding sur Netlify.

1. Déploiement Continu via GitHub (Recommandé)

Étape 1.1 : Lier le dépôt GitHub à Netlify

  1. Connectez-vous sur votre dashboard Netlify.
  2. Cliquez sur Add new site > Import an existing project.
  3. Choisissez GitHub comme fournisseur Git et autorisez Netlify à accéder à vos dépôts.
  4. Sélectionnez le dépôt MYJ-Holding-Platform.

Étape 1.2 : Configurer les paramètres de build

Dans l'interface de configuration de Netlify, renseignez les champs suivants :

  • Branch to deploy : main (ou master)
  • Base directory : Laissez vide (ou racine ./)
  • Build command : npm run build
  • Publish directory : dist
  • Functions directory : netlify/functions (si présent, Netlify détecte automatiquement ce dossier pour les fonctions serverless).

Étape 1.3 : Déclaration des variables d'environnement

Dans l'onglet Site configuration > Environment variables sur Netlify, ajoutez les clés d'API suivantes :

  1. VITE_SUPABASE_URL : L'URL de votre projet Supabase (ex: https://xxxx.supabase.co).
  2. VITE_SUPABASE_ANON_KEY : La clé publique anonyme de Supabase.
  3. VITE_ANTHROPIC_API_KEY : Votre clé secrète pour l'API Anthropic (utilisée par la fonction serverless d'import IA).

Note : Les variables préfixées par VITE_ sont automatiquement injectées dans le code client par le bundler Vite.

2. Déploiement Automatisé via GitHub Actions (CI/CD)

Le projet intègre un workflow d'intégration continue sous .github/workflows/netlify.yml. Pour l'activer, vous devez ajouter deux variables secrètes (Secrets) dans les paramètres de votre dépôt GitHub (Settings > Secrets and variables > Actions > New repository secret) :

  1. NETLIFY_AUTH_TOKEN : Votre jeton d'accès personnel Netlify (généré dans votre profil Netlify sous User Settings > Applications > Personal access tokens).
  2. NETLIFY_SITE_ID : L'identifiant API du site Netlify (situé sur Netlify dans Site configuration > Site details > API ID).

Une fois configuré, chaque commit poussé sur la branche main déclenchera automatiquement le build et le déploiement sur Netlify.

3. Déploiement Local Manuel (via Netlify CLI)

Si vous souhaitez tester le build et les fonctions serverless localement ou déployer manuellement depuis votre poste, utilisez la CLI Netlify.

Prérequis

Installez la CLI globalement :

npm install -g netlify-cli

Lancer l'environnement de développement local

Pour exécuter l'application et les fonctions Netlify localement avec rechargement à chaud :

netlify dev

Cela lancera l'application sur http://localhost:8888 et simulera l'API serverless /api/storage et /api/import.

Déployer manuellement en production

# 1. Builder l'application
npm run build

# 2. Déployer en production
netlify deploy --prod --dir=dist --functions=netlify/functions