Documentación de Despliegue

Visión General

Esta guía completa cubre todos los aspectos del despliegue de LoyaltyTree en diferentes entornos y configuraciones. Elija el método de despliegue que mejor se adapte a la configuración de su tienda.

Opciones de Despliegue

1. Instalación desde la Tienda de Aplicaciones de Shopify (Recomendado)

El método de despliegue más simple para la mayoría de los comerciantes:

Requisitos Previos

• Tienda de Shopify activa (cualquier plan)
• Cuenta de propietario de la tienda o personal con permisos de instalación de aplicaciones
• Acceso al correo electrónico para verificación

Pasos de Instalación

1. Visitar la Tienda de Aplicaciones de Shopify

   • Buscar "LoyaltyTree"
   • Hacer clic en el botón "Agregar aplicación"
   • Revisar permisos y aprobar

2. Completar Configuración

   • Detección y configuración automática de la tienda
   • Elegir configuraciones del programa de lealtad
   • Personalizar widgets y mensajes

3. Probar Integración

   • Realizar pedidos de prueba para verificar la asignación de semillas
   • Probar el proceso de redención del árbol
   • Verificar notificaciones a clientes

2. Instalación Personalizada para Agencias

Para agencias que gestionan múltiples tiendas de clientes:

Requisitos Previos

• Cuenta de Socio de LoyaltyTree
• Credenciales de acceso a la API
• Configuración del entorno de desarrollo

Proceso de Configuración

# Clonar el repositorio de despliegue
git clone https://github.com/loyalty-tree/shopify-deployment

# Configurar el entorno
cp .env.example .env
# Editar .env con configuraciones específicas de la tienda

# Ejecutar el script de despliegue
npm run deploy --store=client-store.myshopify.com

3. Despliegue de Marca Blanca

Para marcas que desean una personalización de marca:

Características

• Dominio y marca personalizados
• Plantillas de correo electrónico personalizadas
• Diseños de widgets personalizados
• Equipo de soporte dedicado

Proceso de Configuración

1. Configuración de Cuenta Empresarial

   • Contactar al equipo de ventas
   • Definir requisitos de marca
   • Revisar cronograma de despliegue

2. Configuración Personalizada

   • Puntos finales de API específicos de la marca
   • Plantillas de correo electrónico personalizadas
   • Desarrollo de temas de widgets

Despliegue Específico del Plan

Tiendas Shopify Plus

Despliegue de Extensión de Checkout

• Instalación automática de la extensión de checkout
• Integración de precios dinámicos
• Seguimiento de análisis avanzado
• Soporte para múltiples monedas

Configuración:

// Detección automática de Plus
if (Shopify.shop.plan === "plus") {
  deployCheckoutExtension({
    features: ["tree-sponsorship", "impact-tracking"],
    pricing: "dynamic",
    currencies: "all"
  });
}

Planes Estándar de Shopify

Despliegue de Widget de Carrito

• Instalación de widget integrado en el tema
• Soporte para modificación manual del tema
• Seguimiento de análisis estándar
• Soporte básico para monedas

Código de Integración:

<!-- Agregar a la plantilla cart.liquid -->
{% render 'loyaltytree-cart-widget' %}

Configuración del Entorno

Entorno de Desarrollo

# Configuraciones de desarrollo
NODE_ENV=development
SHOPIFY_APP_URL=https://your-ngrok-url.ngrok.io
ONESEED_ENVIRONMENT=sandbox
DATABASE_URL=postgresql://localhost:5432/loyalty_dev

Entorno de Staging

# Configuraciones de staging
NODE_ENV=staging
SHOPIFY_APP_URL=https://staging.loyalty.eco
ONESEED_ENVIRONMENT=staging
DATABASE_URL=postgresql://staging-db/loyalty_staging

Entorno de Producción

# Configuraciones de producción
NODE_ENV=production
SHOPIFY_APP_URL=https://loyalty.eco
ONESEED_ENVIRONMENT=production
DATABASE_URL=postgresql://prod-db/loyalty_production

Configuración de Seguridad

Configuración de SSL/TLS

• Requerido para todos los despliegues de producción
• Gestión automática de certificados
• Aplicación de HTTPS para todos los puntos finales

Seguridad de Webhook

// Verificación de firma de 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;
}

Cifrado de Datos

• Datos de clientes cifrados en reposo
• Cumplimiento de PCI DSS para datos de pago
• Cumplimiento de GDPR para clientes de la UE

Monitoreo y Mantenimiento

Chequeos de Salud

# Monitoreo de salud automatizado
curl -f https://your-app.com/health || exit 1

# Respuesta esperada
{
  "status": "healthy",
  "database": "connected",
  "apis": {
    "shopify": "active",
    "oneseed": "active"
  },
  "uptime": "99.9%"
}

Monitoreo de Rendimiento

• Métricas de rendimiento en tiempo real
• Seguimiento y alerta de errores
• Configuración de escalado automático
• Optimización de bases de datos

Estrategia de Respaldo

• Respaldos de base de datos cada hora
• Respaldos completos del sistema cada semana
• Capacidad de recuperación en un punto en el tiempo
• Procedimientos de recuperación ante desastres

Solución de Problemas de Despliegue

Problemas Comunes

Errores de Certificado SSL

• Verificar la configuración DNS del dominio
• Comprobar las fechas de expiración del certificado
• Asegurarse de la cadena de certificados correcta

Fallas de Conexión a la Base de Datos

• Validar cadenas de conexión
• Comprobar configuraciones de firewall
• Verificar credenciales de autenticación

Problemas de Integración de API

• Probar la conectividad del punto final de la API
• Verificar tokens de autenticación
• Comprobar configuraciones de limitación de tasa

Recursos de Soporte

• Guía de Despliegue: Instrucciones visuales paso a paso
• Tutoriales en Video: Videos de despliegue específicos de la plataforma
• Soporte Técnico: Correo electrónico support@loyalty.eco
• Soporte de Emergencia: Asistencia para problemas críticos 24/7

Validación de Éxito

Lista de Verificación Post-Despliegue

• La aplicación aparece en el admin de Shopify
• Los widgets se muestran correctamente en la tienda
• Los pedidos de prueba se procesan con éxito
• Los webhooks se entregan correctamente
• Los correos electrónicos a clientes se envían correctamente
• El seguimiento de análisis funciona
• La integración de plantación de árboles funciona

Referencias de Rendimiento

• Impacto en la Carga de Página: <200ms de tiempo de carga adicional
• Tasa de Conversión: 15-25% de adopción de patrocinio de árboles
• Aumento del Valor del Pedido: $8-15 de aumento promedio
• Satisfacción del Cliente: >90% de retroalimentación positiva

¡Su despliegue de LoyaltyTree ahora está completo y listo para impulsar el impacto ambiental y el compromiso del cliente!