باك إند تطبيق نتائج مباشرة بـ WebSocket: كيف بنينا Escore
- نُشر
- القراءة
- قراءة في 8 دقائق
- الكاتب
- محمود حمديمهندس برمجيات متكامل (Full-Stack)

هذا المقال يشرح كيف بنيتُ الخادم الخلفي لـ Escore، وهو تطبيق نتائج مباشرة بـ WebSocket للرياضات الإلكترونية، عملتُ عليه عامًا كاملًا بين أغسطس 2025 وأغسطس 2026 لصالح شركة Rov Group السعودية. ستجد فيه لماذا قسّمتُ الخادم إلى 16 وحدة داخل عملية واحدة، ولماذا تصل النتائج إلى الجوال عبر اتصال دائم لا عبر طلبات متكررة، وكيف جمعنا بيانات ثلاثة مزوّدين خلف واجهة واحدة، وما الذي أراقبه لو بنيت خادمًا مشابهًا اليوم.
قسمنا العمل بيننا بوضوح: قاد محمد مجدي تطبيق Flutter، وتوليتُ أنا الخادم الخلفي ولوحة التحكم بـ Next.js. والتطبيق اليوم منشور على Google Play وApp Store، ويضم أكثر من 5,000 مستخدم مسجّل.
ما الذي كان على الخادم أن يحمله
Escore ليس شاشة نتيجة واحدة. فيه بطولات بمراحل مجموعات وإقصاء فردي ومزدوج ودوري كامل، ومخططات تُولَّد من هذه الأنظمة، ومباريات تتغير نتائجها أثناء اللعب. وفيه تصنيفات للفرق واللاعبين تُحدَّث بعد كل نتيجة، وتأخذ في حسابها مستوى البطولة ونسبة الفوز وحداثة المباراة. ثم الأخبار بالعربية والإنجليزية، ووحدة لانتقالات اللاعبين بين الفرق.
يغطي التطبيق ألعابًا مثل VALORANT وLeague of Legends وDota 2 وCS2. ويقرأ من الخادم نفسه طرفان: تطبيق Flutter الذي يستخدمه الجمهور، وتطبيق Next.js على الويب الذي يضم لوحة التحكم التي يدير منها المحررون البطولات والأخبار.
وكان هناك قيد حاضر طوال الوقت. كثير من جمهور Escore يتابع على شبكات بطيئة، ومع أن أغلب المسجّلين على iOS، كان على التطبيق أن يعمل جيدًا على أجهزة Android المتواضعة أيضًا. وكل بايت يرسله الخادم بلا حاجة يدفع ثمنه مستخدم ينتظر.
لماذا اخترت 16 وحدة في عملية واحدة بدل خدمات مصغّرة
الخادم عملية واحدة على Node.js وExpress وTypeScript، مقسّمة إلى 16 وحدة منفصلة: البطولات، والمباريات، والفرق، والتصنيفات، والأخبار، والانتقالات، والمصادقة والصلاحيات، وتسع وحدات أخرى. لكل وحدة مساراتها ووحدات التحكم والخدمات ونماذج البيانات الخاصة بها.
كان بإمكاني تقسيم النظام إلى خدمات مصغّرة (microservices). لكن ذلك يعني نشر كل خدمة ومراقبتها على حدة، واتصالات شبكية بين الخدمات بدل استدعاءات داخلية، وهو عبء لا يحتاجه فريق من مهندسَين. الوحدات المنفصلة داخل عملية واحدة تعطي معظم فائدة الفصل، وتترك الباب مفتوحًا: إن احتاج الحِمل يومًا إلى فصل وحدة بعينها، فحدودها مرسومة سلفًا.
واخترت Node.js لأن نموذجه غير المتزامن يناسب خادمًا يحمل اتصالات WebSocket مفتوحة إلى جانب طلبات REST العادية. أما TypeScript فكانت ضرورية مع هذا العدد من الوحدات. حين يتغير شكل كائن في وحدة البطولات، يدلّني المترجم على كل موضع يعتمد عليه قبل التشغيل.
لماذا يُبنى تطبيق نتائج مباشرة بـ WebSocket لا بالاستعلام المتكرر
الطريقة الأبسط أن يسأل التطبيق الخادم كل بضع ثوانٍ عن آخر نتيجة. هذه الطريقة، المعروفة باسم polling، تعمل، لكنها تخسر في الاتجاهين: معظم الطلبات تعود بلا جديد، والتحديث الحقيقي يتأخر حتى موعد السؤال التالي.
هذا مثال حسابي يوضح الفكرة، وليس رقمًا من Escore. لو فتح 1,000 مستخدم شاشة مباراة، وسأل كل تطبيق الخادم مرة كل 5 ثوانٍ، فهذه 200 طلب في الثانية حتى في الدقائق التي لا يتغير فيها شيء. ومع WebSocket يبقى الاتصال مفتوحًا، ولا يتكلم الخادم إلا حين يحدث شيء.
في Escore تعمل طبقة WebSocket عبر مكتبة Socket.IO إلى جانب خادم HTTP في العملية نفسها. يدفع الخادم من خلالها تحديثات النتائج وتغييرات مخطط البطولة والإشعارات داخل التطبيق لحظة حدوثها، إلى تطبيق الجوال وإلى الويب معًا.
الغرف: كل بطولة وكل مباراة قناة مستقلة
البث للجميع لا يصلح لتطبيق نتائج. قد تُلعب في اللحظة نفسها مباريات كثيرة في بطولات مختلفة، ومن يتابع مباراة واحدة لا يريد أن يدفع من باقة بياناته ثمن تحديثات البقية.
لذلك نظّمتُ البث في Escore بغرف Socket.IO، غرفة لكل بطولة وغرفة لكل مباراة. حين يتغير شيء في مباراة، يذهب التحديث إلى غرفتها فقط، ويصل إلى من يتابعها دون غيره.
ومن المفيد أن تعرف كيف تعمل الغرف عمومًا. الغرفة مفهوم في الخادم وحده، والعميل لا يعرف أي غرف هو فيها؛ الخادم هو من يضيف الاتصال إلى الغرفة (توثيق Socket.IO عن الغرف). وهذا يجعل لحظة الانضمام موضعًا طبيعيًا لفحص الصلاحية إن كانت بعض القنوات خاصة.
ثلاثة مزوّدين خلف واجهة واحدة: PandaScore وGRID وAbios
بيانات المباريات الاحترافية لا ننتجها نحن، بل تأتي من مزوّدين متخصصين. قيّمتُ ثلاثة منهم، PandaScore وGRID وAbios، ثم دمجتها كلها في الخادم.
لكل مزوّد شكل ردود خاص به. فبنيتُ مهام مجدولة تستعلم من كل مزوّد على فترات قابلة للضبط، وتحوّل ردوده إلى شكل موحّد، وتحفظ النتيجة في MongoDB. بعدها يقرأ التطبيق ولوحة التحكم من واجهة Escore فقط، ولا يتصل أيٌّ منهما بمزوّد مباشرة.
قد يبدو غريبًا أن يستعلم الخادم بنفسه بينما أرفض الاستعلام للتطبيق. الفرق في العدد: الخادم مستهلك واحد يسأل المزوّد، ثم يوزّع ما عرفه على كل الاتصالات المفتوحة. وللفصل فائدة أخرى: تغيير مزوّد أو إضافة آخر عمل داخل الخادم، لا يحتاج إلى إصدار جديد من التطبيق ولا إلى انتظار مراجعة المتجرين.
MongoDB لبيانات متداخلة، وRedis وDocker Compose للتشغيل
بيانات الرياضات الإلكترونية متداخلة وغير منتظمة. فريق داخله لاعبون، وبطولة داخلها مراحل ومباريات، ومباراة لها أحداث وإحصاءات. لهذا اخترت MongoDB مع Mongoose: نموذج المستندات يستوعب هذا التداخل، وMongoose يضيف التحقق من المخطط والربط بين المستندات المترابطة.
ويعمل الخادم وMongoDB وRedis في حاويات ينسّقها Docker Compose، ويُستخدم Redis للجلسات والتخزين المؤقت. البيئة نفسها تعمل في التطوير وعلى خوادم DigitalOcean في الإنتاج، فما يعمل على جهازي يعمل على الخادم بالإعداد ذاته.
الصلاحيات: خمسة أدوار ورموز وصول قصيرة العمر
يتعامل الخادم مع خمسة أدوار: مدير أعلى، ومدير، ومحرر، ومدير فريق، ومشاهد. كل مسار في الواجهة البرمجية محروس بطبقة صلاحيات تتحقق من الدور قبل التنفيذ، فلا يرى كل مستخدم إلا ما يسمح به دوره. ومدير الفريق الموثّق مثلًا يحرّر ملفات فريقه ولاعبيه.
والمصادقة بلا حالة: رمز وصول JWT قصير العمر، ومعه رمز تجديد مشفّر يُستبدل عند كل تجديد. الخادم لا يبحث عن جلسة مع كل طلب، والرمز المسروق ينتهي سريعًا. والنظام نفسه يخدم تطبيق الجوال ولوحة التحكم.
أكبر تحسّن في السرعة جاء من جهة التطبيق
أذكر هذا لأن نسبته إلى الخادم وحده ستكون غير دقيقة. أعاد محمد مجدي من جهة التطبيق بناء طريقة التكامل مع الواجهة البرمجية وتحويل بيانات JSON، فانخفض حجم البيانات المنقولة 65% وزمن استجابة الخادم 54%، وصارت الشاشات تُحمَّل أسرع على الشبكات البطيئة.
الدرس الذي خرجت به بصفتي مهندس الخادم أن السرعة كما يشعر بها المستخدم لا تُقاس على الخادم وحده. ما يُرسَل، وكيف يُقرأ في الجوال، جزء من الأداء. وحل ذلك أسهل حين يعمل مهندس التطبيق ومهندس الخادم في فريق واحد، فتُحل المشكلة في الطرف الذي تنتمي إليه.
ومن أرقام التطبيق أيضًا أن 74% من المستخدمين على iOS، وأن 90% من التسجيلات تتم بحساب Google أو Apple.
ما الذي أراقبه لو بنيت خادم نتائج مباشرة اليوم
هذه نقاط أنصح بها من يبني خادمًا مشابهًا. هي وصف لما يجب الانتباه إليه، لا سجل لما جرى في Escore:
- انقطاع الاتصال أمر عادي على الجوال. عميل Socket.IO يعيد الاتصال تلقائيًا بفواصل متزايدة، لكن ما بُثّ أثناء الانقطاع يضيع افتراضيًا، لأن المكتبة تضمن التسليم مرة واحدة على الأكثر (ضمانات التسليم). لذلك اطلب الحالة الحالية عبر REST بعد كل عودة، ثم أكمل بالتحديثات اللحظية.
- الغرف لا تبقى بعد الانقطاع تلقائيًا. ميزة استعادة حالة الاتصال تعيد الغرف والرسائل الفائتة بعد انقطاع قصير، والتوثيق نفسه يقول إنها لا تنجح دائمًا (استعادة حالة الاتصال). فأعد الانضمام إلى الغرف عند كل اتصال لم يُستعد.
- أرسل التغيير لا الكائن كله. تحديث النتيجة يكفيه معرّف المباراة والنتيجة الجديدة، لا ملف المباراة كاملًا.
- عند تشغيل أكثر من نسخة من الخادم لا ترى كل نسخة إلا اتصالاتها، فتحتاج إلى محوّل مثل Redis adapter كي يصل البث إلى الجميع، وإلى جلسات ثابتة (sticky sessions) إن بقي الاتصال الاحتياطي عبر HTTP مفعّلًا (استخدام عدة عقد).
- راقب حدود المزوّدين. لكل مزوّد بيانات حدود لعدد الطلبات، وفترات الاستعلام القابلة للضبط هي ما يسمح بالموازنة بين حداثة البيانات وهذه الحدود.
الجزء الصعب ليس WebSocket نفسه
الاتصال الدائم سطور قليلة في أي مكتبة. ما يأخذ الوقت هو ما حوله: فصل مصادر البيانات عن التطبيق، وحصر البث فيمن يحتاجه، وتحمّل شبكة تنقطع، وصلاحيات تُفحص على الخادم مع كل طلب.
تفاصيل المشروع كاملة في دراسة حالة Escore، وما نبنيه من هذا النوع في صفحة برمجة باك إند وواجهات API لحظية.
إن كان لديك تطبيق يحتاج إلى تحديثات لحظية، أرسل لنا وصفًا قصيرًا من هنا.
مشاركة
مقالات في الموضوع نفسه
| رقم | التاريخ | المقال | المواضيع | القراءة |
|---|---|---|---|---|
| 06 | دعم العربية RTL في Flutter: ما تعلّمته من تطبيق Escore ثنائي اللغة | قراءة في 8 دقائق | ||
| 01 | لوحة تحكم وتطبيق جوال على API واحد: لماذا بنيناها هكذا في Escore | قراءة في 8 دقائق |