> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adrkha.com/llms.txt
> Use this file to discover all available pages before exploring further.

# الإعداد الأول: هيّئ التطبيق لمتجرك خطوة بخطوة

> أعدّ تفضيلات المزامنة واختر البيانات التي تريد مزامنتها عند تشغيل التطبيق لأول مرة للحصول على أفضل النتائج.

تهانينا على الوصول إلى هذه المرحلة! بعد تثبيت التطبيق ومنح الصلاحيات وربط متجرك بنجاح، حان الوقت للخطوة الأهم: تهيئة إعدادات المزامنة لتتناسب تماماً مع احتياجات متجرك. في هذا الدليل، ستتعلم كيفية اختيار نوع المزامنة (تلقائية أو يدوية)، وتحديد البيانات التي تريد مزامنتها، وتشغيل أول مزامنة لمتجرك.

## المتطلبات المسبقة

<Note>
  قبل البدء في الإعداد الأول، تأكد من إتمام الخطوات الثلاث السابقة بنجاح:

  * ✅ **تثبيت التطبيق** — [راجع دليل التثبيت](/getting-started/install-app)
  * ✅ **منح الصلاحيات** المطلوبة — [راجع دليل منح الصلاحيات](/getting-started/grant-permissions)
  * ✅ **ربط المتجر** وتأكيد نجاح الاتصال — [راجع دليل ربط المتجر](/getting-started/connect-store)
</Note>

## الخطوة 1: الوصول إلى إعدادات المزامنة

<Steps>
  <Step title="افتح لوحة تحكم التطبيق">
    من متجر تطبيقات سلة أو زد، افتح التطبيق. ستُعرض عليك لوحة التحكم الرئيسية التي تُظهر ملخصاً لحالة متجرك ومؤشرات المزامنة.
  </Step>

  <Step title="انتقل إلى قسم الإعدادات">
    انقر على **"الإعدادات"** أو أيقونة الترس ⚙️ في القائمة الجانبية أو الشريط العلوي. ثم اختر **"إعدادات المزامنة"** أو **"تفضيلات المزامنة"**.

    *\[لقطة شاشة: إعدادات المزامنة]*
  </Step>
</Steps>

## الخطوة 2: اختيار نوع المزامنة

<Steps>
  <Step title="حدد نوع المزامنة المناسب لك">
    ستجد خيارَي المزامنة الرئيسيَّين:

    <CardGroup cols={2}>
      <Card title="مزامنة تلقائية" icon="rotate">
        **الأنسب لـ:** المتاجر التي تحتاج إلى تحديثات مستمرة وفورية.

        يقوم التطبيق بمزامنة بياناتك تلقائياً في الفترات الزمنية التي تحددها، دون أي تدخل يدوي منك. مثالي للمتاجر ذات المنتجات الكثيرة والطلبات المتكررة.
      </Card>

      <Card title="مزامنة يدوية" icon="hand-pointer">
        **الأنسب لـ:** المتاجر الصغيرة أو التي تفضّل التحكم الكامل في وقت المزامنة.

        تتحكم أنت في توقيت المزامنة بالضغط على زر **"مزامنة الآن"** عند الحاجة. مفيد إذا أردت مراجعة التغييرات قبل تطبيقها.
      </Card>
    </CardGroup>

    <Tip>
      إذا كنت غير متأكد، ابدأ بـ**المزامنة التلقائية** — يمكنك تغييرها لاحقاً في أي وقت من إعدادات التطبيق.
    </Tip>
  </Step>

  <Step title="انقر على نوع المزامنة واحفظ اختيارك">
    انقر على الخيار المناسب وسيتحول لون المربع المحيط به إلى الأزرق تأكيداً للاختيار. لا تنسَ النقر على **"حفظ"** قبل الانتقال إلى الخطوة التالية.
  </Step>
</Steps>

## الخطوة 3: تحديد تكرار المزامنة التلقائية

إذا اخترت المزامنة التلقائية، ستحتاج إلى تحديد مدى تكرارها:

<Steps>
  <Step title="اختر تكرار المزامنة">
    ستجد خيارات متعددة لتكرار المزامنة:

    | التكرار         | الأنسب لـ                                        |
    | --------------- | ------------------------------------------------ |
    | **كل 15 دقيقة** | المتاجر التي تشهد حركة بيع نشطة جداً             |
    | **كل ساعة**     | المتاجر المتوسطة ذات الطلبات اليومية المعتدلة    |
    | **كل 6 ساعات**  | المتاجر الصغيرة التي لا تحتاج إلى تحديثات متكررة |
    | **مرة يومياً**  | المتاجر التي تُفضّل مزامنة يومية موحّدة          |

    <Tip>
      للبداية، نوصي باختيار **"كل ساعة"** حتى تتعرف على سلوك التطبيق وتتأكد من أن كل شيء يعمل كما تتوقع. يمكنك تعديل التكرار لاحقاً حسب احتياجاتك.
    </Tip>
  </Step>

  <Step title="احفظ إعداد التكرار">
    بعد اختيار التكرار المناسب، انقر على **"حفظ الإعدادات"**.
  </Step>
