تطبيق متاجر SaaS متعدد التجار

1) تعريف المشروع

المشروع هو منصة Marketplace متعددة المتاجر باسم Matajjer مبنية على:

WordPress Plugin للـ Business Logic والـ REST API.React/Vite Theme لواجهة المستخدم Mobile-first.تكامل خارجي مع منصة العمولة 3omoola.com لإدارة المسوقين والأرباح.

2) المعمارية التقنية

1.Core Plugin: matajjer-core.php

REST API .2 + كل منطق الأعمال: class-matajjer-rest-api.php

3. Post Types / Taxonomies / Meta: class-matajjer-post-types.php

4. Installer + Default options + Roles: class-matajjer-installer.php

5. React App routing/pages: App.jsx

6. شاشة الحساب وخياراتها: AccountScreen.jsx

7. صفحات الإدارة/التاجر: AccountOptionScreen.jsx

8. Panels الإدارة: AdminPanels.jsx

9. API client frontend: api.js

10. i18n والترجمة: i18n.js

11. حقن إعدادات WP للـ React + Arabic default: functions.php

12. تكامل 3omoola: 3omoola-core.php

3) ما تم تنفيذه من الصفر (مراحل)

1. تأسيس المنصة كـ Multi-store مع Post Types: mtjr_store , mtjr_product , mtjr_order + تصنيفات mtjr_product_category

2. بناء واجهة Mobile-first كاملة: Home، Store Profile، Product، Cart/Checkout، Account، Admin/Merchant Panels.

3. بناء نظام Auth كامل (lookup/login/register/logout) وربطه بحالة الجلسة داخل React.

4. بناء لوحة حساب متعددة الأدوار: عميل، تاجر، أدمن، ومسوق.

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

6.تنفيذ رفع الصور Upload بدل روابط في أماكن الإدارة المطلوبة.

7. تطوير نظام الطلبات:إدارة طلبات للأدمن حسب المتاجر و إدارة طلبات للتاجر على منتجات متجره وتفاصيل طلب احترافية وتغيير حالة الطلب وتوليد رقم طلب والبحث بالرقم/بيانات العميل.

8. تفعيل قواعد Checkout:سلة متجر واحد فقط.منع الإكمال بدون عنوان محفوظ (على واجهة العميل).

9. تطوير نظام التقييمات: حفظ/اعتماد/إخفاء/حذف + إصلاح مشاكل ظهور التقييم قبل الاعتماد ومشاكل 404.

10.تطوير نظام Affiliate داخل متاجر: تقديم طلب انضمام وحالات الطلب (بدون طلب / pending / active)وصفحة إدارة عمولة للمستخدم النشط.

11. تكامل كامل مع 3omoola:إنشاء حساب affiliate على 3omoola وجلب الحالة والرصيد ولوحة SSO ومزامنة status من/إلى 3omoola ومزامنة pending/completed/cancelled مع 3omoola بناءً على حالة الطلب.

12. نظام أكواد المسوقين:أكواد لكل مسوق.خصم (نسبة أو ثابت) + Cashback وقيود متاجر/منتجات وإدخال كود في السلة واحتساب أرباح المسوق بالدولار من قيمة طلبات JD

13. تحسينات واجهة وتجربة استخدام واسعة:تعريب شامل + جعل العربية الافتراضية مع وجود اللغة الإنجليزية كخيار اخر.

14.فلترة إدارة المتاجر: الأحدث/الأقدم/أكثر منتجات/أكثر مبيعات + بحث باسم المتجر أو منتج.

15 في طلبات المسوقين: عند الحالة نشط يظهر زر إعداد الكود يفتح إعداد كود نفس المسوق مباشرة.

4) نطاق REST API المنفذ

1. حساب ومصادقة:

/account , /auth/*

2. تاجر:

/merchant/*

3. أدمن: (store, products, categories, reviews)

/admin/*

(users, stores, products, categories, banners, payment methods, reviews, affiliate codes, affiliate applications, merchant applications)

4. متجر/منتج/تقييم:

/stores , /stores/{slug} , /products/{id} , /products/{id}/reviews

5. Checkout وManage Orders:

/checkout , /orders/manage , /orders/manage/{id} , /dashboard

6. تكامل العمولة الخارجي في 3omoola:

/wp-json/3omoola-integration/v1/*

.

5) قواعد عمل تم ترسيخها

1. Currency split:المنتجات/المنصة: JD.العمولة/الأرباح للمسوق: USD.معدل التحويل المعتمد للعمولة:

1 JD = 1.41 USD

2. لا يمكن Checkout عند عدم وجود عنوان محفوظ

3. لا يمكن دمج منتجات متاجر مختلفة داخل نفس الطلب.

4. صلاحيات واضحة حسب الدور (Admin/Merchant/Customer/Affiliate).

6) الحالة الحالية للمشروع

المشروع يعمل كمنصة ويب متكاملة (Front + Back + Affiliate integration).تم تنفيذ أغلب المتطلبات التشغيلية والإدارية والتجارية المطلوبة.تم تمرير فحوصات بناء/صياغة أثناء التنفيذ ( npm run build + php -l).

7) جاهزية التحويل لتطبيق موبايل

الواجهة أصلًا Mobile-first.الـ APIs منظمة وجاهزة للاستهلاك من تطبيق Native/Flutter/React Native.المسارات والـ Business rules مركزية في الـ Plugin، وهذا يسهل إعادة استخدام نفس الـ backend للتطبيق بدون إعادة كتابة المنطق. ( وهو ما نعمله عليه حاليا