مطور Next.js / TypeScript لربط تطبيق فواتير قائم مع API خارجي خاص بـ ZATCA

هندسة البرمجيات تطوير البرمجيات PostgreSQL Restful API typescript Next.js هندسة البرمجيات تطوير البرمجيات PostgreSQL Restful API typescript Next.js

نبحث عن مطور محترف لديه خبرة في **Next.js** و **TypeScript** للعمل على تطبيق فواتير قائم بالفعل وموجّه للسوق السعودي. التطبيق مكتمل بشكل كبير، ويحتوي على: * تسجيل دخول وإدارة المستخدمين * إدارة بيانات المنشأة * إدارة العملاء * إنشاء وإدارة الفواتير * لوحة تحكم * توليد PDF * دعم العربية والإنجليزية يوجد داخل المشروع حاليًا **Mock ZATCA layer** جاهز، والمطلوب الآن هو ربط التطبيق مع **API خارجي جاهز من جهتنا** لتنفيذ التكامل الحقيقي مع ZATCA. **مهم جدًا** هذا المشروع **ليس** بناء تكامل ZATCA من الصفر. من جهتنا نحن نوفر الـ API الذي يتولى: * إنشاء XML * التوقيع * إنشاء QR * الإرسال إلى ZATCA معلومات إضافية عن المشروع * التطبيق مستضاف على Vercel * قاعدة البيانات PostgreSQL على Neon * مستودع GitHub جاهز للمشاركة مع المطور الذي سيتم اختياره * يوجد ملف HANDOFF.md داخل المستودع ويحتوي على توثيق كامل * جميع حقول ZATCA موجودة مسبقًا داخل Prisma schema مثل:, uuid, zatcaStatus, qrCode, invoiceHash, zatcaResponse, zatcaSubmittedAt المطلوب أن يعمل المطور على فرع محمي في GitHub باسم: zatca-integration وليس على الفرع الرئيسي main **التقنيات المستخدمة** * Next.js * TypeScript * Prisma * PostgreSQL * NextAuth * Tailwind CSS **المهام المطلوبة** * ربط التطبيق الحالي مع API ZATCA الخارجي * معالجة نتائج الإرسال والاستعلام * إضافة الأزرار والواجهات اللازمة داخل النظام * عرض حالة الفاتورة بعد الإرسال * عرض الأخطاء إن وجدت بشكل واضح * عرض QR Code والـ UUID أو أي بيانات راجعة من الـ API * تحديث قاعدة البيانات أو Prisma schema عند الحاجة لتخزين بيانات ZATCA * إضافة Scheduled Job / Cron Job يعمل كل 1 إلى 4 ساعات لإرسال فواتير B2C المعلقة تلقائيًا إلى ZATCA * تحديث Dashboard ليعرض عدد الفواتير المعلقة التي ما زالت بانتظار الإرسال إلى ZATCA * اختبار التكامل على Sandbox * تجهيز التطبيق للانتقال إلى Production **المطلوب في المستقل** * خبرة قوية في Next.js وTypeScript * خبرة في ربط الأنظمة مع APIs خارجية * فهم جيد لـ Prisma و PostgreSQL * القدرة على العمل داخل مشروع قائم دون التأثير على الأجزاء الحالية * كتابة كود نظيف وواضح * يفضّل من لديه خبرة سابقة في أنظمة الفواتير أو المشاريع المالية * خبرة في GitHub workflow والعمل على فروع محمية **المخرجات المتوقعة** * تكامل عملي كامل بين التطبيق وAPI الخاص بنا * واجهات واضحة لعمليات الإرسال والاستعلام وعرض النتائج * تنفيذ واختبار التكامل على simulation * نسخة جاهزة للانتقال إلى Production * تسليم منظم مع توضيح الملفات التي تم تعديلها