> ## 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.

# تقارير وإحصاءات أداء المزامنة والمتجر

> راقب أداء متجرك من خلال تقارير المزامنة التفصيلية: عدد المنتجات المتزامنة، الطلبات المعالجة، الأخطاء، والاتجاهات الزمنية.

التقارير هي أداتك لقراءة ما يجري في متجرك بأرقام دقيقة وموضوعية. من خلال قسم التقارير، تستطيع أن ترى كم منتجاً جرت مزامنته خلال الأسبوع الماضي، وكم طلباً مرّ بالتطبيق، وأين وقعت الأخطاء، وما الاتجاه العام لأداء متجرك عبر الزمن. في هذا الدليل، ستتعرف على أنواع التقارير المتاحة، وكيف تقرأ الرسوم البيانية وتُفسّرها، وكيف تُصدّر البيانات لمشاركتها مع فريقك أو لأغراض المحاسبة.

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

* إتمام على الأقل عملية مزامنة واحدة حتى تتوفر بيانات في التقارير. راجع [الإعداد الأولي](/getting-started/first-setup).
* الدخول إلى التطبيق بصلاحيات تتيح عرض التقارير (مسؤول أو مشاهد).
* اتصال نشط بالإنترنت لتحميل الرسوم البيانية والبيانات التفاعلية.

***

## أنواع التقارير المتاحة

<CardGroup cols={2}>
  <Card title="📊 تقرير المزامنة" icon="arrows-rotate">
    يعرض سجلاً تفصيلياً لجميع عمليات المزامنة: عدد العمليات الناجحة والفاشلة، متوسط وقت التنفيذ، وعدد العناصر التي جرت مزامنتها في كل عملية.
  </Card>

  <Card title="🛒 تقرير الطلبات" icon="bag-shopping">
    يُلخّص الطلبات التي مرّت عبر التطبيق: إجمالي عددها، توزيعها حسب الحالة، متوسط قيمتها، وتوزيعها الزمني خلال الفترة المحددة.
  </Card>

  <Card title="⚠️ تقرير الأخطاء" icon="triangle-exclamation">
    يُجمّع جميع الأخطاء التي وقعت خلال الفترة المحددة مع تصنيفها حسب النوع والتكرار، مما يُساعدك على تحديد المشكلات المتكررة ومعالجتها جذرياً.
  </Card>

  <Card title="📦 تقرير المنتجات" icon="box">
    يعرض إحصاءات تفصيلية للمنتجات: عدد المنتجات المتزامنة، المنتجات التي فشلت مزامنتها، والمنتجات التي لم تُزامَن بعد.
  </Card>
</CardGroup>

***

## عرض التقارير والتصفية حسب التاريخ

<Steps>
  <Step title="الوصول إلى قسم التقارير">
    من القائمة الجانبية، انقر على **التقارير**. ستجد الصفحة الرئيسية للتقارير تعرض ملخصاً سريعاً للأسبوع الماضي.
  </Step>

  <Step title="اختيار نوع التقرير">
    في الشريط العلوي للصفحة، انقر على نوع التقرير الذي تريد عرضه: **المزامنة** أو **الطلبات** أو **الأخطاء** أو **المنتجات**.
  </Step>

  <Step title="تحديد نطاق التاريخ">
    انقر على **فلتر التاريخ** في أعلى يسار الصفحة. ستظهر لك خيارات جاهزة:

    * آخر 7 أيام
    * آخر 30 يوماً
    * هذا الشهر
    * الشهر الماضي
    * نطاق مخصص (حدد تاريخَي البداية والنهاية يدوياً)

    اختر النطاق المناسب وانقر على **تطبيق**.
  </Step>

  <Step title="تطبيق فلاتر إضافية">
    لبعض التقارير، يمكنك تصفية النتائج بمعايير إضافية:

    * **تقرير الأخطاء**: تصفية حسب نوع الخطأ أو المنصة المتأثرة
    * **تقرير الطلبات**: تصفية حسب حالة الطلب أو نطاق القيمة
    * **تقرير المنتجات**: تصفية حسب الفئة أو حالة المزامنة

    استخدم أزرار الفلتر أسفل القائمة الرئيسية لتطبيق هذه المعايير.
  </Step>
</Steps>

