دليل استخدام لوحة التحكم

القسم الأول: طلبات المسوقين

صفحة طلبات المسوقين هي المكان الذي تتم فيه مراجعة طلبات الانضمام لبرنامج التسويق بالعمولة. يمكنك من خلالها قبول أو رفض الطلبات ومراجعة معلومات المتقدمين.

١. نظرة عامة على الصفحة

عند فتح صفحة "طلبات المسوقين" من القائمة الجانبية، ستجد:

• ١شريط الإحصائيات في الأعلى يعرض إجمالي الطلبات والحالات
• ٢شريط البحث والتصفية حسب الحالة
• ٣جدول الطلبات مع معلومات كل متقدم
• ٤قائمة الإجراءات (تصدير / استيراد)

٢. الإحصائيات

في أعلى الصفحة تظهر بطاقات إحصائية تعرض:

٣. البحث والتصفية

يمكنك البحث والتصفية باستخدام:

• ١حقل البحث: ابحث بالاسم أو رقم الجوال - يتم التصفية فوراً أثناء الكتابة
• ٢تصفية حسب الحالة: اختر من القائمة المنسدلة: الكل، قيد الانتظار، مقبول، مكتمل، أو مرفوض

٤. عرض تفاصيل الطلب

انقر على زر "عرض" في عمود الإجراءات لفتح نافذة تفاصيل الطلب. تعرض النافذة:

• ١معلومات المتقدم: الاسم، المنصة، جميع روابط التواصل الاجتماعي (تظهر كل رابط بشكل منفصل مع اسم المنصة مثل TikTok، Instagram، Snapchat)، رقم الجوال
• ٢المعلومات البنكية: اسم البنك، اسم المستفيد، رقم الآيبان (IBAN)، كود الخصم المقترح (اختياري - خاضع للتوفر)
• ٣عنوان الشحن: الدولة (دول الخليج العربي: السعودية، الإمارات، الكويت، البحرين، قطر، عُمان)، المنطقة/الإمارة/المحافظة، المدينة، الحي، الشارع، العنوان الوطني (إلزامي للسعودية فقط)
• ٤معلومات الطلب: تاريخ التقديم والحالة الحالية

٥. قبول ورفض الطلبات وإضافة رابط الأفلييت

مسار العمل الجديد للطلبات:

إرسال إشعار واتساب للطلبات المعلقة

يمكنك إرسال إشعار واتساب للفريق لمراجعة طلب مسوق معلق. الإشعار يتضمن بيانات المتقدم وروابط قبول/رفض مباشرة.

٦. العمليات الجماعية

لتنفيذ عمليات على عدة طلبات في وقت واحد:

• ١حدد الطلبات المراد تعديلها باستخدام مربعات الاختيار (checkbox) بجانب كل طلب
• ٢أو استخدم مربع "تحديد الكل" في رأس الجدول لتحديد جميع الطلبات
• ٣سيظهر شريط العمليات الجماعية يعرض عدد الطلبات المحددة
• ٤اختر "قبول المحدد" أو "رفض المحدد" أو "حذف المحدد" (للمشرف الأعلى فقط)

٧. التصدير والاستيراد

من قائمة "الإجراءات" في أعلى الجدول:

القسم الثاني: تتبع العمولات

صفحة تتبع العمولات هي المركز الرئيسي لإدارة المسوقين المقبولين، تتبع مبيعاتهم، عمولاتهم، ومدفوعاتهم. تتيح لك هذه الصفحة إدارة كاملة لجميع جوانب برنامج التسويق بالعمولة.

٨. نظرة عامة على الصفحة

تتكون صفحة تتبع العمولات من:

• ١بطاقات الإحصائيات (المسوقين النشطين، المبيعات، العمولات، المدفوعات، المستحقات)
• ٢عرض المسوقين: يمكن التبديل بين عرض البطاقات وعرض القائمة (الجدول) باستخدام أزرار التبديل. على الهاتف يظهر عرض البطاقات تلقائياً لسهولة القراءة
• ٣قائمة الإجراءات المتقدمة
• ٤خيار إظهار المسوقين المعطلين
• ٥زر واتساب مباشر لفتح محادثة مع المسوق بسرعة
• ٦تصفح الصفحات: يمكن اختيار عدد السجلات لكل صفحة (٢٥ أو ٥٠ أو ١٠٠) مع أزرار التنقل بين الصفحات

عرض البطاقات

في عرض البطاقات، يظهر كل مسوق في بطاقة منفصلة تحتوي على: الاسم، رقم الهاتف مع زر واتساب، نسبة العمولة، وشبكة مالية تعرض (المبيعات، العمولة، المدفوع، المستحق). انقر على أي بطاقة لعرض التفاصيل الكاملة.

٩. إحصائيات العمولات

١٠. إضافة مسوق جديد

لإضافة مسوق جديد يدوياً:

• ١انقر زر "+ إضافة مسوق" (الأخضر) في أعلى الجدول
• ٢أدخل اسم المسوق (مطلوب)
• ٣أدخل رقم الجوال
• ٤حدد نسبة العمولة (النسبة المئوية)
• ٥أدخل رابط أو كود الأفلييت (اختياري) - يمكن إدخال الكود فقط وسيتم بناء الرابط تلقائياً
• ٦انقر "إضافة" لحفظ المسوق

١١. تفاصيل المسوق

انقر على اسم أي مسوق أو زر "عرض" لفتح نافذة التفاصيل. تحتوي النافذة على ثلاث تبويبات:

في أعلى النافذة تظهر ملخص سريع: نسبة العمولة، إجمالي المبيعات، العمولات المكتسبة، المدفوع، والرصيد المتبقي.