</Steps>

## الخطوة 4: اختيار البيانات المراد مزامنتها

<Steps>
  <Step title="حدد أنواع البيانات للمزامنة">
    في قسم **"البيانات المزامَنة"**، ستجد قائمة بأنواع البيانات المتاحة. فعّل أو أوقف كل نوع حسب احتياجك:

    <AccordionGroup>
      <Accordion title="المنتجات — موصى بتفعيله">
        تزامن جميع بيانات منتجاتك بما في ذلك:

        * الأسماء والأوصاف
        * الأسعار والعروض
        * كميات المخزون
        * الصور والوسائط
        * التصنيفات والوسوم

        **الحالة الافتراضية:** مُفعَّل ✅
      </Accordion>

      <Accordion title="الطلبات — موصى بتفعيله">
        تزامن بيانات الطلبات الواردة بما في ذلك:

        * تفاصيل الطلب والمنتجات المطلوبة
        * حالة الطلب (جديد، قيد المعالجة، مكتمل)
        * بيانات الشحن والتسليم
        * معلومات الدفع

        **الحالة الافتراضية:** مُفعَّل ✅
      </Accordion>

      <Accordion title="بيانات العملاء — اختياري">
        تزامن معلومات العملاء الأساسية بما في ذلك:

        * الأسماء وبيانات الاتصال
        * عناوين الشحن المحفوظة
        * سجل الطلبات

        **الحالة الافتراضية:** مُفعَّل ✅ (يمكن إيقافه إذا كنت لا تحتاجه)
      </Accordion>
    </AccordionGroup>

    <Warning>
      تأكد من إبقاء مزامنة **المنتجات** و**الطلبات** مُفعَّلتَين على الأقل. إيقافهما سيعطّل الوظائف الرئيسية للتطبيق ويجعله عملياً بدون فائدة.
    </Warning>
  </Step>

  <Step title="هيّئ إعدادات كل نوع بيانات">
    انقر على السهم بجانب كل نوع بيانات لتوسيع إعداداته وتخصيصها، مثل:

    * **المنتجات:** اختر ما إذا كنت تريد مزامنة المنتجات المتوقفة عن البيع أم المنتجات النشطة فقط.
    * **الطلبات:** حدد حالات الطلبات التي تريد تتبعها (مثلاً: تجاهل الطلبات الملغاة).
    * **العملاء:** اختر ما إذا كنت تريد تضمين عملاء الضيف أم لا.
  </Step>

  <Step title="احفظ إعدادات البيانات">
    بعد تخصيص كل إعداد، انقر على **"حفظ الإعدادات"** في أسفل الصفحة.
  </Step>
</Steps>

## الخطوة 5: حفظ الإعدادات وتشغيل المزامنة الأولى

<Steps>
  <Step title="راجع ملخص إعداداتك">
    قبل تشغيل المزامنة الأولى، ستظهر لك شاشة ملخص تُظهر جميع إعداداتك:

    * نوع المزامنة (تلقائية/يدوية)
    * تكرار المزامنة
    * أنواع البيانات المُفعَّلة

    تأكد من صحة جميع الإعدادات.
  </Step>

  <Step title="انقر على 'حفظ وابدأ المزامنة'">
    عند الاستعداد، انقر على الزر **"حفظ وابدأ المزامنة الأولى"** أو **"تشغيل المزامنة"**. سيبدأ التطبيق فوراً في مزامنة بيانات متجرك.

    *\[لقطة شاشة: بدء المزامنة الأولى]*
  </Step>

  <Step title="راقب تقدم المزامنة الأولى">
    ستظهر لك شاشة تقدم تُظهر:

    * عدد المنتجات التي تمت مزامنتها
    * عدد الطلبات المعالجة
    * الوقت المتبقي التقديري

    المزامنة الأولى قد تستغرق من **دقيقتين إلى 15 دقيقة** حسب حجم متجرك. لا تُغلق الصفحة أثناء المزامنة الأولى.

    <Info>
      المزامنات التالية ستكون أسرع بكثير لأن التطبيق سيزامن فقط التغييرات الجديدة، وليس جميع البيانات من الصفر.
    </Info>
  </Step>
</Steps>

<Tip>
  بعد اكتمال المزامنة الأولى، انتقل إلى قسم **"المنتجات"** في لوحة تحكم التطبيق وتحقق من ظهور منتجات متجرك بشكل صحيح. هذا سيؤكد لك أن كل شيء يعمل على ما يرام.
</Tip>

## النتيجة المتوقعة

بعد إتمام الإعداد الأول وتشغيل المزامنة الأولى بنجاح:

* ستظهر لوحة التحكم الرئيسية مع **إحصائيات حية** لمتجرك: عدد المنتجات، الطلبات النشطة، وآخر وقت للمزامنة.
* تظهر رسالة **"اكتملت المزامنة بنجاح"** مع وقت وتاريخ آخر مزامنة.
* يبدأ التطبيق في **المزامنة التلقائية** حسب الجدول الذي حددته (إن اخترت هذا الخيار).
* أصبحت جميع بيانات منتجاتك وطلباتك متاحة في لوحة تحكم التطبيق.

## استكشاف الأخطاء

<AccordionGroup>
  <Accordion title="المزامنة الأولى توقفت في المنتصف ولم تكتمل">
    قد يكون الاتصال بالإنترنت قد انقطع أو حدث خطأ مؤقت. جرّب الخطوات التالية:

    1. أعد تحميل الصفحة وتحقق من حالة المزامنة في لوحة التحكم.
    2. إذا ظهرت حالة **"متوقفة"** أو **"خطأ"**، انقر على **"إعادة المحاولة"** أو **"إعادة تشغيل المزامنة"**.
    3. تأكد من استقرار اتصالك بالإنترنت.
    4. إذا تكرر الخطأ، تواصل مع [الدعم الفني](/support/contact-support) وأرسل لهم رسالة الخطأ الظاهرة.
  </Accordion>

  <Accordion title="بعض المنتجات لم تظهر بعد المزامنة">
    تأكد من أن المنتجات المفقودة في حالة **"نشط"** وليس **"مسودة"** في متجرك الأصلي. التطبيق في إعداداته الافتراضية يزامن المنتجات النشطة فقط. يمكنك تغيير هذا الإعداد من **الإعدادات > المنتجات > تضمين المسودات**.
  </Accordion>

  <Accordion title="إعدادات المزامنة لا تُحفظ">
    تأكد من النقر على **"حفظ"** بعد كل تغيير. إذا لم تظهر رسالة تأكيد الحفظ، جرّب مسح ذاكرة التخزين المؤقت للمتصفح ثم أعد إدخال الإعدادات. إذا استمرت المشكلة، تواصل مع [الدعم](/support/contact-support).
  </Accordion>
</AccordionGroup>

## الأسئلة الشائعة

<AccordionGroup>
  <Accordion title="هل يمكنني تغيير إعدادات المزامنة بعد الإعداد الأول؟">
    نعم، يمكنك تعديل جميع إعدادات المزامنة في أي وقت من **الإعدادات > إعدادات المزامنة**. أي تغيير تجريه سيُطبَّق فوراً على المزامنات القادمة.
  </Accordion>

  <Accordion title="هل ستُحذف بياناتي الحالية في المتجر عند أول مزامنة؟">
    لا، المزامنة الأولى تقرأ البيانات الموجودة وتُضيف إليها أو تُحدّثها، ولا تحذف أي بيانات قائمة. بياناتك في المتجر الأصلي تبقى كما هي.
  </Accordion>

  <Accordion title="ماذا يحدث إذا تعارضت البيانات بين المتجر والتطبيق؟">
    في حالة التعارض، يعتمد التطبيق على المصدر الأصلي (متجرك في سلة أو زد) باعتباره المرجع الرئيسي. يمكنك تغيير هذا السلوك من **الإعدادات > حل التعارضات** وتحديد الأولوية التي تفضّلها.
  </Accordion>

  <Accordion title="هل يمكنني إيقاف المزامنة التلقائية مؤقتاً دون تغيير الإعدادات؟">
    نعم، في لوحة التحكم الرئيسية يوجد زر **"إيقاف مؤقت"** أو **"تعليق المزامنة"** يتيح لك إيقاف المزامنة التلقائية مؤقتاً دون الحاجة إلى تغيير إعداداتك. مفيد عند إجراء تحديثات كبيرة على المنتجات.
  </Accordion>
</AccordionGroup>

## المقالات ذات الصلة

<CardGroup cols={2}>
  <Card title="ربط متجرك بالتطبيق" icon="link" href="/getting-started/connect-store">
    إذا لم تكمل خطوة ربط المتجر بعد، راجع هذا الدليل أولاً.
  </Card>

  <Card title="مرحباً بك في مركز المساعدة" icon="house" href="/getting-started/welcome">
    عد إلى صفحة الترحيب للاطلاع على نظرة عامة على جميع إمكانيات التطبيق.
  </Card>
</CardGroup>

## تواصل مع الدعم

<Note>
  هل تواجه صعوبة في الإعداد أو تريد مساعدة في تحديد الإعدادات الأنسب لحجم متجرك؟ فريق الدعم لدينا يسعده تقديم المشورة والمساعدة الشخصية. تواصل معنا عبر صفحة [التواصل مع الدعم](/support/contact-support) وسيتواصل معك أحد المختصين في أقرب وقت.
</Note>