انتقل إلى المحتوى

برمجة باك إند وواجهات API لحظية بـ Node.js وTypeScript

خوادم خلفية بـ Node.js وTypeScript تحفظ بيانات تطبيقك وتتحقق من صلاحيات كل مستخدم وترسل التحديثات لحظة حدوثها عبر WebSocket. بنينا بهذه الطريقة الخادم الخلفي لمنصة Escore بست عشرة وحدة.
المدة المعتادة
3–6 أسابيع
بنود التسليم
8
آخر تحديث
2026-10-05

نتولّى برمجة باك إند وواجهات API لحظية بـ Node.js وTypeScript: الخادم الذي يحفظ بيانات تطبيقك، ويتحقق من صلاحية كل مستخدم قبل أي عملية، ويرسل التحديثات إلى الجوال ولوحة التحكم لحظة وقوعها. أكبر ما بنيناه من هذا النوع هو الخادم الخلفي لمنصة Escore للرياضات الإلكترونية، لصالح شركة Rov Group السعودية، خلال عام من العمل بين أغسطس 2025 وأغسطس 2026.

صمّم محمود حمدي ذلك الخادم وبناه، وبنى عليه لوحة التحكم بـ Next.js، بينما قاد محمد مجدي تطبيق Flutter الذي يستهلكه. والتطبيق اليوم منشور على Google Play وApp Store، ويضم أكثر من 5,000 مستخدم مسجّل.

كيف بنينا الخادم الخلفي لـ Escore من 16 وحدة

يعمل خادم Escore عملية واحدة على Node.js وExpress وTypeScript، مقسّمة إلى ست عشرة وحدة منفصلة: البطولات ومخططاتها، والمباريات، والفرق، وتصنيفات الفرق واللاعبين، والأخبار، والانتقالات، وتسجيل الدخول والصلاحيات، وغيرها. لكل وحدة مساراتها ووحدات التحكم والخدمات ونماذج البيانات الخاصة بها.

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

البيانات محفوظة في MongoDB عبر Mongoose. بيانات الرياضات الإلكترونية متداخلة ومتنوعة الشكل: فريق داخله لاعبون، وبطولة داخلها مراحل ومباريات، ومباراة لها أحداث وإحصاءات. نموذج المستندات في MongoDB يناسب هذا التداخل أكثر من الجداول. ويعمل الخادم مع MongoDB وRedis داخل Docker Compose على خوادم DigitalOcean.

لماذا اخترنا WebSocket بدل الاستعلام المتكرر

النتيجة المباشرة لا قيمة لها إن وصلت بعد دقيقة. البديل التقليدي أن يسأل التطبيق الخادم كل بضع ثوانٍ «هل تغيّر شيء؟»، فتضيع أغلب الطلبات حين لا يتغير شيء، ويتأخر التحديث حين يتغير.

في Escore يفتح التطبيق ولوحة التحكم اتصالًا دائمًا عبر WebSocket باستخدام Socket.IO، ويدفع الخادم النتائج وتغييرات مخطط البطولة والإشعارات فور حدوثها. وتحصر «غرف» Socket.IO البث في كل بطولة وكل مباراة، فمن يتابع مباراة واحدة لا يستقبل تحديثات عشرات المباريات الأخرى.

ثلاثة مزوّدي بيانات خلف واجهة واحدة

تأتي بيانات المباريات من مزوّدين متخصصين. قيّم محمود ثلاثة منهم، PandaScore وGRID وAbios، ثم دمجها كلها. تعمل مهام مجدولة تستعلم من كل مزوّد على فترات قابلة للضبط، وتوحّد شكل الردود المختلفة، وتحفظها في MongoDB.

النتيجة أن التطبيق ولوحة التحكم لا يتحدثان مع أي مزوّد مباشرة؛ يقرآن من واجهة Escore فقط. وتغيير مزوّد أو إضافة آخر عمل داخل الخادم لا يمس التطبيق المنشور على المتجرين.