<Tip>
  استخدم مقارنة الفترات الزمنية لفهم اتجاهات متجرك. انقر على **مقارنة مع فترة سابقة** بجانب فلتر التاريخ لعرض التقرير الحالي جنباً إلى جنب مع نفس الفترة من الأسبوع أو الشهر السابق.
</Tip>

***

## قراءة الرسوم البيانية ومؤشرات الأداء

<Steps>
  <Step title="الرسم البياني الخطي — اتجاهات الأداء">
    الرسم البياني الخطي الرئيسي في كل تقرير يعرض تطور قيمة معينة عبر الزمن. المحور الأفقي يمثل الوقت، والمحور العمودي يمثل القيمة (عدد العمليات، عدد الطلبات، إلخ). ضع مؤشر الفأرة على أي نقطة في الرسم لعرض القيمة الدقيقة في ذلك اليوم.
  </Step>

  <Step title="الرسم البياني الدائري — توزيع الحالات">
    الرسم الدائري يُظهر نسبة كل حالة من إجمالي البيانات. مثلاً في تقرير المزامنة: نسبة العمليات الناجحة (أخضر)، الفاشلة (أحمر)، والجزئية (أصفر). انقر على أي جزء من الدائرة لعرض تفاصيل تلك الفئة.
  </Step>

  <Step title="بطاقات مؤشرات الأداء (KPIs)">
    في أعلى كل تقرير، ستجد بطاقات تعرض المؤشرات الرئيسية للفترة المحددة:

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

  <Step title="جدول التفاصيل">
    أسفل الرسوم البيانية، يوجد جدول يعرض كل سجل بشكل منفرد مع جميع تفاصيله. انقر على أي صف لفتح نافذة التفاصيل الكاملة. يمكنك ترتيب الجدول حسب أي عمود بالنقر على رأس العمود.
  </Step>
</Steps>

***

## تصدير التقارير

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

  <Step title="اختيار صيغة التصدير">
    اختر الصيغة المناسبة لاستخدامك:

    * **PDF** — للطباعة أو المشاركة كوثيقة منسّقة مع الرسوم البيانية
    * **Excel (.xlsx)** — لمزيد من التحليل والمعالجة بالبيانات
    * **CSV** — للاستيراد في أنظمة المحاسبة أو برامج تحليل البيانات
  </Step>

  <Step title="تحديد محتوى التصدير">
    في نافذة خيارات التصدير، حدد ما تريد تضمينه:

    * ✅ الرسوم البيانية (PDF فقط)
    * ✅ بطاقات مؤشرات الأداء
    * ✅ جدول التفاصيل
    * ✅ معلومات المتجر والتاريخ على كل صفحة
  </Step>

  <Step title="تنزيل الملف">
    انقر على **تنزيل** وسيبدأ تحميل الملف فوراً إلى جهازك. للتقارير الكبيرة، قد يستغرق التجهيز بضع ثوانٍ.
  </Step>
</Steps>

<Warning>
  التقارير المُصدَّرة تحتوي على بيانات تجارية حساسة. احرص على مشاركتها فقط مع الأشخاص المخوّلين في متجرك، وتجنّب حفظها في أماكن غير مؤمنة.
</Warning>

***

## المؤشرات الرئيسية التي يجب مراقبتها

<Tabs>
  <Tab title="مؤشرات المزامنة">
    | المؤشر                   | الوصف                              | الهدف المقترح        |
    | ------------------------ | ---------------------------------- | -------------------- |
    | معدل نجاح المزامنة       | نسبة العمليات الناجحة              | أعلى من 95%          |
    | متوسط وقت المزامنة       | الزمن المتوسط لإتمام عملية واحدة   | أقل من 5 دقائق       |
    | تكرار الأخطاء            | عدد الأخطاء في الأسبوع             | أقل من 5 أخطاء       |
    | العناصر المتزامنة يومياً | إجمالي المنتجات والطلبات المتزامنة | يتزايد مع نمو المتجر |
  </Tab>

  <Tab title="مؤشرات الطلبات">
    | المؤشر                   | الوصف                           | الأهمية             |
    | ------------------------ | ------------------------------- | ------------------- |
    | إجمالي الطلبات المعالجة  | عدد الطلبات التي مرّت بالتطبيق  | قياس حجم النشاط     |
    | طلبات فاشلة التزامن      | طلبات لم تنجح مزامنتها          | تستوجب متابعة فورية |
    | متوسط وقت معالجة الطلب   | من الاستلام إلى اكتمال المزامنة | مؤشر كفاءة العملية  |
    | توزيع الطلبات حسب المنصة | نسبة الطلبات من سلة مقابل زد    | فهم مصادر المبيعات  |
  </Tab>

  <Tab title="مؤشرات الأخطاء">
    | نوع الخطأ          | المعنى                           | الإجراء المقترح                |
    | ------------------ | -------------------------------- | ------------------------------ |
    | خطأ اتصال          | انقطاع الاتصال بالمنصة           | إعادة الربط من إعدادات الاتصال |
    | خطأ بيانات         | بيانات غير مكتملة أو غير متوافقة | مراجعة إعدادات تعيين البيانات  |
    | خطأ صلاحيات        | انتهاء صلاحية الرمز التعريفي     | تجديد الصلاحيات من المنصة      |
    | خطأ معدل الاستخدام | تجاوز حد الطلبات المسموح به      | مراجعة خطة الاشتراك            |
  </Tab>
