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

نبحث عن مطور محترف لديه خبرة في **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

* تسليم منظم مع توضيح الملفات التي تم تعديلها