الصلاحيات حسب الدور ولوحة تحكم على الواجهة نفسها

يستخدم الخادم رموز JWT قصيرة العمر مع رموز تجديد مشفّرة، وطبقة صلاحيات تحرس كل مسار حسب الدور. في Escore خمسة أدوار: مدير أعلى، ومدير، ومحرر، ومدير فريق، ومشاهد.

لوحة التحكم التي يدير منها المحررون البطولات والمباريات والتصنيفات والأخبار تعمل على الواجهة البرمجية نفسها التي يستخدمها تطبيق الجوال. فقواعد العمل مكتوبة في مكان واحد، ولا تتصرف اللوحة بطريقة والتطبيق بطريقة أخرى.

خفض حجم البيانات 65% وزمن الاستجابة 54%

جمهور Escore يتابع كثيرًا على شبكات بطيئة وأجهزة Android متواضعة. أعاد محمد مجدي، من جهة التطبيق، بناء طريقة التكامل مع الواجهة البرمجية وتحويل بيانات JSON، فانخفض حجم البيانات المنقولة 65% وزمن استجابة الخادم 54%، وصارت الشاشات تُحمَّل أسرع.

مشاريع أخرى على النمط نفسه

في إحكام، منصة حفّاظ القرآن على ihkamquran.com، استخدم محمود PostgreSQL على Neon مع Drizzle ORM. وصُمّمت الواجهة بحيث لا تصل الإجابة الصحيحة إلى المتصفح قبل أن يرسل المستخدم إجابته، فلا يمكن قراءتها من الصفحة نفسها.

وفي Bagour Delivery، مشروع محمود الخاص لتوصيل الطعام في الباجور بالمنوفية، يبني خادمًا بـ Node.js وTypeScript وMongoDB يوزّع الطلبات فوريًا عبر Socket.IO بين العميل والسائق والمطعم والإدارة، مع الدفع عبر Paymob. المشروع ما زال قيد التطوير، ولم يُطلق بعد.

وخارج العمل للعملاء، قُبل لمحمود 119 طلب دمج في 24 مشروعًا مفتوح المصدر، منها helmet وexpress-validator وmongoose وnanoid وzod، وهي مكتبات يقوم عليها كثير من خوادم Express. كل طلب منها راجعه مشرفو المشروع قبل دمجه.

متى تحتاج إلى برمجة باك إند وواجهات API لحظية، وكم تستغرق

إن كان لديك تطبيق قائم ينقصه خادم أو طبقة تحديث لحظي، نضيفها خلال 3 إلى 6 أسابيع مع توثيق يستلمه مطوروك. وإن كنت تبدأ من الصفر، يدخل الخادم ضمن نسخة أولى بنطاق محدد مدتها من 6 إلى 10 أسابيع، مع تطبيق الموبايل ولوحة التحكم، وتستلم نسخة تجريبية كل أسبوع.

نحن مهندسان في المنوفية بمصر نعمل عن بُعد لعملاء في مصر والخليج. حين تعمل معنا على الخادم الخلفي تتحدث مباشرة مع محمود، الذي يكتبه بنفسه.

المدة المعتادة
3–6 أسابيع
الأدوات التي نستخدمها
12
مشاريع
6

ما الذي تستلمه

  1. خادم خلفي بـ Node.js وExpress وTypeScript مقسّم إلى وحدات، لكل وحدة مساراتها ومنطقها ونماذج بياناتها
  2. واجهة REST موثّقة يستخدمها التطبيق ولوحة التحكم معًا
  3. طبقة تحديث لحظي عبر WebSocket (Socket.IO) مع غرف تحصر البث فيمن يتابع الحدث
  4. تسجيل دخول بـ JWT وصلاحيات حسب دور كل مستخدم
  5. قاعدة بيانات MongoDB أو PostgreSQL بحسب شكل بياناتك
  6. ربط بالخدمات الخارجية التي تحتاجها: مزوّدو بيانات، أو بوابة دفع، أو منصة متجر
  7. إعداد تشغيل بـ Docker وتوثيق يستلمه مطوروك ويكملون عليه
  8. الكود المصدري وحسابات الخوادم باسمك من اليوم الأول

