تطوير نظام الربط التلقائي OAuth لـ 12 منصة تجارية وإعلانية

تعتمد منصة "زمامك" (Zemamk) حالياً على ربط حسابات التجار من خلال قيام التاجر بنسخ ولصق مفاتيح الـ API يدوياً. نهدف من خلال هذا المشروع إلى أتمتة هذه العملية بالكامل وتحويل زر "اتصل" (Connect) إلى تدفق عمل بنظام (one-click OAuth flow)، بحيث يتم الربط بضغطة واحدة فقط.

سيتم تنفيذ هذا المشروع باستخدام أداة Nango (نسخة مستضافة ذاتياً - self-hosted instance) لإدارة التكاملات.

نطاق العمل:

يشمل المشروع تفعيل نظام الربط (OAuth) عبر المنصات التالية:

منصات التجارة: سلة (Salla)، زد (Zid)، شوبيفاي (Shopify).

منصات التواصل والإعلانات: فيسبوك، صفحات فيسبوك، إنستجرام بيزنس، واتساب كولود، جوجل آدز (Google Ads)، تحليلات جوجل (GA4)، تيك توك (Ads & Business)، سناب شات، X (تويتر سابقاً)، ولينكدإن.

أدوات جوجل: Google Search Console, Google Tag Manager.

(ملاحظة: منصة ووكومرس خارج نطاق هذا المشروع وستظل تعتمد على المفاتيح اليدوية).

المتطلبات التقنية لكل منصة (Definition of Done):

يعتبر العمل مكتملاً لكل منصة عند تحقيق الخطوات الأربع التالية والتحقق منها باستخدام حساب تجريبي "طرف ثالث" (لا يملك صلاحيات مطور):

إنشاء تطبيق المطورين (Developer App) وامتلاكه باسم Zemamk.

تسجيل وتحقق روابط إعادة التوجيه (Redirect/callback URIs) على الخادم المباشر.

تحميل كافة البيانات (client_id, client_secret) وقائمة الصلاحيات (Scopes) بدقة داخل Nango.

اجتياز مراجعة المنصة (Platform Review) في حال كانت المنصة تتطلب ذلك.

تحديث واجهة المستخدم (Frontend) للانتقال من نمط الإدخال اليدوي إلى نمط OAuth، مع إضافة حالة "صحة الاتصال" (Connection Health) للتنبيه في حال انتهاء صلاحية الرمز (Token).

الحالة الحالية للمشروع:

الربط مع "سلة" معطل حالياً بسبب عدم تسجيل رابط العودة (Callback URL).

الربط مع "جوجل" يعمل جزئياً ويظهر شاشة الموافقة.

المنصات الأخرى (ميتا، تيك توك، X، زد) تحتاج إلى تدقيق كامل.

توجد 5 منصات تتطلب مراجعة وتوثيقاً رسمياً (Shopify public app, Meta business verification, Google Ads developer token, TikTok Marketing API review, LinkedIn Marketing Developer).

المهارات المطلوبة:

خبرة عميقة في بروتوكول OAuth 2.0.

خبرة في التعامل مع Nango أو أدوات إدارة الـ API المشابهة.

تجربة سابقة في توثيق تطبيقات المطورين لدى (Meta, Google, Shopify, TikTok).

مهارات في تطوير واجهات المستخدم (Frontend) لربط الـ API وحالات الاتصال.

ملاحظة للمستقلين:

سيتم تزويدك بالسكوب التقني المفصل، القائمة النهائية للمنصات، والجدول الزمني عند بدء العمل. يرجى ذكر خبراتك السابقة في مشاريع مشابهة خاصة فيما يتعلق بتوثيق التطبيقات (App Reviews).