التقرير التقني لمنصة SJL

نظرة شاملة على الهندسة المعمارية وحالة المشروع

تاريخ الإنشاء: 23 أغسطس 2025

الملخص التنفيذي

SJL (سجل) هي منصة سوق تعليمي B2B شاملة مصممة لإحداث ثورة في الاتصال بين المؤسسات التعليمية ومقدمي خدمات النقل في جميع أنحاء المملكة العربية السعودية. مبنية على بنية تحتية سحابية حديثة مع أحدث التقنيات، توفر المنصة حلاً قابلاً للتطوير وآمناً وسهل الاستخدام لإدارة احتياجات النقل التعليمي.

5
مكونات المنصة
50%
التقدم الإجمالي
3
عمليات النشر المباشر
+15
التقنيات المستخدمة

التقنيات المستخدمة حالياً

تقنيات الواجهة الأمامية

  • Next.js 15.4.6 في الإنتاج
  • React 18.3.1
  • TypeScript 5.x
  • Tailwind CSS 3.4
  • next-intl (تعدد اللغات)
  • Sonner (الإشعارات)
  • Lucide Icons
  • Radix UI Components

الخادم وقاعدة البيانات

  • NestJS Framework مباشر
  • Supabase (PostgreSQL)
  • Redis (إدارة الجلسات)
  • TypeORM
  • JWT المصادقة
  • Bcrypt (تشفير كلمات المرور)
  • Class Validator

الخدمات السحابية

  • Vercel (استضافة الواجهة) مباشر
  • Railway (استضافة الخادم) مباشر
  • Supabase Cloud
  • GitHub (التحكم بالإصدار)
  • GitHub Actions (CI/CD)
  • Sentry (تتبع الأخطاء)
  • Cloudflare (DNS)

تطوير الهاتف المحمول

  • Flutter قيد التطوير
  • لغة Dart
  • Provider State Management
  • Flutter Material Design
  • Shared Preferences
  • Firebase Cloud Messaging

تكاملات الطرف الثالث

  • Cequens (SMS OTP) نشط
  • Titan Email مُعد
  • Moyasar (المدفوعات) قيد التنفيذ
  • Google Maps API مخطط
  • Firebase (الإشعارات) مخطط

الأمان والمراقبة

  • تشفير SSL/TLS
  • المصادقة بـ OTP
  • التحكم في الوصول القائم على الأدوار (RBAC)
  • مراقبة الأخطاء بـ Sentry
  • تحديد المعدل
  • تكوين CORS
  • التحقق من المدخلات
  • منع حقن SQL

حالة النشر الحالية

الصفحات الرئيسية (العربية/الإنجليزية): https://sjl.education
لوحة التحكم الإدارية: https://admin.sjl.education
واجهة برمجة التطبيقات الخلفية (NestJS): https://sjl-production.up.railway.app ✗ غير متاح حالياً - مشكلة في إعداد Redis
قاعدة البيانات (Supabase): نشطة ومتصلة
خدمة الرسائل القصيرة (Cequens): تعمل بكفاءة

معالم المشروع والتقدم

المرحلة الأولى: الأساس والبنية التحتية
100%
  • تصميم هندسة المشروع والتخطيط
  • تصميم مخطط قاعدة البيانات مع Supabase
  • إعداد البنية التحتية السحابية (Vercel، Railway، Supabase)
  • إعداد مستودع GitHub والتحكم في الإصدار
  • تكوين بيئة التطوير
  • تكوين خط أنابيب CI/CD
المرحلة الثانية: تطوير المنصة الأساسية
95%
  • الصفحات الرئيسية بالعربية والإنجليزية مع تصميم متجاوب
  • لوحة التحكم الإدارية مع Next.js 15 و TypeScript
  • نظام المصادقة بـ OTP مع تكامل Cequens
  • دعم متعدد اللغات (العربية/الإنجليزية) مع next-intl
  • تدفقات التسجيل للمؤسسات ومقدمي النقل
  • التحكم في الوصول القائم على الأدوار (6 أدوار مستخدم)
  • التنقل في لوحة التحكم مع المسارات المجمعة
  • نقاط نهاية واجهة برمجة التطبيقات الخلفية (NestJS)
  • تكامل خدمة إشعارات البريد الإلكتروني
  • نقطة نهاية واجهة برمجة تطبيقات نموذج الاتصال

التحديات الحالية

  • • نشر واجهة برمجة التطبيقات الخلفية يعود بخطأ 404 على منصة Railway
  • • نقطة نهاية نموذج الاتصال غير مطبقة في الخادم
  • • يجب إكمال تكامل Titan Email لرسائل البريد الإلكتروني التشغيلية
  • • الحاجة إلى التحقيق في سجلات نشر Railway
المرحلة الثالثة: لوحة التحكم الإدارية
85%
  • مشروع لوحة تحكم المؤسسة المستقل
  • هيكل التوجيه ونظام الملاحة
  • صفحات إدارة الصور والفيديو
  • إعدادات المؤسسة وإدارة الملف الشخصي
  • تحميل مستندات KYC والتحقق منها
  • إدارة الاشتراك والمدفوعات
المرحلة الرابعة: تسجيل المؤسسات ومقدمي الخدمات
10%
  • مخطط قاعدة البيانات لنظام النقل
  • تصميم واجهة إدارة الأسطول
  • ربط وتكامل تتبع GPS
  • إدارة السائقين والمركبات
  • تخطيط المسار والأمثل
  • إشعارات أولياء الأمور في الوقت الفعلي
المرحلة الخامسة: نظام الدفع والفوترة
0%
  • إعداد مشروع Flutter
  • تصميم واجهة المستخدم/تجربة المستخدم الأساسية
  • شاشات المصادقة والتحقق من OTP
  • تتبع الحافلة في الوقت الفعلي
  • الإشعارات الفورية
  • ميزات أولياء الأمور

الإنجازات الرئيسية

الخطوات التالية (الأولوية)

  1. حل مشكلة نشر Railway Backend - التحقيق في خطأ 404 واستعادة واجهة برمجة التطبيقات
  2. تنفيذ واجهة برمجة تطبيقات نموذج الاتصال - إنشاء نقطة نهاية للصفحة الرئيسية
  3. إكمال تكامل البريد الإلكتروني - إعداد Titan Email للإشعارات
  4. نشر لوحة تحكم المؤسسة - إطلاق المكون الثاني
  5. بدء تكامل Moyasar - بوابة الدفع لخطط الاشتراك
  6. تطوير تطبيق الهاتف المحمول - تسريع تطوير Flutter
  7. تنفيذ تتبع GPS - تكامل تتبع الحافلات في الوقت الفعلي
  8. الاختبار الشامل - الأداء والأمان وتجربة المستخدم

تقييم المخاطر

  • حرج: فشل نشر Railway Backend - يحتاج إلى حل فوري
  • متوسط: تكامل البريد الإلكتروني غير مكتمل - يؤثر على تجربة المستخدم
  • متوسط: تأخير في تطوير تطبيق الهاتف المحمول - قد يؤثر على تاريخ الإطلاق
  • منخفض: بوابة الدفع معلقة - غير مطلوبة للمرحلة التجريبية