إنشاء إضافة خاصة بووردبريس plugin for wordpress

المواصفات الفنية لإضافة ووردبريس: نظام وكلاء المبيعات (محدث)

---

فكرة المشروع

إضافة مخصصة لووردبريس تربط بين WooCommerce وDokan، وتُضيف طبقة جديدة من المستخدمين تسمى "وكلاء المبيعات". الهدف منها هو تمكين وكلاء من تسويق منتجات البائعين وتقديم الطلبات بالنيابة عن عملائهم، مع نظام عمولة مرن وإدارة للمدفوعات بين الوكلاء والبائعين.

الأدوار (Roles)

* الأدمن (Administrator)

* البائع (Vendor) – عبر Dokan

* وكيل المبيعات (Sales Agent) – جديد

* العميل (Customer) – يضاف من قبل الوكيل

الوظائف الرئيسية

وكيل المبيعات

* يمكنه عرض جميع منتجات البائعين في المتجر.

* يمتلك لوحة تحكم خاصة به تحتوي على:

* عملائي

* طلباتي

* أرباحي (تفصيلية لكل منتج في الطلبات المكتملة)

* المدفوعات

* حسابي

* يمكنه إضافة عملاء (يُضافون كـ "مشترك/مستهلك").

* في تبويب "عملاي" تظهر قائمة بجميع العملاء الذين أضافهم، مع زر "التسوق نيابة عنه" بجانب كل عميل.

* عند الضغط على "التسوق نيابة عنه":

* يتم التبديل فورًا إلى حساب العميل دون الحاجة لإعادة تسجيل دخول أو تأكيد إضافي.

* صلاحيات الوكيل أثناء التبديل مقتصرة على تصفح المنتجات وتقديم الطلبات نيابة عن العميل فقط.

* يظهر زر "العودة إلى حسابي كوكيل" لإرجاع الجلسة الأصلية فورًا.

* عند تقديم طلب باسم العميل:

* يتم تخطي الدفع (يُعامل كـ "الدفع عند الاستلام").

* يُسجل الطلب باسم العميل في WooCommerce.

* تُحتسب العمولة للوكيل بعد اكتمال الطلب فقط.

* في صفحة "أرباحي"

* تظهر المنتجات في الطلبات المكتملة مع عرض:

* اسم المنتج

* اسم البائع

* رقم الطلب

* مبلغ العمولة لكل منتج

* حالة العمولة (بانتظار الدفع من البائع، شكوى مقدمة، تم دفع العمولة)

* يمكن للوكيل تأكيد استلام العمولة لكل منتج على حدة عبر زر "تم استلام العمولة".

* يمكن تقديم شكوى ضد البائع لمنتج معين عبر زر "تقديم شكوى" (تُسجل الشكوى دون نص إضافي).

* يُمنع الوكيل من تأكيد استلام العمولة للمنتج المشكو منه حتى يتم مراجعة الشكوى.

* في صفحة "المدفوعات":

* تظهر المنتجات التي تم تأكيد استلام عمولتها من قبل الوكيل.

البائع

* يستخدم لوحة تحكم Dokan مع الإضافة الخاصة، ويظهر له تبويبات جديدة:

* أرباح وكلائي

* قائمة المنتجات التي يجب دفع عمولتها للوكيل.

* إمكانية تحديد عدة منتجات ودفع عمولتها جماعياً عبر زر "تم دفع العمولة" بدون تأكيد إضافي.

* المدفوعات

* قائمة المنتجات التي تم تأكيد استلام العمولة من الوكلاء.

* شكاوى الوكلاء

* قائمة الشكاوى المقدمة من الوكلاء ضده مع تفاصيل المنتج، رقم الطلب، اسم الوكيل، وتاريخ الشكوى.

* إمكانية تأكيد حل الشكوى عبر زر "تم حل الشكوى".

* عند إضافة منتج، يمكنه تحديد:

* قيمة العمولة (نسبة مئوية أو مبلغ ثابت) للوكيل.