١٢. إضافة المبيعات والمدفوعات

١٣. إعدادات المسوق

في تبويب "الإعدادات" داخل نافذة تفاصيل المسوق، يمكنك تعديل:

١٤. التصفية المتقدمة

للبحث المتقدم بين المسوقين، استخدم نظام التصفية المتعدد الشروط:

• ١افتح لوحة التصفية من: الإجراءات > "تصفية"
• ٢انقر "+ إضافة شرط" لإضافة شرط تصفية
• ٣اختر العمود (الاسم، الجوال، نسبة العمولة، المبيعات، العمولة، المدفوع، الرصيد)
• ٤اختر المعامل (يساوي، لا يساوي، أكبر من، أقل من، يحتوي على)
• ٥أدخل القيمة
• ٦يمكنك إضافة شروط متعددة (بعلاقة "و" بين الشروط)
• ٧انقر "تطبيق" لتصفية النتائج أو "مسح" لإزالة التصفية

١٥. استيراد مدفوعات PDF

يمكنك استيراد مدفوعات من كشوف حسابات بنكية بصيغة PDF:

• ١افتح نافذة الاستيراد من: الإجراءات > "استيراد مدفوعات PDF"
• ٢اسحب ملف PDF وأفلته في منطقة الإسقاط، أو انقر لاختيار الملف
• ٣سيقوم النظام بتحليل الملف واستخراج المعاملات تلقائياً
• ٤سيحاول النظام مطابقة كل معاملة مع مسوق بناءً على رقم الآيبان (IBAN)
• ٥للمعاملات التي لم تتم مطابقتها، اختر المسوق يدوياً من القائمة المنسدلة
• ٦حدد المعاملات المراد استيرادها باستخدام مربعات الاختيار
• ٧انقر "استيراد المحدد" لإضافة المدفوعات

١٦. تصدير الأرصدة المستحقة (PDF)

لتصدير تقرير بالأرصدة المستحقة لجميع المسوقين:

• ١من قائمة الإجراءات > "تصدير الأرصدة المستحقة (PDF)"
• ٢سيتم تحميل ملف PDF يحتوي على جدول بجميع المسوقين الذين لديهم رصيد مستحق
• ٣يشمل التقرير: اسم المسوق، رقم الآيبان، اسم البنك، اسم المستفيد، والمبلغ المستحق

تصدير واستيراد بيانات المسوقين (JSON)

يمكنك تصدير واستيراد جميع بيانات المسوقين (معلومات المسوق، المبيعات، المدفوعات، والروابط) كملف JSON للنسخ الاحتياطي أو نقل البيانات:

تصدير بيانات المسوقين

• ١من قائمة الإجراءات > "تصدير جميع المسوقين (JSON)"
• ٢ستظهر رسالة تأكيد، انقر "موافق" للمتابعة
• ٣سيتم تحميل ملف JSON يحتوي على جميع المسوقين مع بياناتهم الكاملة:
• - معلومات المسوق (الاسم، الهاتف، البريد، المنصة، البنك، العنوان)
• - سجلات المبيعات
• - سجلات المدفوعات
• - الروابط

استيراد بيانات المسوقين

• ١من قائمة الإجراءات > "استيراد المسوقين (JSON)"
• ٢اختر ملف JSON المصدّر مسبقاً
• ٣ستظهر رسالة تأكيد توضح عملية الاستيراد
• ٤بعد الاستيراد، ستظهر رسالة بالنتائج (عدد المسوقين الجدد، المحدّثين، المبيعات، المدفوعات، الروابط)

حذف المسوق نهائياً (المشرف الأعلى فقط)

يمكن للمشرف الأعلى حذف مسوق بالكامل مع جميع سجلاته:

• ١افتح تفاصيل المسوق بالنقر على "عرض" في الجدول
• ٢في تبويب "الإعدادات"، انقر زر "حذف المسوق" (الأحمر الداكن)
• ٣ستظهر رسالة تحذيرية أولى - انقر "موافق" للمتابعة
• ٤سيُطلب منك كتابة اسم المسوق بالضبط للتأكيد النهائي
• ٥عند التأكيد، سيتم حذف المسوق وجميع سجلاته (المبيعات، المدفوعات، الروابط، الطلبات)

١٧. تسوية الأرصدة

لتسوية جميع الأرصدة المستحقة دفعة واحدة (متاح للمشرف الأعلى فقط):

• ١من قائمة الإجراءات > "تسوية جميع الأرصدة"
• ٢ستظهر رسالة تأكيد تعرض عدد المسوقين والمبلغ الإجمالي
• ٣عند التأكيد، سيتم إنشاء دفعة لكل مسوق بقيمة رصيده المستحق
• ٤ستصبح جميع الأرصدة صفرية بعد التسوية

١٨. إدارة الأعمدة

يمكنك التحكم في الأعمدة المعروضة في جدول المسوقين:

• ١من قائمة الإجراءات > "إدارة الأعمدة"
• ٢فعّل أو عطّل الأعمدة حسب حاجتك
• ٣الأعمدة المتاحة: الجوال، نسبة العمولة، المبيعات، العمولة، المدفوع، الرصيد، عدد الطلبات، الآيبان، الملاحظات، الروابط، رابط الأفلييت
• ٤انقر "حفظ" لتطبيق التغييرات (يتم حفظ الإعدادات في المتصفح)

١٩. العمليات الجماعية

يمكنك تنفيذ عمليات على عدة مسوقين في وقت واحد:

• ١حدد المسوقين باستخدام مربعات الاختيار بجانب كل اسم
• ٢سيظهر شريط العمليات الجماعية مع الخيارات المتاحة

