Documentation de Déploiement

Aperçu

Ce guide complet couvre tous les aspects du déploiement de LoyaltyTree dans différents environnements et configurations. Choisissez la méthode de déploiement qui convient le mieux à la configuration de votre magasin.

Options de Déploiement

1. Installation depuis la Boutique d'Applications Shopify (Recommandé)

La méthode de déploiement la plus simple pour la plupart des commerçants :

Prérequis

• Magasin Shopify actif (tous les plans)
• Compte propriétaire ou membre du personnel avec autorisations d'installation d'applications
• Accès à l'email pour vérification

Étapes d'Installation

1. Visitez la Boutique d'Applications Shopify

   • Recherchez "LoyaltyTree"
   • Cliquez sur le bouton "Ajouter l'application"
   • Examinez les autorisations et approuvez

2. Complétez la Configuration

   • Détection et configuration automatiques du magasin
   • Choisissez les paramètres du programme de fidélité
   • Personnalisez les widgets et les messages

3. Testez l'Intégration

   • Passez des commandes de test pour vérifier l'allocation des semences
   • Testez le processus de rachat d'arbres
   • Vérifiez les notifications clients

2. Installation Personnalisée pour les Agences

Pour les agences gérant plusieurs magasins clients :

Prérequis

• Compte Partenaire LoyaltyTree
• Identifiants d'accès API
• Configuration de l'environnement de développement

Processus de Configuration

# Cloner le dépôt de déploiement
git clone https://github.com/loyalty-tree/shopify-deployment

# Configurer l'environnement
cp .env.example .env
# Modifier .env avec les paramètres spécifiques au magasin

# Exécuter le script de déploiement
npm run deploy --store=client-store.myshopify.com

3. Déploiement en Marque Blanche

Pour les marques souhaitant une image de marque personnalisée :

Fonctionnalités

• Domaine et image de marque personnalisés
• Modèles d'email personnalisés
• Designs de widgets personnalisés
• Équipe de support dédiée

Processus de Configuration

1. Configuration du Compte Entreprise

   • Contacter l'équipe commerciale
   • Définir les exigences de marque
   • Examiner le calendrier de déploiement

2. Configuration Personnalisée

   • Points de terminaison API spécifiques à la marque
   • Modèles d'email personnalisés
   • Développement de thèmes de widgets

Déploiement Spécifique au Plan

Magasins Shopify Plus

Déploiement de l'Extension de Paiement

• Installation automatique de l'extension de paiement
• Intégration de tarification dynamique
• Suivi analytique avancé
• Support multi-devises

Configuration :

// Détection automatique de Plus
if (Shopify.shop.plan === "plus") {
  deployCheckoutExtension({
    features: ["tree-sponsorship", "impact-tracking"],
    pricing: "dynamic",
    currencies: "all"
  });
}

Plans Shopify Standards

Déploiement du Widget de Panier

• Installation de widget intégré au thème
• Support de modification manuelle du thème
• Suivi analytique standard
• Support de devises de base

Code d'Intégration :

<!-- Ajouter au modèle cart.liquid -->
{% render 'loyaltytree-cart-widget' %}

Configuration de l'Environnement

Environnement de Développement

# Paramètres de développement
NODE_ENV=development
SHOPIFY_APP_URL=https://your-ngrok-url.ngrok.io
ONESEED_ENVIRONMENT=sandbox
DATABASE_URL=postgresql://localhost:5432/loyalty_dev

Environnement de Préproduction

# Paramètres de préproduction
NODE_ENV=staging
SHOPIFY_APP_URL=https://staging.loyalty.eco
ONESEED_ENVIRONMENT=staging
DATABASE_URL=postgresql://staging-db/loyalty_staging

Environnement de Production

# Paramètres de production
NODE_ENV=production
SHOPIFY_APP_URL=https://loyalty.eco
ONESEED_ENVIRONMENT=production
DATABASE_URL=postgresql://prod-db/loyalty_production

Configuration de Sécurité

Configuration SSL/TLS

• Requise pour tous les déploiements en production
• Gestion automatique des certificats
• Application du HTTPS pour tous les points de terminaison

Sécurité des Webhooks

// Vérification de la signature du webhook
const crypto = require('crypto');
const webhook_secret = process.env.SHOPIFY_WEBHOOK_SECRET;

function verifyWebhook(data, signature) {
  const calculated = crypto
    .createHmac('sha256', webhook_secret)
    .update(data, 'utf8')
    .digest('base64');
  
  return calculated === signature;
}

Chiffrement des Données

• Données clients chiffrées au repos
• Conformité PCI DSS pour les données de paiement
• Conformité RGPD pour les clients de l'UE

Surveillance & Maintenance

Vérifications de Santé

# Surveillance de santé automatisée
curl -f https://your-app.com/health || exit 1

# Réponse attendue
{
  "status": "healthy",
  "database": "connected",
  "apis": {
    "shopify": "active",
    "oneseed": "active"
  },
  "uptime": "99.9%"
}

Surveillance de Performance

• Métriques de performance en temps réel
• Suivi et alertes d'erreurs
• Configuration de mise à l'échelle automatique
• Optimisation de la base de données

Stratégie de Sauvegarde

• Sauvegardes de base de données horaires
• Sauvegardes complètes du système hebdomadaires
• Capacité de récupération à un instant donné
• Procédures de récupération après sinistre

Dépannage du Déploiement

Problèmes Courants

Erreurs de Certificat SSL

• Vérifiez la configuration DNS du domaine
• Vérifiez les dates d'expiration des certificats
• Assurez-vous de la chaîne de certificats correcte

Échecs de Connexion à la Base de Données

• Validez les chaînes de connexion
• Vérifiez les paramètres du pare-feu
• Vérifiez les identifiants d'authentification

Problèmes d'Intégration API

• Testez la connectivité des points de terminaison API
• Vérifiez les jetons d'authentification
• Vérifiez les paramètres de limitation de débit

Ressources de Support

• Guide de Déploiement : Instructions visuelles étape par étape
• Tutoriels Vidéo : Vidéos de déploiement spécifiques à la plateforme
• Support Technique : Email support@loyalty.eco
• Support d'Urgence : Assistance 24/7 pour les problèmes critiques

Validation de Succès

Liste de Vérification Post-Déploiement

• L'application apparaît dans l'administration Shopify
• Les widgets s'affichent correctement sur la vitrine
• Les commandes de test sont traitées avec succès
• Les webhooks sont livrés correctement
• Les emails clients sont envoyés correctement
• Le suivi analytique fonctionne
• L'intégration de la plantation d'arbres fonctionne

Références de Performance

• Impact sur le Temps de Chargement de la Page : <200ms de temps de chargement supplémentaire
• Taux de Conversion : 15-25% d'adoption du parrainage d'arbres
• Augmentation de la Valeur des Commandes : $8-15 d'augmentation moyenne
• Satisfaction Client : >90% de retours positifs

Votre déploiement de LoyaltyTree est maintenant complet et prêt à générer un impact environnemental et à engager les clients !