164
مساراً في الواجهة البرمجية
المبيعات والمرتجعات والمخزون والمورّدون وتواريخ انتهاء الصلاحية والتقارير
PRJ-002 · منصّة · 2025 · قيد الاستخدام اليومي
نظام لإدارة الصيدليات يواصل البيع حين ينقطع الإنترنت. وعند عودة الاتصال يطابق كل عمليات الكاشير مع الخادم، فتُحتسب كل عملية مرّة واحدة فقط: لا تضيع بيعة ولا تتكرّر.
ما يمكن التحقّق منه، وما لا يمكن
هذا النظام يدير صيدلية فعلية كل يوم، والكود ملك العميل، لذلك لا يمكن لأحد أن يفحصه بنفسه كما يمكن مع منصّة العمليات الميدانية. المنشور هنا هو منطق القرارات وشكل النظام العام. وإن أردت أن ترى الآليات المشروحة أدناه عبر مشاركة الشاشة، فاطلب ذلك.
164
مساراً في الواجهة البرمجية
المبيعات والمرتجعات والمخزون والمورّدون وتواريخ انتهاء الصلاحية والتقارير
27
نموذجاً للبيانات
كلّها تتزامن عبر إضافة برمجية واحدة
11.6k
سطر برمجي
قيد الاستخدام اليومي
الحالة
في صيدلية تعمل فعلاً
المشكلة
لا تستطيع الصيدلية أن تتوقّف عن خدمة زبائنها لأن الإنترنت انقطع. ولا تحتمل أن تُسجَّل بيعة مرّتين، ولا أن يُظهر المخزون كمية سالبة لأن جهازَي كاشير باعا آخر علبة في اللحظة نفسها. والإنترنت في السوق الذي يخدمه هذا النظام غير مستقرّ إلى حدّ أن العمل دون اتصال هو الحالة المعتادة، لا الاستثناء.
يبدو المطلوب بسيطاً: أن يستمرّ العمل دون إنترنت. لكن معناه الفعلي أن جهاز الكاشير يصبح هو المرجع طوال فترة الانقطاع، وهي فترة لا تختار أنت متى تبدأ ولا كم تطول. وكل عملية حفظها الجهاز في أثنائها يجب أن تصل إلى الخادم وتُحتسب مرّة واحدة فقط عند عودة الاتصال.
مرّة واحدة على الأقل (At-least-once)
يحاسب الزبون مرّتين. يرسل الجهاز مجموعة العمليات، ويضيع ردّ الخادم الذي يؤكّد استلامها، فيعيد الجهاز إرسالها، ويدفع الزبون ثمن العلبة الواحدة مرّتين.
مرّة واحدة على الأكثر (At-most-once)
تضيع بيعة. سجّلها الكاشير ولم تصل إلى الخادم أبداً، ولن يلاحظ أحد ذلك إلا عند جرد المخزون.
مسار نجاح واحد لكل الحالات
العملية التي تصل من الجهاز قد تكون جديدة، أو سبق تسجيلها، أو تتعارض مع تغيير حدث على الخادم أثناء انقطاع الجهاز. وكل حالة من هذه نتيجة مختلفة فعلاً، والخلط بين أيّ اثنتين منها يُنتج خللاً لن تكتشفه إلا في جرد المخزون بعد أسابيع.
اقرأ المخزون ثم عدّله
جهازا كاشير يبيعان آخر علبة، فيقرأ كلٌّ منهما أن الباقي علبة واحدة، وتنجح البيعتان. وهكذا يصبح بيع أكثر ممّا في المخزون أمراً نادراً لا مستحيلاً، والنادر ليس كالمستحيل.
ثق بجهاز الكاشير
الجهاز الذي يعمل دون اتصال يجب أن يُعامَل كجهاز غير موثوق. ومن دون قائمة محدّدة بالحقول المسموح تعديلها، يستطيع جهاز جرى العبث به أن يكتب إجمالي الإيرادات أو سعر منتج مباشرة.
الحلّ المعتمد
بنيتُ المنصّة كلّها على افتراض أن جهاز الكاشير يعمل منفصلاً عن الخادم، ثم يُزامن بياناته لاحقاً. كل عملية تحمل رقماً تعريفياً فريداً يولّده الجهاز نفسه، فإذا وصلت مجموعة العمليات نفسها مرّة ثانية عرفها الخادم ولم يطبّقها من جديد. وخصم الكمية من المخزون يتمّ بأمر واحد مشروط في قاعدة البيانات، لا يُنفَّذ إلا إذا كانت الكمية متوفّرة، بدل أن يقرأ النظام الكمية أولاً ثم يكتب القيمة الجديدة. وبهذا يصبح بيع أكثر ممّا في المخزون مستحيلاً بحكم التصميم، لا مجرّد احتمال ضعيف.
والتعديلات التي تتمّ دون اتصال تحمل رقم النسخة التي عدّلها الجهاز، فيعرف الخادم إن كانت البيانات قد تغيّرت في غيابه (Optimistic concurrency). ولا يقبل الخادم منها إلا الحقول الموجودة في قائمة محدّدة مسبقاً، فلا يستطيع جهاز جرى العبث به أن يكتب إجمالي الإيرادات. وإضافة برمجية واحدة للمزامنة (Plugin) تجعل 27 نموذج بيانات قابلة للمزامنة، دون الحاجة إلى تعديل 27 ملفاً.
بنية النظام
النظام مصمَّم ليعمل دون إنترنت أولاً، ثم يطابق عملياته مع الخادم بحيث تُحتسب كل عملية مرّة واحدة فقط (Exactly-once). كل عملية تحمل رقماً تعريفياً يولّده الجهاز، فتُنفَّذ مرّة واحدة فقط مهما تكرّر إرسالها. وشرط توفّر المخزون تفرضه قاعدة البيانات نفسها، لا منطق التطبيق. وحين يقع تعارض بين نسختين من البيانات، يُعلَّم للمراجعة بدل أن يُرفض كخطأ. وإضافة مزامنة مشتركة تجعل كل نماذج البيانات تتزامن بالقواعد نفسها.
التعارض معلومة، لا خطأ: شخصان فعل كلٌّ منهما شيئاً معقولاً، والنظام لا يستطيع أن يقرّر أيّهما أولى دون أن يفهم ظروف العمل. وتعليم التعارض للمراجعة يسمح لبقية العمليات بأن تمضي، ويضع القرار بيد شخص يعرف الصيدلية.
ومع كل قرار ثمنه
القرار الذي لا يُذكر ثمنه مجرّد تفضيل. هذه القرارات الأربعة هي التي حدّدت طريقة مطابقة العمليات، ولكلٍّ منها ثمن.
01
السبب
أمر الخصم نفسه يتضمّن شرط توفّر الكمية، فترفض قاعدة البيانات العملية إن لم يكن المخزون كافياً. وبهذا لا توجد أي فجوة بين التحقّق من الكمية وخصمها.
الثمن
بدل أن يفحص الكود الكمية أولاً بطريقة واضحة ومريحة، صار عليه أن يستنتج الرفض من أن قاعدة البيانات لم تعدّل أي سجلّ. وهذا أصعب على من يقرأ الكود، لكنه الصحيح فعلاً حين تتزامن عمليات البيع. ومن دونه، يبيع جهازا كاشير آخر علبة في اللحظة نفسها، فيقرأ كلٌّ منهما أن الباقي علبة واحدة، وتنجح البيعتان.
02
السبب
التعارض أثناء مطابقة العمليات معلومة، لا خطأ. وتعليمه للمراجعة يسمح لبقية العمليات بأن تمضي، ويضع القرار أمام شخص يفهم ظروف العمل.
الثمن
لا بدّ أن يراجع أحدٌ التعارضات المعلَّمة، أي أن حلّها إجراء يقوم به إنسان، لا تسوية يجريها النظام بصمت. وهذا هو الثمن الصادق لنظام يتعامل مع المال.
03
السبب
الجهاز الذي يعمل دون اتصال يجب أن يُعامَل كجهاز غير موثوق. ومن دون هذه القائمة، يستطيع جهاز جرى العبث به أن يكتب إجمالي الإيرادات أو سعر منتج مباشرة.
الثمن
أي حقل جديد يُراد السماح بتعديله يجب أن يُضاف إلى القائمة عن قصد. وهذه عقبة مقصودة، وُضعت تحديداً كي لا يمكن تجاوزها.
04
السبب
إذا أعاد الزبون صنفاً واحداً من فاتورة فيها ثلاثة أصناف وعليها خصم، فيجب إلغاء الجزء من الخصم الذي يخصّ ذلك الصنف بالتناسب. والنظام يحسب التعديل كاملاً أولاً ثم يطبّقه، فلا يمكن لعطل في منتصف العملية أن يترك الفاتورة معدّلة نصف تعديل.
الثمن
يحتاج ذلك إلى حفظ حسابات وسيطة أكثر ممّا لو عُدّلت الأصناف واحداً تلو الآخر، والمقابل عملية إمّا أن تكتمل كلّها أو لا يحدث منها شيء.
حدود معروفة
لا يمكن فحصه بشكل مستقل
الكود ملك العميل والنسخة العاملة تخصّه، فعلى عكس منصّة العمليات الميدانية لا يوجد مستودع كود تقرؤه ولا نسخة تجرّبها بنفسك. الأرقام في هذه الصفحة أذكرها أنا، وعليك أن تأخذها على ثقة، وهذا بالضبط ما يحاول هذا الموقع تجنّبه في كل مكان آخر.
التعارضات يراجعها إنسان، لا يحلّها النظام
لا بدّ أن يراجع أحدٌ التعارضات المعلَّمة. وهذا هو الثمن الصادق لنظام يتعامل مع المال، ومعناه أن دقّة مطابقة الحسابات تعتمد على أن تواظب الصيدلية على مراجعة قائمة التعارضات أولاً بأول.
لم يخضع لاختبار ضغط حتى الانهيار
في الصيدلية بضعة أجهزة كاشير فقط، لذلك لم يكن هناك داعٍ لاختبار عودة عدد كبير من الأجهزة إلى الاتصال في اللحظة نفسها، كما فعلتُ مع منصّة العمليات الميدانية. ولا يوجد رقم منشور لأقصى ما يتحمّله هذا النظام، لأنني لم أكتشفه بعد.