٢٠. إنشاء طلب عينات

يمكنك إنشاء طلب عينات منتجات للمسوقين بطريقتين:

الطريقة الأولى: من صفحة طلبات العينات

• ١افتح صفحة "طلبات العينات" من القائمة الجانبية
• ٢انقر زر "+ طلب جديد" في أعلى الصفحة
• ٣اختر المسوق من القائمة المنسدلة (يظهر فقط المسوقون المعتمدون)
• ٤اختر المنتجات من القائمة المنسدلة (انقر لفتح القائمة، ثم حدد المنتجات المطلوبة بوضع علامة ✓ عليها). المنتجات المتاحة: اسفنج التقشير، بكج الجسم، بكج glow، بكج glow (للبشرة الحساسة)، بكج التفتيح، بكج بينك برست، بكج اليدين، تغليف الهدايا، تونر الجسم، تونر الوجه، توزيعات بكج glow، توزيعات بكج بينك برست، توزيعات بكج فلو، شنطة العناية، شاور جل، صابونة التفتيح، كيس Cotton Skin، كريم الجسم، كريم التفتيح (صباحي)، كريم التفتيح (مسائي)، كريم الوجه، كريم وعلاج مسام الوجه، ماسك القطن، معطر الجسم والشعر، واقي الشمس المفتح، ربطه الشعر. يمكنك إزالة منتج محدد بالنقر على × بجانبه
• ٥أدخل ملاحظات للطلب (اختياري)
• ٦انقر "إنشاء الطلب" لإنشاء الطلب

الطريقة الثانية: من صفحة تتبع العمولات

• ١حدد المسوقين المراد إرسال عينات لهم
• ٢انقر "إنشاء طلب" من شريط العمليات الجماعية
• ٣ستفتح نافذة اختيار المنتجات مع قائمة بجميع المنتجات المتاحة
• ٤اختر المنتجات المراد إرسالها (تحديد فردي أو تحديد الكل)
• ٥أدخل ملاحظات للطلب (اختياري)
• ٦انقر "إنشاء طلبات" لإنشاء الطلبات

حذف طلب عينات

يمكنك حذف طلبات العينات بطريقتين:

• ١من قائمة الطلبات: انقر زر "حذف" (الأحمر) بجانب زر "عرض" في صف الطلب
• ٢من تفاصيل الطلب: افتح الطلب بالنقر على "عرض" ثم انقر زر "حذف" في أسفل النافذة
• ٣ستظهر رسالة تأكيد قبل الحذف - انقر "موافق" للتأكيد أو "إلغاء" للتراجع

٢١. تعويضات العملاء (الطلبات المتضررة)

صفحة تعويضات العملاء تتيح تتبع وإدارة مطالبات التعويض للطلبات المتضررة. يمكنك توثيق المشكلات وتصنيفها حسب السبب وتتبع قيمة التعويضات وتصدير التقارير الشهرية.

٢٢. لوحة الإحصائيات

في أعلى الصفحة تظهر إحصائيات سريعة:

• ١إجمالي المطالبات: عدد المطالبات هذا الشهر
• ٢إجمالي التعويضات: مجموع قيم التعويضات بالريال
• ٣حسب السبب: توزيع المطالبات حسب سبب المشكلة
• ٤أكثر منتج تضرراً: المنتج الأكثر تكراراً في المطالبات

٢٣. إنشاء مطالبة تعويض جديدة

لإنشاء مطالبة تعويض:

• ١انقر زر "مطالبة جديدة" في أعلى الصفحة
• ٢أدخل رقم الطلب (إلزامي) واختر المنتج من القائمة وأدخل الكمية
• ٣اكتب وصف الشكوى (إلزامي - تفاصيل المشكلة)
• ٤اختر سبب المشكلة من القائمة:
  - مصنع: مشكلة من المصنع
  - مستودع: مشكلة من المستودع
  - صندوق: مشكلة في التغليف
  - شركة الشحن: تلف أثناء الشحن
  - شركة اكسس: مشكلة من شركة اكسس
  - عميل: خطأ من العميل
  - غير محدد: سبب غير واضح
• ٥أدخل قيمة التعويض وأصناف التعويض (اختياري)
• ٦أضف ملاحظات السبب الجذري (اختياري)
• ٧ارفع صور المشكلة (حتى ١٠ صور)
• ٨انقر "حفظ" لإنشاء المطالبة

٢٤. حالات المطالبة

تمر المطالبة بعدة حالات:

• ١مسودة: المطالبة تم إنشاؤها ولم تُرسل للمراجعة
• ٢قيد المراجعة: المطالبة قيد الدراسة
• ٣معتمد: تمت الموافقة على التعويض
• ٤مرفوض: تم رفض المطالبة
• ٥تم التعويض: تم صرف التعويض للعميل
• ٦مغلق: تم إغلاق المطالبة

٢٥. التصفية والبحث

يمكنك تصفية المطالبات باستخدام:

• ١رقم الطلب: للبحث بكلمة مفتاحية
• ٢الحالة: لعرض مطالبات بحالة معينة
• ٣سبب المشكلة: لتصفية حسب نوع السبب
• ٤نطاق التاريخ: لعرض مطالبات فترة زمنية محددة
• ٥نطاق قيمة التعويض: لتصفية حسب المبلغ

٢٦. التقارير الشهرية

يمكنك تصدير تقارير شهرية بصيغة CSV:

• ١تقرير المصنع (جمانة): يحتوي على الصور والشكوى والمنتج - للمطالبات المصنفة كمشاكل مصنع
• ٢تقرير الصندوق (فدوى): يحتوي على الصور وقيمة التعويض والشكوى ورقم الطلب - للمطالبات المصنفة كمشاكل صندوق
• ٣تقرير المستودع: يحتوي على الصور وقيمة التعويض والشكوى ورقم الطلب - للمطالبات المصنفة كمشاكل مستودع

٢٧. تصدير تقرير PDF

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

• ١من قائمة "الإجراءات" اختر "تصدير تقرير PDF"
• ٢اختر سبب المشكلة (مثل: عميل، شركة الشحن، مصنع)
• ٣حدد تاريخ البداية والنهاية (يتم تعيين الشهر السابق تلقائياً)
• ٤انقر "تصدير PDF" وانتظر حتى يتم إنشاء التقرير

٢٨. إدارة المستخدمين

صفحة إدارة المستخدمين متاحة فقط للمشرفين الأعلى (Super Admin) وتتيح إضافة وتعديل وحذف مستخدمي لوحة التحكم.

٢٩. إضافة مستخدم جديد

لإضافة مستخدم جديد:

• ١انقر زر "إضافة مستخدم" في أعلى الصفحة
• ٢أدخل الاسم والبريد الإلكتروني ورقم الهاتف (مطلوب) واختر المدير من القائمة المنسدلة (يُستخدم المدير لإرسال تنبيهات التصعيد عند تأخر المهام)
• ٣حدد مستوى الصلاحية لكل صفحة من القائمة المنسدلة:
  - بدون وصول: المستخدم لا يستطيع الوصول للصفحة
  - قراءة فقط: المستخدم يستطيع عرض البيانات فقط بدون تعديل (يظهر بعلامة زرقاء)
  - قراءة وكتابة: المستخدم يستطيع عرض وتعديل البيانات (يظهر بعلامة خضراء)
  يمكنك استخدام "تعيين الكل" لتعيين نفس المستوى لجميع الصفحات دفعة واحدة
  الصفحات المتاحة: المحتوى، الإشعارات، العمولات، تعويضات العملاء، التتبع، التحدي، التقويم، طلبات العينات، الملفات، شجرة الروابط، دليل الاستخدام، أهداف المبيعات، المجدول
• ٤فعّل خيار "صلاحية قبول/رفض الطلبات" إذا كنت تريد أن يتمكن المستخدم من قبول أو رفض طلبات المسوقين. بدون هذه الصلاحية، سيتمكن المستخدم من عرض الطلبات فقط دون القدرة على قبولها أو رفضها. المشرفون الأعلى (Super Admin) يملكون هذه الصلاحية تلقائياً.
• ٥انقر "حفظ" - سيتم إنشاء كلمة مرور تلقائية مكونة من ١٢ خانة
• ٦ستظهر نافذة تحتوي على البريد الإلكتروني وكلمة المرور المُنشأة
• ٧انسخ البيانات فوراً - لا يمكن عرض كلمة المرور مرة أخرى

٣٠. تعديل وحذف المستخدمين

يمكنك التحكم في المستخدمين عبر الأزرار في جدول المستخدمين:

• ١تعديل: تعديل الاسم والبريد والهاتف والمدير ومستوى صلاحيات الصفحات (بدون وصول/قراءة فقط/قراءة وكتابة) وصلاحية قبول/رفض الطلبات وتغيير كلمة المرور
• ٢تفعيل/تعطيل: تفعيل أو تعطيل حساب المستخدم دون حذفه
• ٣حذف: حذف المستخدم نهائياً (يتطلب تأكيد)

٣١. سجل التغييرات (Audit Log)

صفحة سجل التغييرات متاحة فقط للمشرفين الأعلى (Super Admin) وتتيح تتبع جميع التعديلات التي تمت على البيانات في النظام. يمكنك من خلالها معرفة من قام بتغيير أي معلومة ومتى وما هي التفاصيل القديمة والجديدة.

ما الذي يتم تتبعه؟

يتم تسجيل جميع العمليات التالية تلقائياً:

• ١المسوقين: إنشاء، تعديل (IBAN، رقم الهاتف، البنك، العمولة، العنوان)، تفعيل/تعطيل
• ٢طلبات المسوقين: قبول أو رفض الطلبات (فردي وجماعي)
• ٣المبيعات: إضافة وحذف سجلات المبيعات
• ٤المدفوعات: إضافة وحذف واستيراد المدفوعات
• ٥طلبات العينات: إنشاء وتحديث حالة الطلبات
• ٦المستخدمين: إنشاء وتعديل وحذف وتفعيل/تعطيل حسابات المستخدمين
• ٧الأعمدة المخصصة: إنشاء وتعديل وحذف الأعمدة
• ٨تطبيع الهواتف: عمليات تصحيح أرقام الهواتف الجماعية

استخدام صفحة سجل التغييرات

عند فتح الصفحة ستجد:

• ١بطاقات الإحصائيات: تغييرات اليوم، تغييرات الأسبوع، المستخدمين النشطين، إجمالي السجلات
• ٢شريط التصفية: البحث بالنص، تاريخ من/إلى، تصفية حسب المستخدم، نوع العملية، ونوع الكيان
• ٣جدول السجلات: يعرض التاريخ، المستخدم، العملية، نوع الكيان، اسم الكيان، ملخص التغييرات، وزر التفاصيل

عرض تفاصيل التغيير

عند النقر على زر "تفاصيل" لأي سجل:

• ١تظهر نافذة تحتوي على جميع المعلومات عن التغيير
• ٢لعمليات التعديل: يظهر جدول يوضح الحقل والقيمة القديمة والقيمة الجديدة لكل تغيير
• ٣يظهر اسم المستخدم الذي قام بالتغيير وعنوان IP والتاريخ والوقت

