تطبيقات ويب قائمة على الأحداث تعمل بمبدأ «المحلي ثانيًا»
أنت تقود سيارتك من ألمانيا إلى إيطاليا لقضاء عطلة عائلية، في رحلة تزيد على 1500 كم، فتخطط لمبيت ليلة في النمسا. وبعد يوم كامل خلف المقود تصل إلى الفندق، متشوقًا لتمديد ساقيك وترك الأطفال يركضون قليلًا ورؤية ما تقدمه المدينة النمساوية.
أنت تقود سيارتك من ألمانيا إلى إيطاليا لقضاء عطلة عائلية، في رحلة تزيد على 1500 كم، فتخطط لمبيت ليلة في النمسا. وبعد يوم كامل خلف المقود تصل إلى الفندق، متشوقًا لتمديد ساقيك وترك الأطفال يركضون قليلًا ورؤية ما تقدمه المدينة النمساوية.
سعيدًا بانتهاء القيادة لهذا اليوم، تدخل الفندق وتتجه إلى مكتب الاستقبال. وهنا تبدأ المتاعب! الإنترنت منقطع، فلا يستطيعون تسجيل دخولك. تقول: “انظروا، كل شيء معي هنا، الحجز والتأكيد، ألا يمكنكم إعطائي مفتاح الغرفة الآن وإكمال تسجيل الدخول لاحقًا؟”. يجيبون: “آسفون، الطريقة الوحيدة للحصول على مفتاح هي تسجيل الدخول عبر النظام”. والنظام، بطبيعة الحال، تطبيق ويب عادي يعمل في متصفح.
يُطلب منك الانتظار، فتنتظر؛ تمر 10 دقائق، ثم 20 – والأطفال بدأوا يخرّبون الردهة – وأخيرًا، بعد 30 دقيقة، تعود الشبكة ويتم تسجيل الدخول. قد تقول إنها 30 دقيقة فقط. لكنك، من ناحية أخرى، تبرمج منذ كان عمرك نحو 12 عامًا، ولا تتوقف عن سؤال نفسك – هل علينا حقًا أن نتحمل تقنية كهذه؟ ألا يمكن أن تكون أفضل؟
بالطبع يمكن! هذا ببساطة تصميم نظام رديء (وإن كان على الأرجح رخيصًا) يقدّم تجربة مستخدم “دون المستوى الأمثل” – على سبيل التلطف – كلما واجهت الشبكة مشكلات.
Local-first؟
منذ وقت طويل وأنا أحب نهج local-first. إنه مليء بأفكار تبدو “صائبة” بكل بساطة: بياناتك ملك لك؛ والخادم المركزي وسيلة راحة لا شرط؛ والتطبيق يواصل العمل رغم الانقطاعات. فخطر لي – هل يمكن أن يكون هذا هو الجواب لمشكلة تسجيل الدخول في الفندق؟
وبعد التفكير في الأمر خلال رحلة القيادة الطويلة في اليوم التالي، خلصت إلى أن تطبيق local-first كاملًا سيكون على الأرجح مبالغة في حل مشكلة كهذه. فالأدوات والتقنيات موجودة، مثل CRDTs وautomerge، لكنها تتألق في مجالات مثل التحرير التعاوني وتطبيقات الجوال ذات الاتصال المتقطع.
غير أننا نستطيع استعارة بعض تلك الأفكار لبناء حل “محلي ثانيًا” (local-second). في العادة سيعمل النظام بالطريقة الكلاسيكية المركزية بين العميل والخادم، أي كتطبيق ويب + واجهة HTTP API قياسية تمامًا.
أما عند انقطاع الشبكة فسيتحول إلى وضع عمل دون اتصال بوظائف مخفّضة. تبقى الخدمات الأساسية متاحة – وتُخزَّن البيانات مؤقتًا إلى أن يعود الاتصال.
والوظيفة الأساسية هنا هي تسجيل دخول النزلاء ليستريحوا بعد رحلة طويلة؛ وقد تتعذر العمليات الأخرى.
إثبات المفهوم القائم على الأحداث
بمساعدة مساعدي البرمجة بالذكاء الاصطناعي (Claude Code، إن كنتم تتساءلون)، بنيت تطبيق إثبات مفهوم (PoC) ينفّذ هيكل تطبيق ويب كهذا يعمل بمبدأ «المحلي ثانيًا» مع خلفيته (backend). لكن قبل أن نصل إلى الشيفرة، لا بد من اتخاذ بعض القرارات بشأن التقنيات والبنية المعمارية نفسها.
في تطبيق الويب التقليدي، يكون كل المنطق مضبوطًا ومركزيًا بالكامل على الخادم. أما هنا، فبالإضافة إلى منطق الخادم هذا، لدينا أحيانًا (أثناء فترات انقطاع الاتصال) تغييرات في البيانات تُجرى كليًا على العميل ولا تُزامَن إلا لاحقًا.
ولتسهيل التفكير في إعداد كهذا، اخترت البناء على الأحداث. فالخلفية قائمة على الأحداث: الأحداث هي المصدر الأساسي للحقيقة، وهي محفوظة بصورة دائمة، مما يمنحنا سجل تدقيق وطريقة لبناء إسقاطات (projections) للاستعلامات السريعة.
كثيرًا ما يُربط event sourcing بقواعد بيانات NoSQL ونمط CQRS، ويميل إلى التعقيد بسبب الاتساق النهائي. لكن ذلك ليس ضرورة؛ إذ يمكن تنفيذ event sourcing فوق قاعدة بيانات علائقية، مما يمنحك مزايا المعاملات الذرية.
هذا هو الطريق الذي اخترته: event sourcing معاملاتي على PostgreSQL، مع إسقاطات متسقة دائمًا لأنها تُحدَّث في المعاملة نفسها التي يُدرَج فيها الحدث.
في وضع الاتصال، يتصرف التطبيق كتطبيق ويب CRUD عادي تمامًا وغير مثير. وكمستخدم لواجهة HTTP API الخلفية، لا ترى الأحداث أبدًا. هناك نقاط نهاية /checkin و/checkout وPOST /bookings (إنشاء حجز). وداخليًا تنتج هذه أحداثًا وتحدّث الإسقاطات المقابلة. وتُجلب الحجوزات الحالية بطلب GET /bookings عادي، يستعلم جدولًا مبنيًا كإسقاط للأحداث. فلماذا نكلّف أنفسنا إذن عناء الأحداث أصلًا؟

