مطلوب مطور واجهة برمجة تطبيقات لمنصة تطبيق التأشيرة العالمية
الوصف
• تصميم واجهة برمجة تطبيقات REST متوافقة مع OpenAPI 3.1 للاستخدام الداخلي والخارجي.
• تحديد المصادقة والتفويض (OAuth2.0 ، JWT).
• تصميم مخطط قاعدة البيانات (يفضل PostgreSQL) للمتقدمين والمستندات والمدفوعات والتتبع.
• إنشاء هيكل خدمات مصغرة معياري (إدارة المستخدم ، وطلبات التأشيرات ، والمدفوعات ، والإشعارات ، والتقارير).
الوحدات الوظيفية الأساسية
a. إدارة المستخدمين والشركاء
• التسجيل / تسجيل الدخول للمستخدمين والشركاء والمسؤولين.
• التحكم في الوصول القائم على الأدوار (RBAC).
• مفاتيح واجهة برمجة تطبيقات الشريك مع حدود المعدل وسجلات الاستخدام.
ب. سير عمل طلب التأشيرة
• نقاط النهاية لتقديم طلبات التأشيرة أو تعديلها أو إلغائها.
• تحميل وإدارة مستندات مقدم الطلب (PDF / JPEG).
• تخزين مسارات الرحلات وبيانات النماذج.
• إنشاء الأرقام المرجعية للإيصالات والإيصالات.
• حالة التتبع (تم تقديمها → التحقق → المعالجة → الموافقة / الرفض).
ج. تكامل الدفع
• دمج Stripe / PayPal / Flutterwave للمعاملات الآمنة.
• دعم العملات المتعددة (الدولار الأمريكي ، الدرهم الإماراتي ، الراند الجنوب الأفريقي ، الروبية الباكستانية ، الروبية الهندية).
• المبالغ المستردة وسجلات المعاملات وإشعارات webhook.
د. التحقق من المستندات والهوية
• التكامل مع واجهات برمجة تطبيقات المسح الضوئي للحروف / المسح الضوئي للمستندات (على سبيل المثال ، Google Vision أو Tesseract أو ID Analyzer).
• التحقق الاختياري من مطابقة الوجه أو السيلفي (حزم SDK التابعة لجهات خارجية).
e. الإخطارات والاتصالات
• إشعارات البريد الإلكتروني / الرسائل القصيرة / WhatsApp (Twilio أو Meta API).
• نماذج لاستلام الطلب ، ونجاح الدفع ، والمستندات المفقودة ، وقرار التأشيرة.
f. لوحة المعلومات والتحليلات (واجهة برمجة تطبيقات المسؤول)
• استرداد إحصائيات الطلب حسب البلد أو نوع التأشيرة أو الشريك.
• تقارير التصدير (CSV ، XLSX ، PDF).
• سجل نشاط المستخدم وأحداث واجهة برمجة التطبيقات (للتدقيق).