تصدير السجلات

يمكنك تصدير السجلات المفلترة إلى ملف CSV عبر زر "تصدير CSV" في أعلى الصفحة. الملف يتضمن جميع البيانات المعروضة حسب الفلاتر المطبقة.

٣٢. شجرة الروابط (Linktree)

ميزة شجرة الروابط تتيح لك إنشاء صفحة عامة (link-in-bio) يمكن للزوار الوصول إليها عبر رابط /links. تتحكم فيها كمسؤول من صفحة /admin/links وتتضمن خيارات متقدمة للتخصيص والتحليلات.

نظرة عامة على شجرة الروابط

ميزة شجرة الروابط توفر:

• ١صفحة عامة: يمكن للزوار الوصول إليها عبر الرابط /links دون الحاجة لتسجيل الدخول
• ٢عرض احترافي: تعرض الصفحة صورة ملفك الشخصي، الاسم، السيرة الذاتية، وأزرار الروابط
• ٣أيقونات وسائط التواصل: عرض وسائل التواصل الاجتماعي بأيقونات جذابة
• ٤تتبع تلقائي: تسجيل عدد النقرات على كل رابط تلقائياً لقياس الأداء
• ٥تخصيص كامل: التحكم في الألوان والخطوط والتصميم من لوحة التحكم

الصفحة العامة (/links)

الصفحة العامة هي واجهة الزائر. تحتوي على:

لوحة التحكم (/admin/links)

لوحة إدارة شجرة الروابط تتضمن 5 تبويبات رئيسية لإدارة جميع جوانب الصفحة:

كيفية الاستخدام

خطوات سريعة لإعداد واستخدام شجرة الروابط:

٣٣. أهداف المبيعات والحوافز

نظام لتحفيز المسوقين عبر تحديد أهداف مبيعات بمكافآت مالية لمن يحققها خلال فترة زمنية محددة.

كيفية عمل النظام

يعمل النظام على تسجيل مبيعات المسوقين تلقائياً في بداية ونهاية فترة الهدف لحساب الفرق كمبيعات الفترة:

• ١إنشاء هدف جديد: حدد اسم الهدف والمبلغ المستهدف ومبلغ المكافأة وفترة الهدف (تاريخ البداية والنهاية)
• ٢تسجيل البيانات تلقائياً: عند حلول تاريخ البداية أو النهاية، يقوم النظام أولاً بجلب تقارير المسوقين من روابطهم المحفوظة (صفحات الأفلييت) ثم يسجل إجمالي المبيعات لجميع المسوقين النشطين (يتم التحقق كل ساعة)
• ٣عند تسجيل البيانات يظهر شارة "تم تسجيل البداية" أو "تم تسجيل النهاية" في صفحة التفاصيل
• ٤يمكنك إعادة التسجيل يدوياً في أي وقت بالضغط على "إعادة تسجيل البداية" أو "إعادة تسجيل النهاية" - يتم الجلب في الخلفية على السيرفر ويمكنك إغلاق الصفحة والعودة لاحقاً لمتابعة التقدم. شريط التقدم يعرض حالة كل مسوّق (تم استيرادها / فشلت / تم تخطيها) مع زر إيقاف أحمر لإيقاف العملية
• ٥النظام يحسب الفرق تلقائياً (مبيعات الفترة = مبيعات النهاية - مبيعات البداية)
• ٦إذا حقق المسوّق الهدف، يظهر زر "منح المكافأة" لتسجيل المكافأة كدفعة في سجله

صفحة أهداف المبيعات (/admin/sales-targets)

• ١عرض جميع الأهداف مع حالتها (نشط، مكتمل، ملغي)
• ٢إنشاء وتعديل وحذف الأهداف
• ٣عرض تفاصيل كل هدف مع جدول تقدم المسوقين
• ٤جدول التقدم يعرض: اسم المسوّق، المبيعات عند البداية والنهاية، مبيعات الفترة، عمولة الفترة، وحالة تحقيق الهدف

٣٤. لوحة المهام المجدولة

صفحة خاصة بالمشرف الأعلى لمراقبة المهام التلقائية المجدولة في النظام وسجل تنفيذها.

صفحة المهام المجدولة (/admin/scheduler)

• ١حالة المجدول: يعرض ما إذا كان المجدول يعمل أو متوقف، وقت البدء، آخر فحص، وعدد الفحوصات الإجمالية
• ٢التحكم بالمجدول: يمكنك تشغيل أو إيقاف المجدول بزر "تشغيل/إيقاف"، وتعديل الفاصل الزمني بين الفحوصات (بالدقائق من ١ إلى ١٤٤٠)
• ٣المهام النشطة: كل هدف مبيعات نشط يظهر كبطاقة تعرض اسم الهدف وتواريخه وحالة تسجيل البيانات، مع زر "إيقاف مؤقت/استئناف" لإيقاف أو تشغيل كل مهمة على حدة
• ٤سجل التنفيذ لكل مهمة: بالضغط على "سجل التنفيذ" داخل كل مهمة يظهر سجل العمليات الخاص بهذه المهمة فقط (قابل للطي والإظهار)
• ٥السجل العام: في أسفل الصفحة يوجد "سجل المجدول العام" يعرض جميع العمليات (قابل للطي والإظهار)
• ٦يتم التحديث تلقائياً كل ٦٠ ثانية ويمكن التحديث يدوياً بزر التحديث

القسم الرابع: المالية

٣٥. حاسبة الإيرادات (/admin/revenue)