لأنها تبسّط البنية المعمارية وطريقة تفكيرنا في النظام تبسيطًا جذريًا حين يتولى وضع عدم الاتصال زمام الأمور. فأثناء العمل بوضع متدهور، يجب أن نتمكن من تسجيل دخول النزلاء محليًا، مخزّنين التغييرات (مثل تعيين الغرفة) مؤقتًا. وبمجرد عودة النظام إلى الاتصال، عليه إرسال كل تغيير من هذه التغييرات إلى الخلفية، التي يجب أن تطبّقها على قاعدة البيانات. ويجب على الخلفية (بشرط أن يكون العميل موثَّقًا كما ينبغي) أن تقبل مثل هذه الطلبات دائمًا: فالأحداث حقائق غير قابلة للتغيير؛ وتسجيل الدخول قد تم بالفعل.
وهكذا تُجمَع عمليات تسجيل الدخول دون اتصال كأحداث في جانب العميل. وعندما يعود النظام إلى الاتصال تُرسَل واحدًا تلو الآخر إلى الخلفية. وهناك يُترجَم كل حدث من جانب العميل إلى حدث في جانب الخادم ويُعالَج تمامًا كأي حدث يُنتَج “بصورة عادية”.

المنطق محتوى بإحكام في معالجات الأحداث، التي تعمل سواء جاء الحدث من استدعاء HTTP API في وضع الاتصال أو من آلية اللحاق في وضع عدم الاتصال. وفوق ذلك، يتشارك العميل والخادم المفهوم نفسه للأحداث بوصفها حقائق وقعت في النظام، مما يوفر إطارًا متسقًا للتفكير في التطبيق.
التفاصيل التقنية ومزامنة بيانات الخلفية مع الواجهة الأمامية
لم نختر التقنيات بعد! بالنسبة للواجهة الأمامية في PoC، اخترت React+Typescript. أما للخلفية فاستخدمت Rust+Axum+sqlx (لأن – لِمَ لا؟). أي لغة خلفية قادرة على التخاطب مع PostgreSQL ستصلح، وRust سريعة وقوية في فحص الأنواع، وهذا يناسب ذوقي كثيرًا.
وكمهمة جانبية، أردت معرفة كيف يتعامل Claude Code عند طلب تنفيذ نمط خلفي غير شائع (event sourcing المعاملاتي)، مسترشدًا بالمقالات المذكورة أعلاه، بلغة لم يُدرَّب عليها أساسًا وليست الخيار المعتاد لخلفيات CRUD. والنتيجة؟ سيظهر تقرير كامل في This Month We AIed الشهر المقبل، لكن إليكم ملخصًا مسبقًا: أبلى بلاءً حسنًا، وشيفرة الخلفية كلها تقريبًا مولَّدة بالذكاء الاصطناعي، وإن احتاجت إلى إشراف دقيق.
هناك تطبيقان للواجهة الأمامية: أحدهما يتيح للنزلاء حجز الفنادق، والآخر يتيح لموظفي مكتب الاستقبال تسجيل دخول النزلاء وخروجهم. والتنفيذ مختصر جدًا، أقرب إلى هيكل؛ وتنقصه ميزات أساسية مثل أي نوع من الأمان.
وهناك وظيفة أخرى لم تُعالَج بعد: إبقاء حالة الواجهة الأمامية متزامنة مع حالة الخلفية. فموظف الاستقبال يُبقي التطبيق مفتوحًا عادةً طوال الوقت، لذا يجب مزامنة حالة الخلفية مع الواجهة الأمامية باستمرار.
وكالعادة، هناك عدة طرق معقولة لفعل ذلك. فقد تفتح الواجهة الأمامية مثلًا اتصال WebSocket بالخلفية، وتتلقى تدفقًا من الأحداث (ليست بالضرورة الأحداث نفسها التي تحفظها الخلفية، بل تحويلًا لها) وتطبّقها محليًا. أو قد تستعلم بصورة دورية عن حجوزات اليوم. أو …
في الواقع توجد بضعة حلول للواجهة الأمامية مصممة خصيصًا لتطبيقات local-first، فبدأت بحثي منها. أحدها RxDB، وهي قاعدة بيانات JavaScript من نوع local-first بوظائف لمزامنة البيانات مع الخلفية. إنها مغرية، لكن نظرة أدق تُظهر أنها موجهة أكثر لتطبيقات local-first “الكاملة” وليست بالضرورة مثالية لنهجنا «المحلي ثانيًا». ففي RxDB يدير العميل البيانات في الغالب، وتُحَل التعارضات أيضًا على العميل قبل أن يقبل الخادم الكتابات. تقنية آسرة، لكنها ببساطة ليست الملائمة.
خيار آخر هو ElectricSQL، الذي يتيح لك مزامنة استعلام PostgreSQL باستمرار إلى تطبيق JavaScript. ويعمل كتطبيق منفصل بجانب خلفيتك، لكن لا يُفترض أن يتخاطب معه العملاء مباشرة. بل ينبغي أن تعمل خلفيتك كوسيط (proxy)، فتتولى المصادقة والتفويض قبل تمرير الاستعلام إلى نسخة Electric.
وفي الواجهة الأمامية يستخدم طلبات استعلام طويلة (long-polling) ليواصل استقبال تحديثات البيانات. وهذا بالضبط ما نريده!
لا تتضمن Electric آلية مدمجة لمزامنة الكتابات المحلية مع الخلفية، لكنها تصف عدة أنماط يمكنك استخدامها.
يشبه نهجنا القائم على الأحداث “الحالة المتفائلة الدائمة المشتركة”، لكنه يقدّم إجابة أعم عن سؤال كيفية تخزين الكتابات المحلية. فهو يربط أحداث جانب العميل بمفاهيم جانب الخادم بصورة متسقة ويحافظ على مستوى تجريد عالٍ، بدلًا من العمل على مستوى جمع عمليات insert/update منخفضة المستوى.
ElectricSQL عمليًا
كيف يستخدم PoC ElectricSQL؟ المفهوم المحوري في Electric هو shape، أي استعلام يُبقى متزامنًا مع الواجهة الأمامية. يعرّض تطبيق Rust الخلفي نقطة النهاية /hotels/{id}/bookings/shape، التي تمرر استعلامًا محددًا عبر وسيط إلى نسخة Electric العاملة محليًا. ونتيجة لذلك لا يستطيع العميل بث استعلامات عشوائية، بل استعلامًا ثابتًا واحدًا فقط.
وهذا الاستعلام يقرأ هنا البيانات من إسقاط bookings، الذي يُحدَّث معاملاتيًا كلما عولجت أحداث متعلقة بالحجز. وفي كل مرة تتغير فيها حجوزات اليوم الحالي، يحصل كل عميل متصل على البيانات فورًا، ثم تُعرض عبر تحديثات React العادية.

