نظام إدارة معارض السيارات
منصة متكاملة تدير معرض سيارات من أوله إلى آخره - المخزون، عروض الأسعار، المبيعات، التمويل بالتقسيط، التحصيل، النزاعات، فواتير المورّدين والتقارير المالية - مبنية لسوق تُباع فيه السيارات بأقساط طويلة الأجل ويجب أن يصمد فيه كل رقم أمام التدقيق.
العميل
unknown
النوع
نظام
المدة
unknown
المخرجات
واجهة برمجية بـ Express وTypeScript واجهة إدارة بـ React وTypeScript مخطط PostgreSQL مع ترحيلات مُصدَّرة إدارة المستخدمين والصلاحيات حسب الدور مسار التمويل بالتقسيط والتحصيل تقارير مالية مع تصدير Excel وPDF طبقة ترجمة كردية سورانية اختبارات انحدار وتحقق مالي آلية توثيق التنصيب وقائمة ما قبل الإطلاق
التحدي
كانت عمليات المعرض موزّعة على جداول منفصلة. لكل سيارة أساس تكلفة مختلف - سعر الشراء، تكاليف الاستيراد من دبي، أعمال الصيانة، المصاريف المرتبطة - فلم يكن أحد قادرًا على تحديد الربح الفعلي لعملية بيع واحدة. الأقساط تُتابَع يدويًا، ورسوم التأخير تُطبَّق بشكل غير متسق، والمجاميع الشهرية لا تتطابق أبدًا. الشرط الأساسي كان أن يكون للمال مصدر حقيقة واحد: الرقم المسجَّل لحظة البيع حقيقة تاريخية لا يجوز أن تتغير بصمت عند تعديل معادلة لاحقًا.
الحل
واجهة برمجية بـ Express وTypeScript على PostgreSQL مع ترحيلات Knex، ومصادقة JWT برموز وصول وتحديث، وصلاحيات حسب الدور للمدير والمشرف والموظف، ومهام مجدولة تعالج الأقساط المتأخرة وتعيد حساب درجة مخاطر العميل ليلًا. الواجهة تطبيق أحادي الصفحة بـ React 18 وVite مع TanStack Query وZustand وReact Hook Form وZod وTailwind وRecharts. كل معادلة مالية تعيش في وحدة مرجعية واحدة، مع نسخة في الواجهة للمعاينة فقط، وفحص آلي يُفشل عملية البناء إذا تسرّب أي حساب إلى مكان آخر. فوق ذلك: معالجات متعددة الخطوات لعروض الأسعار والمبيعات، توليد تلقائي لجداول الأقساط، احتساب رسوم التأخير بالأيام، تحليل الربح لكل سيارة، تصدير Excel وPDF، وطبقة ترجمة كردية سورانية تغطي الواجهة بالكامل. تنشئ مجموعة الاختبارات قاعدة بيانات PostgreSQL مؤقتة، وتشغّل الترحيلات الحقيقية على استعلامات SQL حقيقية، ثم تحذف نفسها - فالاختبارات المالية تتحقق من المنطق الفعلي لا من محاكاة.
النتيجة
صار هناك نظام واحد يجيب عمّا عجزت الجداول عنه: كم كلّفت سيارة بعينها وكم ربحت فعليًا، وأي العملاء يمثّل مخاطرة بحسب التأخير والنزاعات المفتوحة، وكيف تقف إيرادات الشهر أمام مصاريفه بشكل يتطابق مع قائمة الأرباح والخسائر. رسوم التأخير تُطبَّق بالطريقة نفسها في كل مرة، والمخزون يعود إلى حالته الصحيحة عند إلغاء أي عملية بيع. نحو ٢٦٠٠٠ سطر من TypeScript في ١٠٩ ملفات و٢٦ شاشة. والتسليم مشروط: يجب أن يعيد سكربت التحقق المالي صفر ملاحظات قبل تشغيل النظام.