</Tabs>

***

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

بعد الاطلاع على تقارير متجرك بانتظام، ستتمكن من:

* اتخاذ قرارات مبنية على بيانات دقيقة لا على التخمين
* اكتشاف المشكلات المتكررة ومعالجتها قبل تأثيرها على العملاء
* متابعة نمو متجرك وأداء عمليات المزامنة عبر الزمن
* تقديم تقارير شفافة لفريقك أو شركائك التجاريين

***

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

**التقارير تُظهر بيانات فارغة أو "لا توجد بيانات"**
تأكد أن نطاق التاريخ المحدد يتضمن فترة كانت فيها عمليات مزامنة فعلية. إذا كنت قد أنشأت حساباً حديثاً، قد تحتاج إلى تشغيل أول عملية مزامنة قبل ظهور البيانات. راجع [الإعداد الأولي](/getting-started/first-setup) إذا لم تكن قد شغّلت مزامنة بعد.

**الرسوم البيانية لا تظهر في التقرير المُصدَّر بصيغة PDF**
تأكد من تفعيل خيار "تضمين الرسوم البيانية" في نافذة التصدير. إذا استمرت المشكلة، جرّب تصدير التقرير من متصفح مختلف. بعض متصفحات الهاتف المحمول لا تدعم تصدير الرسوم البيانية بشكل صحيح.

**أرقام التقرير لا تتطابق مع ما أراه في لوحة التحكم**
تأكد أن نطاق التاريخ المحدد في التقرير يطابق الفترة التي تراها في لوحة التحكم. لوحة التحكم غالباً تعرض بيانات "الوقت الفعلي" أو "آخر 24 ساعة"، بينما قد يكون التقرير محدداً لفترة مختلفة.

***

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

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

  <Accordion title="لكم مدة تُحفظ بيانات التقارير؟">
    تُحفظ بيانات التقارير لمدة 12 شهراً في الخطة الأساسية، و24 شهراً في الخطة المتقدمة. البيانات الأقدم من الفترة المحددة تُحذف تلقائياً. يُنصح بتصدير التقارير الهامة دورياً للاحتفاظ بسجل تاريخي أطول.
  </Accordion>

  <Accordion title="هل يمكنني إنشاء تقرير مخصص يجمع بيانات من أكثر من نوع؟">
    يمكنك استخدام ميزة **التقرير المخصص** المتاحة في الخطط المتقدمة. انتقل إلى **التقارير ← تقرير مخصص** واختر المؤشرات والأبعاد التي تريد دمجها. يمكنك دمج بيانات المزامنة والطلبات والمنتجات في تقرير واحد وحفظ قالبه لاستخدامه مرة أخرى.
  </Accordion>
</AccordionGroup>

***

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

<CardGroup cols={2}>
  <Card title="نظرة عامة على لوحة التحكم" icon="gauge" href="/using-app/dashboard-overview">
    تعرّف على لوحة التحكم وكيف تقرأ الإحصائيات الفورية وملخصات الأداء منها.
  </Card>

  <Card title="استكشاف أخطاء المزامنة" icon="wrench" href="/troubleshooting/sync-issues">
    إذا لاحظت في تقاريرك معدل أخطاء مرتفعاً، يرشدك هذا الدليل إلى حلول المشكلات الشائعة.
  </Card>
</CardGroup>

***

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

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