وثائق النشر

نظرة عامة

تغطي هذه الدليل الشامل جميع جوانب نشر LoyaltyTree في بيئات وتكوينات مختلفة. اختر طريقة النشر التي تناسب إعداد متجرك بشكل أفضل.

خيارات النشر

1. تثبيت من متجر تطبيقات Shopify (موصى به)

أسهل طريقة نشر لمعظم التجار:

المتطلبات الأساسية

• متجر Shopify نشط (أي خطة)
• حساب مالك المتجر أو موظف لديه أذونات تثبيت التطبيقات
• الوصول إلى البريد الإلكتروني للتحقق

خطوات التثبيت

1. زيارة متجر تطبيقات Shopify

   • ابحث عن "LoyaltyTree"
   • انقر على زر "إضافة تطبيق"
   • راجع الأذونات ووافق

2. إكمال الإعداد

   • الكشف التلقائي عن المتجر والتكوين
   • اختر إعدادات برنامج الولاء
   • تخصيص الأدوات والرسائل

3. اختبار التكامل

   • قم بإجراء طلبات اختبار للتحقق من تخصيص البذور
   • اختبار عملية استرداد الشجرة
   • تحقق من إشعارات العملاء

2. التثبيت المخصص للوكالات

للوكالات التي تدير متاجر عملاء متعددة:

المتطلبات الأساسية

• حساب شريك LoyaltyTree
• بيانات اعتماد الوصول إلى واجهة برمجة التطبيقات
• إعداد بيئة التطوير

عملية التكوين

# استنساخ مستودع النشر
git clone https://github.com/loyalty-tree/shopify-deployment

# تكوين البيئة
cp .env.example .env
# تحرير .env بإعدادات المتجر المحددة

# تشغيل برنامج النشر
npm run deploy --store=client-store.myshopify.com

3. نشر العلامة البيضاء

للعلامات التجارية التي ترغب في تخصيص العلامة التجارية:

الميزات

• نطاق مخصص وعلامة تجارية
• قوالب بريد إلكتروني مخصصة
• تصميمات أدوات مخصصة
• فريق دعم مخصص

عملية الإعداد

1. إعداد حساب المؤسسة

   • اتصل بفريق المبيعات
   • تحديد متطلبات العلامة التجارية
   • مراجعة الجدول الزمني للنشر

2. التكوين المخصص

   • نقاط نهاية واجهة برمجة التطبيقات الخاصة بالعلامة التجارية
   • قوالب بريد إلكتروني مخصصة
   • تطوير موضوع الأداة

نشر محدد بالخطة

متاجر Shopify Plus

نشر امتداد الخروج

• تثبيت امتداد الخروج تلقائيًا
• تكامل التسعير الديناميكي
• تتبع تحليلات متقدمة
• دعم العملات المتعددة

التكوين:

// الكشف التلقائي عن Plus
if (Shopify.shop.plan === "plus") {
  deployCheckoutExtension({
    features: ["tree-sponsorship", "impact-tracking"],
    pricing: "dynamic",
    currencies: "all"
  });
}

خطط Shopify القياسية

نشر أداة السلة

• تثبيت الأداة المدمجة في السمة
• دعم تعديل السمة يدويًا
• تتبع تحليلات قياسية
• دعم العملات الأساسية

كود التكامل:

<!-- أضف إلى قالب cart.liquid -->
{% render 'loyaltytree-cart-widget' %}

تكوين البيئة

بيئة التطوير

# إعدادات التطوير
NODE_ENV=development
SHOPIFY_APP_URL=https://your-ngrok-url.ngrok.io
ONESEED_ENVIRONMENT=sandbox
DATABASE_URL=postgresql://localhost:5432/loyalty_dev

بيئة الاختبار

# إعدادات الاختبار
NODE_ENV=staging
SHOPIFY_APP_URL=https://staging.loyalty.eco
ONESEED_ENVIRONMENT=staging
DATABASE_URL=postgresql://staging-db/loyalty_staging

بيئة الإنتاج

# إعدادات الإنتاج
NODE_ENV=production
SHOPIFY_APP_URL=https://loyalty.eco
ONESEED_ENVIRONMENT=production
DATABASE_URL=postgresql://prod-db/loyalty_production

تكوين الأمان

إعداد SSL/TLS

• مطلوب لجميع عمليات النشر في الإنتاج
• إدارة الشهادات تلقائيًا
• فرض HTTPS لجميع نقاط النهاية

أمان Webhook

// التحقق من توقيع 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;
}

تشفير البيانات

• تشفير بيانات العملاء أثناء الراحة
• الامتثال لمعيار PCI DSS لبيانات الدفع
• الامتثال لـ GDPR للعملاء في الاتحاد الأوروبي

المراقبة والصيانة

فحوصات الصحة

# مراقبة الصحة التلقائية
curl -f https://your-app.com/health || exit 1

# الاستجابة المتوقعة
{
  "status": "healthy",
  "database": "connected",
  "apis": {
    "shopify": "active",
    "oneseed": "active"
  },
  "uptime": "99.9%"
}

مراقبة الأداء

• مقاييس الأداء في الوقت الحقيقي
• تتبع الأخطاء والتنبيه
• تكوين التوسع التلقائي
• تحسين قاعدة البيانات

استراتيجية النسخ الاحتياطي

• نسخ احتياطية لقاعدة البيانات كل ساعة
• نسخ احتياطية كاملة للنظام أسبوعيًا
• القدرة على الاسترداد في الوقت المحدد
• إجراءات استعادة الكوارث

استكشاف أخطاء النشر

المشكلات الشائعة

أخطاء شهادة SSL

• تحقق من تكوين DNS للنطاق
• تحقق من تواريخ انتهاء صلاحية الشهادات
• تأكد من سلسلة الشهادات الصحيحة

فشل الاتصال بقاعدة البيانات

• تحقق من سلاسل الاتصال
• تحقق من إعدادات جدار الحماية
• تحقق من بيانات اعتماد المصادقة

مشكلات تكامل واجهة برمجة التطبيقات

• اختبار الاتصال بنقاط نهاية واجهة برمجة التطبيقات
• تحقق من رموز المصادقة
• تحقق من إعدادات تحديد المعدل

موارد الدعم

• دليل النشر: تعليمات بصرية خطوة بخطوة
• دروس فيديو: مقاطع فيديو نشر خاصة بالمنصة
• الدعم الفني: البريد الإلكتروني support@loyalty.eco
• الدعم الطارئ: مساعدة في القضايا الحرجة على مدار الساعة

التحقق من النجاح

قائمة التحقق بعد النشر

• التطبيق يظهر في إدارة Shopify
• الأدوات تعرض بشكل صحيح على واجهة المتجر
• الطلبات التجريبية تتم بنجاح
• Webhooks تسلم بشكل صحيح
• رسائل البريد الإلكتروني للعملاء ترسل بشكل صحيح
• تتبع التحليلات يعمل
• تكامل زراعة الأشجار يعمل

معايير الأداء

• أثر تحميل الصفحة: <200 مللي ثانية زمن تحميل إضافي
• معدل التحويل: 15-25% اعتماد رعاية الأشجار
• زيادة قيمة الطلب: $8-15 متوسط الزيادة
• رضا العملاء: >90% تعليقات إيجابية

لقد اكتمل نشر LoyaltyTree الخاص بك الآن وهو جاهز لدفع التأثير البيئي والمشاركة مع العملاء!