أداة لحساب الإيرادات المتوقعة بناءً على المنتجات المتوفرة وأسعارها وكمياتها. البيانات تُحفظ محلياً في المتصفح.

مميزات الصفحة

• ١بطاقات الإحصائيات: تعرض إجمالي المنتجات، مواد التغليف، الإجمالي الكلي شامل الضريبة، والإجمالي الكلي بدون ضريبة
• ٢جدول المنتجات: يعرض رمز المنتج (SKU)، الاسم، الباركود، الكمية الأصلية، الكمية المتاحة (بعد خصم البكجات)، السعر، التصنيف، والإيرادات
• ٣التصنيف: يمكن تصنيف كل صنف كـ "منتج" أو "تغليف" أو "بكج". البكج يحتوي على منتجات فردية - عند تحديد الكمية تنقص الكمية المتاحة من المنتجات المكونة تلقائياً
• ٤البحث: شريط بحث للبحث برمز المنتج أو الاسم
• ٥إضافة منتج: زر لإضافة صف جديد فارغ في الجدول
• ٦حفظ التعديلات: يحفظ جميع التغييرات في المتصفح (localStorage)
• ٧تصدير CSV: يُنشئ ملف CSV بجميع البيانات للتحميل
• ٨إعادة تعيين: يعيد جميع البيانات إلى القيم الأصلية (يحذف التعديلات المحفوظة)
• ٩استيراد Excel: يتيح رفع ملف Excel (.xlsx أو .xls) لتحديث كميات المنتجات تلقائياً. يتم مطابقة المنتجات برقم المنتج (SKU) في العمود الأول، وتحديث الكمية من العمود الخامس (الكمية). بعد الاستيراد تظهر نافذة توضح عدد المنتجات المحدّثة والرموز غير الموجودة مع تفاصيل التغييرات (الكمية القديمة والجديدة). لا تنسَ الضغط على "حفظ" بعد الاستيراد لحفظ التعديلات.

إنشاء البكجات

يمكنك تحويل أي صنف إلى بكج عن طريق تغيير تصنيفه إلى "بكج" في القائمة المنسدلة. عند ذلك يظهر زر "اختيار المنتجات" لتحديد المنتجات المكونة للبكج.

• ١غيّر تصنيف الصنف إلى "بكج" من القائمة المنسدلة
• ٢اضغط "اختيار المنتجات" واختر المنتجات المكونة مع تحديد الكمية من كل منتج لكل وحدة بكج
• ٣حدد كمية البكج - ستنقص الكمية المتاحة من كل منتج مكوّن تلقائياً
• ٤إذا ظهرت الكمية المتاحة بالأحمر، يعني أن المخزون غير كافٍ لتغطية البكجات

محرك سير عمل الحملات

نظام متكامل لإدارة حملات التسويق من الفكرة حتى النشر. يربط بين تقويم التسويق وسير العمل الآلي مع تتبع الأداء والتصعيدات.

إنشاء حملة جديدة

• اضغط زر "حملة جديدة" في أعلى الصفحة
• يمكنك اختيار قالب جاهز (رمضان، عيد الحب، إطلاق منتج، تخفيضات) لتعبئة الحقول تلقائياً
• أدخل عنوان الحملة، نوعها، التواريخ، المنصات المستهدفة، الهدف، والميزانية
• عند الإنشاء، يتم إنشاء 3 مراحل تلقائياً: الكتابة → التصميم → النشر
• كل مرحلة تحصل على مؤقت OLA (وقت محدد للإنجاز) حسب نوع الحملة

مراحل سير العمل

• الكتابة: كتابة الكابشن والتفاصيل. تبدأ فوراً عند إنشاء الحملة. يمكن إرفاق ملفات أمثلة
• التصميم: رفع ملفات التصميم (صور، فيديو، PDF). تبدأ تلقائياً بعد تسليم الكتابة
• النشر: تعرض المحتوى المعتمد (الكابشن والتصميم) للمراجعة النهائية. زر "نشر" ينهي سير العمل وينشر الحملة. تبدأ بعد اعتماد الكتابة والتصميم معاً

الأدوار والصلاحيات

• كاتب (Writer): يمكنه تسليم مرحلة الكتابة فقط. عند إسناد مرحلة الكتابة يظهر الكتّاب أولاً في القائمة
• مصمم (Designer): يمكنه تسليم مرحلة التصميم فقط. عند إسناد مرحلة التصميم يظهر المصممون أولاً في القائمة
• المشرف الأعلى (Super Admin): يمكنه تسليم أي مرحلة ومراجعة واعتماد أو رفض المحتوى والنشر
• المراجعة والاعتماد: المشرف الأعلى فقط يمكنه اعتماد أو رفض المراحل. باقي الأدوار ترى رسالة "بانتظار مراجعة المشرف"

نظام المراجعة

• عند تسليم الكتابة والتصميم معاً، تنتقل الحملة تلقائياً لحالة "تحت المراجعة"
• فقط المشرف الأعلى يمكنه اعتماد أو رفض كل مرحلة على حدة مع ملاحظات
• عند اعتماد الكتابة والتصميم معاً، تنتقل الحملة لمرحلة النشر
• عند الرفض، تعود المرحلة للشخص المسند إليه مع الملاحظات

إدارة المراحل

• إسناد المهمة: اختر عضو الفريق المسؤول عن كل مرحلة. القائمة تُصفى حسب الدور المناسب (كاتب لمرحلة الكتابة، مصمم لمرحلة التصميم). فقط الشخص المسند إليه أو صاحب الدور المناسب أو المشرف الأعلى يمكنه التسليم
• تسليم الكتابة: أدخل الكابشن والتفاصيل، مع إمكانية إرفاق ملفات
• تسليم التصميم: ارفع ملفات الوسائط (صور، فيديو، PDF) بحد أقصى 50 ميجا لكل ملف
• سجل النسخ: كل تعديل يُحفظ كنسخة مرقمة مع الملاحظات والملفات

