12
نموذجاً للبيانات
المال معزول في سجلّات قيود المحفظة والتأمين
PRJ-003 · منصّة · 2025 · جُرّبت ميدانياً على أجهزة حقيقية
استأجر سكوتراً أو دراجة كهربائية من التطبيق: امسح رمز QR فيُفتح قفل المركبة عبر شبكة الهاتف المحمول، ثم اركب، واركنها في منطقة مسموحة، وادفع بالدقيقة من محفظة مشحونة مسبقاً.
ما يمكن التحقّق منه، وما لا يمكن
لا أذكر اسم العميل، والكود ملكه، فلا يوجد مستودع كود تقرؤه ولا نسخة تفتح منها قفل سكوتر. ما يمكن فحصه هو منطق القرارات: طريقة ربط قنوات الاتصال الثلاث، ومشكلة راكبَين يحاولان حجز المركبة نفسها في اللحظة ذاتها، وكلاهما مشروح بالكامل. أما العمل على بروتوكول الأجهزة فتمّ بالتنسيق المباشر مع مهندسي المصنّع.
3
بروتوكولات اتصال
TCP وHTTP وWebSocket في مسار واحد
12
نموذجاً للبيانات
المال معزول في سجلّات قيود المحفظة والتأمين
AR / EN / KU
اللغات
تطبيق الراكب بثلاث لغات
اختبار ميداني
التحقّق
مركبات حقيقية وأقفال حقيقية
المشكلة
أراد مشغّل الأسطول أن يجد الراكب مركبة على خريطة تُظهر المركبات لحظياً، وأن يفتح قفلها فعلياً من هاتفه، وأن يدفع بالدقيقة. وكانت الأقفال قد اشتُريت مسبقاً من مصنّع في الخارج، فكان على النظام أن يتواصل معها ببروتوكول الاتصال الذي تعمل به، أيّاً كان. ولا يوجد حلّ جاهز يدعم وسائل الدفع المحلية، وواجهة بثلاث لغات، وهذه الأجهزة بالذات.
اشتُريت الأجهزة قبل انضمامي، وهذا هو الوضع المعتاد. ولفهم الإشارات التي تتبادلها مع النظام، نسّقتُ مباشرة مع مهندسي المصنّع رغم فارق التوقيت، حتى حدّدنا بالضبط ما تعنيه أوامرهم والبيانات التي ترسلها الأقفال، قبل أن يصبح ربط أيّ منها بالنظام ممكناً.
ثلاث خدمات منفصلة وناقل رسائل
أجزاء كثيرة أكثر ممّا يحتاجه أسطول بهذا الحجم، وتضيف تأخيراً بين لحظة إبلاغ القفل عن موقعه ولحظة رؤية المشغّل للمركبة تتحرّك.
معاملة قاعدة بيانات للحجز
أن يمسح راكبان رمز QR نفسه في اللحظة ذاتها هو المشكلة الأساسية في هذا المجال، ولا يمكن إبقاء معاملة قاعدة البيانات مفتوحة طوال انتظار ردّ قفل حقيقي عبر شبكة الهاتف المحمول.
افترض أن القفل سيستجيب
إذا فشل القفل في الفتح بعد أن سُجّل الحجز في قاعدة البيانات، يبقى السكوتر مسجّلاً «قيد الاستخدام» ولا أحد يركبه.
اقرأ السعر عند إصدار الفاتورة
لو غيّر المشغّل سعر الدقيقة بعد الظهر، لتغيّر بأثر رجعي سعر كل رحلة لم تنتهِ بعد، ولكان الراكب محقّاً في الاعتراض.
الحلّ المعتمد
البيانات منظّمة في اثنتي عشرة مجموعة حول ثلاثة محاور أساسية: المستخدم والرحلة والمركبة، والمال معزول في سجلّات قيود مالية خاصة بالمحفظة والتأمين. والجزء الأهمّ هو طبقة الاتصال: الأقفال تتواصل ببروتوكول خاص بالمصنّع يرسل البيانات بصيغة ثنائية (Binary) عبر TCP مباشرة، وتطبيق الراكب يتواصل عبر HTTP، ولوحة تحكّم المشغّل عبر WebSocket. بنيتُ مساراً واحداً يستقبل القنوات الثلاث ويوصلها إلى منطق عمل واحد مشترك، فحين يرسل قفلٌ تحديثاً عبر TCP تتغيّر حالة المركبة، ويظهر التغيير على الخريطة اللحظية في اللحظة نفسها.
وحدود المناطق الجغرافية (Geofences) مرسومة كمضلّعات GeoJSON، ويفحصها الخادم مع كل تحديث يرسله القفل. لذلك تُطبَّق قواعد الركن بناءً على موقع المركبة كما يعرفه الأسطول، لا كما يقوله هاتف الراكب.
بنية النظام
ثلاثة بروتوكولات اتصال في عملية تشغيل واحدة على الخادم: TCP مباشر لبيانات الأقفال الذكية وأوامرها، وREST لتطبيق الراكب، وWebSocket للوحة تحكّم المشغّل، وكلّها تمرّ عبر منطق عمل واحد مشترك. وحالة المركبة هي المرجع الوحيد الذي تقرأ منه القنوات الثلاث وتكتب فيه.
أطول ما استغرقه العمل لم يكن البروتوكول، بل تقبّل فكرة أن الجهاز المادي قد يخالف ما تقوله قاعدة البيانات، وأن هذا مسموح. لذلك يجب أن يكون حجز المركبة قابلاً للإلغاء، ويجب أن يكون هذا الإلغاء مساراً أساسياً مصمَّماً بعناية، لا شيئاً مدفوناً في كود معالجة الأخطاء.
ومع كل قرار ثمنه
القرارات الثلاثة كلّها تتعلّق باللحظة نفسها: اللحظة التي يجب أن يتّفق فيها سجلّ في قاعدة البيانات وسكوتر حقيقي على من يركبه.
01
السبب
أن يمسح راكبان رمز QR نفسه في اللحظة ذاتها هو المشكلة الأساسية في هذا المجال. والتحديث المشروط يجعل التحقّق من أن المركبة متاحة وحجزها خطوة واحدة لا تتجزّأ، لأن شرط «المركبة متاحة» جزء من أمر التحديث نفسه، وهو ما يمنع الحجز الثاني.
الثمن
من دون معاملة قاعدة بيانات، يحتاج فتح القفل الذي يأتي بعد الحجز إلى خطوة تراجع صريحة تلغي الحجز إن فشل الفتح. ومن دون شرط الحالة في أمر التحديث، يجتاز الطلبان التحقّق، ويُحاسَب راكبان على سكوتر واحد.
02
السبب
الحجز يُسجَّل في قاعدة البيانات قبل أن يُفتح القفل فعلياً، فإذا فشل القفل في الفتح بقيت المركبة مسجّلة «قيد الاستخدام» ولا أحد يركبها. لذلك يلغي النظام الحجز عند الفشل، فتبقى المركبة متاحة للتأجير.
الثمن
تبقى فجوة زمنية ضيّقة قد يُفتح فيها القفل فعلاً بينما يضيع تأكيد الفتح قبل أن يصل إلى الخادم. يعالجها المشغّل من جهته، بدل التظاهر بأنها لا تحدث.
03
السبب
عند بدء الرحلة تُحفظ معها نسخة من سعر الدقيقة ورسم فتح القفل، ولا يعود النظام إلى قراءتهما بعد ذلك. فإذا غيّر المشغّل الأسعار، لا يتغيّر سعر رحلة بدأت بالفعل.
الثمن
السعر مكرّر في سجلّ كل رحلة بدل أن يُحفظ في مكان واحد (Denormalised)، وهذا هو الخيار الصحيح حين يكون البديل خلافات على الفواتير.
حدود معروفة
ضياع تأكيد الفتح بعد نجاحه
تبقى فجوة زمنية ضيّقة قد يُفتح فيها القفل فعلاً بينما يضيع تأكيد الفتح قبل أن يصل إلى الخادم. يعالجها المشغّل من جهته، بدل التظاهر بأنها لا تحدث.
السعر مكرّر في كل رحلة
كل رحلة تحمل نسختها الخاصة من سعر الدقيقة ورسم فتح القفل. وهذا هو الخيار الصحيح لتجنّب الخلافات على الفواتير، لكنه يعني أن تصحيح خطأ في الأسعار لا يمكن تطبيقه على الرحلات الجارية.
عملية واحدة لثلاث قنوات اتصال
استقبال اتصالات TCP وHTTP وWebSocket في عملية تشغيل واحدة هو الخيار الصحيح لأسطول بهذا الحجم، وهو أول ما يجب إعادة النظر فيه إن كبر الأسطول أكثر من ذلك. وعزل منطق العمل في طبقة مستقلّة هو ما سيجعل تقسيم النظام حينها ممكناً بجهد معقول.