OKKP — نظام داخلي لمراقبة الجودة
المطوّر الرئيسي للمشروع · 2025
نظام ويب داخلي لمراقبة الجودة في شبكة من 9 مرائب مركبات. صمّمتُ البنية والواجهة البرمجية وكتبتُ معظم الكود: المخالفات والغرامات، والموظفون، وأرشيف الوثائق، والتصدير إلى Excel.
الواجهة
API
- المصادقة · JWT
- الموظفون
- المخالفات
- الاتصالات
- الأرشيف
البيانات
المشكلة
احتاجت شبكة مرائب Avenue Group التسعة إلى نظام داخلي واحد لتسجيل المخالفات والغرامات وحفظ بيانات الموظفين وإعداد التقارير دون تدخّل مطوّر.
الحل
تطبيق SPA على React + TypeScript فوق API على Node.js / Express وMongoDB، مع تصفية من جهة الخادم وأرشيف وثائق على Cloudinary ومصادقة JWT وتصدير إلى Excel داخل المتصفح؛ والنشر عبر Docker Compose وCI على GitHub Actions.
النتيجة
يعمل على خادم Linux الخاص بالشركة، ويصفّي الموظفون المخالفات ويصدّرون التقارير إلى Excel بأنفسهم.
نظرة عامة
في Avenue Group كنتُ المطوّر الرئيسي لنظام OKKP، وهو نظام ويب داخلي لمراقبة الجودة في شبكة من 9 مرائب مركبات، ضمن فريق من ثلاثة أشخاص. صمّمتُ البنية والواجهة البرمجية وكتبتُ معظم الكود (نحو 177 من 183 إيداعاً في 2025 عبر مستودعات المشروع الثلاثة).
التقنيات: تطبيق صفحة واحدة على React 18 + TypeScript (Vite وTailwind CSS)، وREST API على Node.js / Express 5، وقاعدة MongoDB (Mongoose). وجوهر النظام وحدة المخالفات والغرامات: تصفية من جهة الخادم حسب الاسم والقسم والنوع والحالة والمرأب والفترة، وترقيم الصفحات، ومرفقات الصور والفيديو، وحذف يتطلّب تأكيداً بكلمة المرور. وحولها وحدات للموظفين ومتابعة اتصالات السائقين وأرشيف الوثائق (Cloudinary مع بديل على القرص المحلي) والإشعارات الداخلية. والدخول عبر JWT (bcrypt) بالبريد الإلكتروني أو الهاتف.
تعرض الصفحة الرئيسية بطاقات KPI لكل مرأب، وتُصدَّر المخالفات والموظفون واتصالات السائقين وملخّص المرائب إلى Excel داخل المتصفح مباشرة. والنشر عبر Docker Compose (MongoDB + API) على خادم Linux خلف reverse proxy، وCI على GitHub Actions.
ماذا يفعل
- وحدة المخالفات والغرامات: تصفية من جهة الخادم (الاسم، القسم، النوع، الحالة، المرأب، الفترة) وترقيم الصفحات
- ملفات الموظفين مع رفع الصور والعقود والاستبيانات، ومتابعة اتصالات السائقين، وإشعارات داخلية
- أرشيف وثائق على Cloudinary مع بديل على القرص المحلي
- بطاقات مؤشرات KPI لكل مرأب وتصدير إلى Excel داخل المتصفح (SheetJS)
الخطوة التالية
تبحث عن مطوّر Full-Stack أو Python — أو تحتاج إلى بناء شيء مشابه؟ لنتحدث.
منفتح على عروض العمل — حضورياً أو بنظام هجين في موسكو، أو عن بُعد؛ بدوام كامل أو بعقد. أردّ خلال 48 ساعة — وأسرع عبر Telegram.