الأدوات التي نستخدمها

المدة المعتادة

المدد بالأسابيع. الجزء المخطط هو الحد الأدنى، والمتقطع يتبع حجم النطاق.

مشاريع نفّذنا فيها هذه الخدمة

مشاريع
6
  • تطبيق جوال، 2025

    Escore

    منصة لمتابعة الرياضات الإلكترونية مباشرةً في منطقة الشرق الأوسط وشمال أفريقيا، تعرض النتائج المباشرة ومخططات البطولات والتصنيفات والأخبار بالعربية والإنجليزية على iOS وAndroid والويب، مع لوحة تحكم لفريق التحرير.

    • Flutter
    • Dart
    • Node.js
    • Express
  • موقع إلكتروني، 2026

    إحكام

    منصة ويب عربية لحفّاظ القرآن الكريم تكتشف بدقة المواضع المتشابهة التي يخلط فيها الحافظ، وتعرضها متجاورة مع إبراز موضع الاختلاف، ثم تجدول له مراجعة يومية حتى يُتقنها.

    • Next.js
    • React
    • TypeScript
    • Tailwind CSS
  • تطبيق جوال، 2025

    Sound to Read

    تطبيق يعلّم الأطفال من 6 إلى 12 سنة قراءة الإنجليزية بالطريقة الصوتية، بدءًا من أصوات الحروف وصولًا إلى الجمل الكاملة، بصوت متحدثين أصليين وتقارير تقدّم يطّلع عليها الوالدان. متاح على Google Play وApp Store.

    • Flutter
    • Dart
    • Dio
    • REST APIs
  • تطبيق جوال

    Saudi Host

    منصة سياحية تربط زوّار المملكة العربية السعودية بالمرشدين السياحيين المحليين، ولكل دور فيها شاشاته وصلاحياته. لم تُطلق بعد.

    • Flutter
    • Dart
    • GoRouter
  • تطبيق جوال، 2025

    تركيبات

    سوق خدمات يصل أصحاب العقارات بالحرفيين في أعمال البناء والدهان والكهرباء، ومتاح على Google Play وApp Store.

    • Flutter
    • Dart
    • BLoC / Cubit
    • GoRouter
  • موقع إلكتروني

    Bagour Delivery

    منصة لتوصيل الطعام في مدينة الباجور بمحافظة المنوفية، تضم تطبيقات للعميل والسائق والمطعم ولوحة للإدارة، مع توزيع فوري للطلبات. قيد التطوير.

    • Node.js
    • TypeScript
    • Socket.IO
    • MongoDB

لماذا يثق بنا عملاؤنا

ما يمكنك الاعتماد عليه من أول مكالمة إلى ما بعد الإطلاق بوقت طويل.
  • الكود والحسابات ملكك من اليوم الأول

    مستودع الكود المصدري، وحسابات المطوّر على Google Play وApp Store، وحسابات الخوادم والسحابة والنطاق تُنشأ باسمك من البداية. نعمل عليها بصلاحيات تمنحها لنا، وتبقى معك إن توقف التعاون.

  • اتفاقية سرية قبل أن تشرح فكرتك

    نوقّع اتفاقية عدم الإفصاح (NDA) قبل أن تشرح لنا فكرة المشروع، لا بعد الاجتماع الأول.

  • إصلاح مجاني للأعطال 30 يومًا

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

  • خطة دعم شهرية اختيارية

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

أسئلة عن هذه الخدمة

أسئلة
6

مقالات ذات صلة

احكِ لنا عن فكرتك

راسلنا على واتساب أو أرسل وصفًا قصيرًا لمشروعك، ونرد عليك بنطاق مقترح ومدة تقريبية. وإن أردت تقديرًا مبدئيًا للمدة أولًا، جرّب حاسبة التكلفة.