نظام OLA والتصعيدات

• OLA (اتفاقية مستوى التشغيل): وقت محدد لإنجاز كل مرحلة
• الأوقات الافتراضية تختلف حسب نوع الحملة (سريع/متوسط)
• على المسار (أخضر): التقدم طبيعي
• معرض للخطر (أصفر): مضى 60% من الوقت بدون تسليم
• متأخر (أحمر): انتهى الوقت المحدد
• التصعيدات تُنشأ تلقائياً بثلاث مستويات: تذكير → إشعار المشرف → تنبيه حرج

طرق العرض

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

ملخص المهام في الصفحة الرئيسية

• الصفحة الرئيسية تعرض ملخص المهام الخاص بكل مستخدم حسب دوره
• للكاتب/المصمم: يظهر عدد المهام المسندة إليه التي تحتاج تسليم، مع قائمة بالمهام وروابط مباشرة لصفحة الحملات
• للمشرف الأعلى: يظهر عدد المهام بانتظار المراجعة، الحملات النشطة، الحملات المتأخرة، مع قائمة بالمهام المعلقة
• كل مهمة تعرض اسم الحملة، نوع المرحلة، وحالة الوقت (على المسار/معرض للخطر/متأخر)
• الضغط على أي مهمة يوجهك مباشرة لصفحة الحملات

صفحة المهام

صفحة المهام هي لوحة مركزية تعرض جميع المهام المسندة لفريق العمل حسب دور كل مستخدم.

أنواع المهام

استخدام صفحة المهام

• ١افتح صفحة "المهام" من القائمة الجانبية
• ٢في الأعلى تظهر إحصائيات: إجمالي المهام، المعلقة، المكتملة، المتأخرة
• ٣استخدم التبويبات (الكل/معلقة/مكتملة) والفلاتر لتصفية المهام
• ٤كل مهمة تعرض: العنوان، النوع، الحالة، الأولوية، المسند إليه، التاريخ
• ٥انقر "تذكير" لإرسال رسالة واتساب تذكيرية للشخص المسند إليه المهمة بإكمالها (إذا كان واتساب متصلاً، وإلا يتم إرسال إشعار داخلي فقط) / Click "Remind" to send a WhatsApp reminder to the assigned person to complete the task (falls back to in-app notification if WhatsApp is not connected)
• ٦انقر "إكمال" لتحديد المهمة كمنتهية، أو "إعادة فتح" لإعادتها للعمل
• ٧انقر "الانتقال" للذهاب مباشرة للصفحة المرتبطة بالمهمة

إنشاء المهام التلقائي

• عند قبول طلب مسوق (من صفحة الطلبات أو عبر واتساب)، يتم إنشاء مهمة "إضافة رابط أفلييت" تلقائياً
• عند إضافة رابط الأفلييت وإكمال إعداد المسوق، يتم إكمال المهمة تلقائياً
• مهام الحملات تظهر تلقائياً من مراحل الحملات النشطة

إرسال واتساب جماعي للمسوقين / Bulk WhatsApp to Sellers

من صفحة /admin/commission/tracking يمكنك تحديد عدة مسوقين وإرسال رسالة واتساب واحدة لهم جميعاً مع شريط تقدم مباشر وتأخير عشوائي بين كل رسالة لحماية رقم واتساب من الحظر.

From /admin/commission/tracking you can select multiple sellers and send them one WhatsApp message at once, with a live progress bar and a randomized delay between messages to protect the WhatsApp number from being flagged.

القسم السادس: التكاملات (Integrations)

نظام التكاملات يتيح ربط لوحة التحكم بخدمات خارجية مثل أنظمة إدارة المستودعات (WMS)، الشحن، والدفع. يدعم النظام حالياً التكامل مع Omniful لإدارة وتنفيذ طلبات العينات.

The Integrations system allows connecting the dashboard with external services such as Warehouse Management Systems (WMS), shipping, and payment. The system currently supports integration with Omniful for managing and fulfilling sample orders.

٣٧. إدارة التكاملات

صفحة التكاملات (/admin/integrations) هي المكان المركزي لإدارة جميع التكاملات مع الخدمات الخارجية. متاحة فقط للمشرف الأعلى (Super Admin).

The Integrations page (/admin/integrations) is the central place to manage all external service integrations. Available only to Super Admin.

٣٧-ب. إعدادات إشعارات واتساب / WhatsApp Notification Settings

في تبويب "الإعدادات" ضمن قسم واتساب، يمكنك التحكم بالإشعارات التلقائية التي ترسل عبر واتساب عند حدوث أحداث معينة.

In the "Settings" tab within WhatsApp section, you can control automatic notifications sent via WhatsApp when certain events occur.

٣٧-ج. قوالب رسائل واتساب / WhatsApp Message Templates

قوالب الرسائل تتيح لك حفظ رسائل جاهزة يمكن استخدامها بسرعة عند الإرسال. مفيدة للرسائل المتكررة مثل تأكيدات الدفع، ترحيب المسوقين الجدد، وتذكيرات المواعيد.

Message Templates let you save pre-written messages that can be quickly used when sending. Useful for recurring messages like payment confirmations, welcome messages for new marketers, and deadline reminders.

٣٧-د. قائمة انتظار الرسائل المعلقة / WhatsApp Pending Message Queue