العيب أن استخدام Electric بالطريقة التي يعتمدها PoC يُدخل فجوة اتساق نهائي صغيرة. خذ تسجيل خروج نزيل: تعالج الخلفية الطلب أولًا، فتولّد حدثًا وتحدّث إسقاط الحجوزات. عند هذه النقطة يكتمل الطلب، وكذلك التفاعل من جانب العميل.
من الجدير بالذكر أن فجوة الاتساق النهائي في معماريات مثل CQRS تقع عادةً في جانب الخادم. أما هنا فالاتساق النهائي في جانب العميل. وقد يهم هذا الفرق أو لا يهم. فهو ليس مشكلة في هذا التطبيق، لكنه قد يكون كذلك في غيره، فضعه في اعتبارك.
ثم تلاحظ Electric التغيير وتدفع التعديلات إلى العملاء، مما يحدّث العرض. وفي العادة يبدو التحديث فوريًا، لكن قد يكون هناك تأخير قصير بين اكتمال طلب HTTP API ووصول التحديث.
وفي الجانب الإيجابي، عندما تُزامَن الأحداث المسجلة دون اتصال مع الخلفية (بمجرد عودتها إلى الاتصال)، لا تحتاج الواجهة الأمامية إلى فعل أي شيء – إذ يتحدث العرض ببساطة عند وصول بيانات جديدة من shape الحجوزات. وهذا يجعل منطق المزامنة أبسط كثيرًا.
دعم العمل دون اتصال
تطبيق الويب الذي يعمل بمبدأ «المحلي ثانيًا» شبه جاهز، لكن ينقصه تفصيل واحد. كل شيء يعمل جيدًا عند انقطاع الإنترنت: يتحول تطبيق الويب إلى وضع متدهور لا يسمح إلا بتسجيل الدخول دون اتصال إلى أن يعود الاتصال.
لكن ماذا يحدث إذا ضغط موظف الاستقبال على تحديث الصفحة وأُعيد تحميل التطبيق؟ الضغط على التحديث يكاد يكون رد فعل منعكسًا عندما يسوء شيء. فبدلًا من تطبيق الويب الخاص بنا، سيرى شاشة “تعذّر الوصول إلى هذا الموقع”.
والحل هو بناء تطبيق ويب تقدمي (Progressive Web App)، واختصاره PWA. هذا المعيار مدعوم الآن على نطاق واسع ويتيح تخزين الموارد ونتائج الاستعلامات مؤقتًا لتكون متاحة دون اتصال. وهذا بالضبط ما نحتاجه!
تحويل تطبيقنا إلى PWA سهل نسبيًا: يتلخص في تثبيت إضافة vite-pwa وتوفير بعض الإعدادات (مثل … أيقونة التطبيق، وهي إلزامية؛ ودونها يفشل تطبيق PWA “بصمت”، أي دون الإبلاغ عن أي أخطاء). علينا تحديد الموارد التي ستُخزَّن مؤقتًا للاستخدام دون اتصال (هنا، كل ملفات html وcss وjs). ويمكنك اختيار ما إذا كانت هذه الموارد تعتمد الشبكة أولًا (network-first)، حيث يبحث المتصفح دائمًا عن نسخ أحدث قبل الرجوع إلى المخزنة مؤقتًا، أو المحلي أولًا (local-first)، حيث يقدّم المتصفح دائمًا الموارد المخزنة محليًا لتحميل أسرع، على حساب صعوبة أكبر في الترقية. وفي تطبيق الفندق التجريبي كل الموارد من نوع الشبكة أولًا.
علينا أيضًا تحديد نتائج استعلامات الخلفية التي ينبغي تخزينها مؤقتًا. وهنا هي الاستعلامات التي تعيد قائمة الفنادق (التي تُعرض للموظف عند بدء استخدام التطبيق) وتفاصيل الفندق المحدد (الاسم وعدد الغرف).
أما تخزين نتائج shape الحجوزات في Electric مؤقتًا فـلن ينجح. فهي تراكمية، وما يهمنا هو النتيجة المجمّعة (نتائج الاستعلام الأولية مع التحديثات)، لا آخر بيانات وصلت فقط. ولهذا السبب علينا تخزين مخرجات خطاف React الخاص بـ Electric (وهي دائمًا أحدث بيانات مجمّعة) في التخزين المحلي للمتصفح.
لا خادم مركزي
بناء تطبيق «محلي ثانيًا» كهذا (يعمل عادةً كنظام تقليدي بين عميل وخادم ويرجع إلى وضع محلي فقط عند عدم الاتصال) يعني أخذ بعض الأمور في الحسبان، لأنه لم يعد هناك خادم مركزي يتحقق من كل تغيير في البيانات وينسّقه.
فقد يحدث مثلًا أن يُسجَّل دخول شخصين إلى الغرفة نفسها. ولا بد من معالجة موقف كهذا بطريقة ما. لا ينفّذ PoC ذلك، لكن ينبغي للخلفية قبول طلبات تسجيل الدخول المتعارضة هذه. ثم ينبغي أن يرى الموظفون إشارة مرئية إلى التعارض، فيحلّونه يدويًا، ويتمكنون من تسجيل دخول النزيل مجددًا إلى غرفة مختلفة.
وهذا أيضًا نابع من النهج القائم على الأحداث: فالحدث، متى وُجد، يجب التعامل معه كحقيقة؛ ولا جدال معه. لقد حدث بالفعل، وكل ما يمكنك فعله هو محاولة معالجة الموقف (ربما بإنشاء أحداث تعويضية).
وماذا عن وجود عدة مكاتب لتسجيل الدخول؟ في الوضع المتدهور، إما أن يعمل واحد منها فقط، أو يحتاج الموظفون إلى الاتفاق يدويًا على الغرف التي يعيّنونها لنزلائهم.
ومن المثالي أن تتواصل تطبيقات الويب المحلية فيما بينها عبر الشبكة المحلية. لكن نموذج أمان المتصفح يجعل ذلك مستحيلًا. WebRTC أحد الأمور التي يمكن تجربتها: فهي توفر اتصالًا محليًا، لكنها لا تزال تحتاج إلى خادم إشارات (signalling) مركزي لتنسيق الاتصالات الأولية. وثمة احتمال آخر هو تشغيل خادم محلي خارج المتصفح يتخاطب مع العملاء المحليين الآخرين ويحتفظ برؤية مشتركة للأحداث المسجلة دون اتصال.
الخلاصة المختصرة (TL;DR)
انقطاعات الشبكة ببساطة جزء من الحياة، سواء سببتها أعطال الخدمات أو مشكلات محلية لدى مزودي الإنترنت. قد لا يكون تسجيل الدخول إلى الفنادق حرجًا بما يكفي ليبرر تعقيد النظام الإضافي، لكن مع ذلك، ألا ينبغي أن تسبق تجربة المستخدم القيود التقنية لنظام الفندق؟
وعلى أي حال، يهدف تطبيق «المحلي ثانيًا» إلى الجمع بين أمرين: راحة قاعدة بيانات وخادم مركزيين ينسّقان منطق النظام ويمنعان التعارضات ويبقيان الجميع على اطلاع؛ وإبقاء الوظائف الأساسية متاحة دون اتصال عبر “وضع متدهور” لا يعمل فيه إلا المنطق الحرج على جانب العميل فقط ويُزامَن لاحقًا.
إن بناء منطق الخادم والعميل معًا حول الأحداث يوفر إطارًا متسقًا لفهم النظام والتفكير فيه. فالأحداث حقائق غير قابلة للتغيير يجب أن يعالجها النظام دائمًا. ويمنحك event sourcing المعاملاتي مزايا event sourcing مع راحة تشغيل استعلامات SQL على إسقاطات متسقة دائمًا. واستخدام الأحداث في كل مكان يتيح مزامنة الكتابات المحلية مع الخادم مع الحفاظ على مستوى تجريد عالٍ.
وأخيرًا، تقدّم ElectricSQL طريقة نظيفة لمزامنة تغييرات قاعدة بيانات الخلفية مع الواجهة الأمامية، سواء أُجريت التغييرات أثناء الاتصال أو أثناء اللحاق بعد فترة انقطاع.
في وضع الاتصال يعيّن الخادم الغرف. وفي وضع عدم الاتصال تظهر شاشة لاختيار الغرفة يدويًا؛ وبمجرد عودة الاتصال تُزامَن التغييرات مع النسخ الأخرى من تطبيق مكتب الاستقبال.
هل صادفتم مشكلات مشابهة في تطبيقات عملتم عليها؟ وكيف تعاملتم معها؟