* بعد الدفع، يتم إشعار الوكيل لإتمام تأكيد استلام العمولة.

الأدمن

* لا يتدخل في عملية الدفع، لكن لديه تبويبات خاصة لإدارة ومراقبة النظام:

* أرباح الوكلاء

* جدول يعرض المنتجات مع:

* رقم المنتج

* اسم المنتج

* رقم الطلب

* اسم الوكيل

* اسم البائع

* مبلغ العمولة

* نوع العمولة (نسبة/مبلغ ثابت)

* حالة العمولة (بانتظار الدفع من البائع، تم دفع العمولة، شكوى مقدمة)

* تاريخ الطلب

* إجراءات (عرض تفاصيل، إرسال تذكير، مراجعة شكوى)

* لا يعرض المنتجات التي تم تأكيد استلام العمولة من الوكيل (تنتقل لتبويب المدفوعات).

* مدفوعات العملاء

* المنتجات التي تم تأكيد استلام العمولة فيها من الوكلاء.

* شكاوى الوكلاء

* جدول يشمل جميع الشكاوى مع:

* اسم المنتج

* رقم الطلب

* اسم البائع

* اسم الوكيل

* الحالة (جديدة، تم حلها، بانتظار مراجعة)

* إمكانية الفلترة والبحث حسب البائع أو الوكيل أو التاريخ.

* إعدادات الإضافة

* تحديد صفحة لوحة تحكم الوكلاء.

* تحديد صفحة نموذج تسجيل وكلاء المبيعات.

* إعداد طرق الدفع المتاحة لاستلام الأرباح.

️ الإعدادات (Settings) – في لوحة تحكم الأدمن

* تعيين صفحات:

* صفحة لوحة تحكم الوكلاء.

* صفحة نموذج تسجيل وكيل مبيعات.

* إعداد طرق الدفع التي يمكن للوكيل إدخالها لاستلام الأرباح.

قيود المشروع

* الوكيل لا يستطيع إضافة منتجات.

* لا يمكن للزوار أو العملاء رؤية تفاصيل العمولة.

* لا يوجد نظام دفع أو تحويل داخلي، الدفع يتم يدويًا فقط.

المكونات البرمجية المطلوبة

* تخصيص لوحة Dokan للبائع (إضافة حقل عمولة – إدارة المدفوعات).

* نموذج تسجيل وكيل مع تعيين دور تلقائي.

* لوحة تحكم وكيل تحتوي على صفحات:

* عملائي، طلباتي، أرباحي، المدفوعات، حسابي.

* ربط طلبات العملاء المضافين بالوكيل الذي أضافهم.

* عرض تقارير إدارية للأدمن مع إمكانية الفلترة.

* نظام التبديل بين حساب الوكيل وحساب العميل:

* زر "التسوق نيابة عنه" ينقل الوكيل فورًا إلى حساب العميل بدون خطوات إضافية.

* صلاحيات الوكيل أثناء التبديل مقتصرة على تصفح المنتجات وتقديم الطلب نيابة عن العميل فقط.

* زر "العودة إلى حسابي كوكيل" لإرجاع الجلسة الأصلية فورًا.

* ميزة دفع جماعي للبائع للعمولات مع تحديث فوري بدون تأكيد.

* نظام تقديم الشكاوى من الوكلاء ضد البائعين وإدارتها من قبل الأدمن والبائع.

* عرض عدد الشكاوى المفتوحة في ملف البائع في لوحة تحكم الأدمن والبائع.

التبويبات في لوحة التحكم

الدور، التبويبات

البائع - أرباح وكلائي - المدفوعات - شكاوى الوكلاء

وكيل المبيعات (لوحة التحكم الرئيسية – عملائي – طلباتي – أرباحي – المدفوعات – حسابي)

الأدمن(لوحة التحكم الرئيسية – أرباح الوكلاء – مدفوعات العملاء – شكاوى الوكلاء – إعدادات الإضافة )