إذا انقطع اتصال واتساب أثناء حدوث إجراء يستدعي إرسال إشعار (مثل إسناد مهمة، قبول طلب مسوق، أو تحديث الحملات)، فلن تُفقد الرسالة. بل تُحفظ تلقائياً في قائمة انتظار خاصة، ويتم إرسالها فور إعادة اتصال واتساب — أو يدوياً من تبويب "في الانتظار".

If WhatsApp disconnects while an event triggers a notification (like task assignment, marketer request approval, or campaign updates), the message is not lost. It is automatically saved to a queue and sent the moment WhatsApp reconnects — or manually from the "Pending" tab.

٣٨. إعداد Omniful

Omniful هو نظام إدارة مستودعات (WMS) يتيح تنفيذ طلبات العينات وتتبع شحنها. لإعداد التكامل:

Omniful is a Warehouse Management System (WMS) that enables fulfilling sample orders and tracking shipments. To set up the integration:

٣٩. إرسال الطلبات إلى Omniful

بعد إعداد وتفعيل تكامل Omniful، يمكنك إرسال طلبات العينات لتنفيذها عبر المستودع.

After setting up and enabling the Omniful integration, you can send sample orders for warehouse fulfillment.

٤٠. التحقق من حالة الطلب في Omniful

يمكنك التحقق من الحالة الحقيقية لأي طلب مُرسل إلى Omniful في أي وقت.

You can check the real-time status of any order sent to Omniful at any time.

٤١. إلغاء الطلبات في Omniful

يمكنك إلغاء طلب مُرسل إلى Omniful إذا لم يصل لمرحلة التغليف (packed) بعد.

You can cancel an order sent to Omniful as long as it has not reached the "packed" stage yet.

مكتبة الوسائط (Media Library)

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

The Media Library is a centralized system for managing all visual files (photos and videos) used in marketing. It supports receiving from multiple sources: internal team uploads, external uploads from influencers and partners, and automatically approved campaign designs.

صفحة الرفع الخارجي / External Upload Page

صفحة عامة يمكن مشاركة رابطها مع المؤثرين والشركاء لرفع الوسائط مباشرة إلى فريق التسويق. متاحة عبر النطاق affiliate.cottonskin.sa أو المسار /media-upload.

A public page whose link can be shared with influencers and partners to upload media directly to the marketing team. Available via affiliate.cottonskin.sa domain or /media-upload path.

لوحة مكتبة الوسائط / Media Library Dashboard

صفحة إدارية شاملة (/admin/media-library) لعرض وتنظيم جميع الوسائط. متاحة من قسم "التسويق" في القائمة الجانبية.

A comprehensive admin page (/admin/media-library) to view and organize all media. Accessible from the "Marketing" section in the sidebar.

دليل الهوية البصرية (Brand Guidelines)

صفحة مركزية لإدارة إرشادات الهوية البصرية للعلامة التجارية. تتيح تنظيم المحتوى حسب التصنيفات مثل الشعارات، الألوان، الخطوط، الصور، القوالب، النبرة والأسلوب، والتغليف.

A centralized page for managing brand identity guidelines. Organize content by categories like logos, colors, typography, imagery, templates, tone & voice, and packaging.

الوصول إلى الصفحة / Accessing the Page

متاحة من قسم "التسويق" في القائمة الجانبية تحت اسم "دليل الهوية البصرية" (/admin/brand-guidelines).

Available from the "Marketing" section in the sidebar under "Brand Guidelines".

إضافة إرشاد جديد / Adding a New Guideline

• ١انقر على زر "إضافة إرشاد" في أعلى الصفحة / Click "Add Guideline" at the top of the page
• ٢اختر التصنيف المناسب (شعارات، ألوان، خطوط...) / Select the appropriate category
• ٣أدخل العنوان بالعربية و/أو الإنجليزية / Enter the title in Arabic and/or English
• ٤أضف الوصف والمحتوى التفصيلي (اختياري) / Add description and detailed content (optional)
• ٥ارفق ملفاً (PDF، PNG، JPG، SVG) بحد أقصى 5 ميغابايت (اختياري) / Attach a file up to 5MB (optional)
• ٦حدد ترتيب العرض واحفظ / Set the sort order and save

التصنيفات المتاحة / Available Categories

القسم الثامن: مركز الإشعارات / Activity Notifications

مركز الإشعارات يوفر تنبيهات فورية للأنشطة المهمة في لوحة التحكم. يظهر جرس الإشعارات في رأس كل صفحة ويتم تحديثه تلقائياً.

The Activity Notifications Center provides real-time alerts for important admin panel activities. The bell icon appears in every page header and updates automatically.

٤٥. جرس الإشعارات / Notification Bell

يظهر جرس الإشعارات في الزاوية العلوية من كل صفحة في لوحة التحكم:

• ١انقر على الجرس لفتح قائمة الإشعارات المنسدلة / Click the bell to open the notification dropdown
• ٢الشارة الحمراء تعرض عدد الإشعارات غير المقروءة / Red badge shows unread count
• ٣يتم تحديث العدد تلقائياً كل ٦٠ ثانية / Count updates automatically every 60 seconds
• ٤انقر على إشعار للانتقال للصفحة المعنية / Click a notification to navigate to the relevant page

٤٦. أنواع الإشعارات / Notification Types

٤٧. إدارة الإشعارات / Managing Notifications

القسم التاسع: إدارة عملاء B2B / B2B Client Management

نظام إدارة عملاء الجملة (B2B) يتيح لك إدارة العلاقات التجارية مع عملاء الشركات والموزعين. يشمل النظام إرساليات البضائع، المصالحات، الفواتير، المدفوعات، الملفات، وتقارير شاملة.