تخطَّ إلى المحتوى
مشروع برنامج تدريبي

تطبيق الفواتير المصغّر

البناء داخل منظومة شخص آخر يعني أن واجهاته هي من يحدّد حدود منتجك.

واجهات المنتجات في هذه الصفحة تصوّرات مبنية على البنية الفعلية لوحدات كل منصة. وليست لقطات شاشة من أنظمة في الإنتاج — فهذه منصات خاصة بعملاء وتجارية.

الدور
مهندس واجهات
السنة
2025
الحالة
مُسلَّم · برنامج ITS
التصنيف
منتج

تطبيق مصغّر لإنشاء الفواتير ودفعها مبني بـReact داخل منظومة SuperQi المالية، يدمج واجهات المنصة للمصادقة ومسح المستندات ومعالجة الدفع وعرض PDF وتنزيل الملفات عبر مسار فاتورة كامل.

المشكلة

التطبيق المصغّر لا يملك مصادقته ولا قناة دفعه ولا معالجة مستنداته — بل يستعيرها كلها من المنصة المضيفة، وعليه أن يتصرّف بشكل صحيح حين ترفض المنصة.

النتيجة

مسار فاتورة كامل — إنشاء وإرسال ودفع وسجل معاملات — يعمل بالكامل على قدرات المنصة المضيفة.

التقنيات

  • React
  • JavaScript
  • Axios
  • REST API
  • PDF rendering

البناء على أساسات مُستعارة

التطبيق المصغّر موقع هندسي غير معتاد. لا تتحكّم بالهوية ولا بقناة الدفع، ولا يمكنك العودة إلى تنفيذك الخاص حين يتعطّل شيء. ما تتحكّم به هو مدى صدق واجهتك في نقل حالة المضيف.

  1. 01

    إنشاء

    تُنشأ الفاتورة، اختيارياً من مستند ممسوح عبر واجهة المسح في المنصة.

  2. 02

    إرسال

    تُصدر الفاتورة للمستلم وتصبح سجلاً قابلاً للدفع.

  3. 03

    دفع

    يمرّ الدفع عبر معالجة المنصة المضيفة لا عبر تكامل دفع خاص بنا.

  4. 04

    أرشفة

    تُحفظ الفاتورة في سجل المعاملات، قابلة للعرض كـPDF وللتنزيل.

مسار الفاتورة من الطرف إلى الطرف.

انضباط التكامل

  • المصادقة والمسح والدفع وعرض PDF والتنزيل كلها قدرات مضيفة — ويعامل التطبيق كلاً منها كشيء قد يتعطّل.
  • اتصال قائم على Axios مع إدارة حالة منظّمة يفصل دورة حياة الطلب عن حالة الواجهة.
  • المسار كامل لا جزئي — فمسار فاتورة نصف مبني غير قابل للاستخدام إطلاقاً.

من أين جاء

بنيتُ هذا خلال عملي وتدريبي في Qi Card، ضمن برنامج Iraq TechSchool المُقدَّم بالتعاون مع Qi Card وDigital Zone وComputiq وHUB200 — ولهذا جاءت مفاهيم مسارات الدفع الرقمي فيه من شركاء القطاع لا من كتاب دراسي.

هو مشروع تدريبي، وأنا أقرأه على هذا الأساس. البناء نفسه صغير. وما خرجتُ به منه أضيق من قائمة الميزات، وأنفع منها.

  • العمل داخل بيئة مغلقة — بيئة SuperQi — لا أتحكّم فيها بالمنصة ولا بالواجهات ولا بالقيود. الحدود كانت مرسومة قبل وصولي، والشغل أن أبني شيئاً صحيحاً داخلها لا أن أجادلها.
  • العمل انطلاقاً من التوثيق: أقرأه بدقّة، وأتحقّق من السلوك الفعلي مقابله بدل أن أفترض ما سيفعله الاستدعاء.
  • البرنامج

    Iraq TechSchool — برنامج هندسة برمجيات لستة أشهر

  • المنظومة

    SuperQi

الدراسة التالية

تبني شيئاً في هذا المجال؟

أنا متاح لعدد محدود من المشاريع. أخبرني بما تعمل عليه.