بحث · Experience report · 2026
كيف يواصل سوبرماركت بأربعة صناديق البيع عند انقطاع الإنترنت والكهرباء — والأعطال الميدانية العشرون التي شكّلت تصميمه.
Selling Through the Outage: An Experience Report on an Offline-First, Exactly-Once Supermarket Point-of-Sale in Duhok, Kurdistan
Serdar Dilshad · باحث مستقل، دهوك، إقليم كردستان · 2026-10-09 · doi:10.5281/zenodo.23282763
الملخّص
لا يمكن لبرامج التجزئة في المناطق ذات الكهرباء والإنترنت غير المستقرين أن تجعل الشبكة جزءاً من عملية الدفع. نعرض تصميم واختبار وتركيب نظام نقاط بيع (POS) وإدارة لسوبرماركت بأربعة صناديق في دهوك، إقليم كردستان، بناه مطوّر واحد خلال ثلاثة أشهر. كل صندوق يبيع من نسخة SQLite محلية ويكتب كل مستند نهائي في صندوق صادر مُسلسل بالتجزئة ضمن المعاملة المحلية نفسها. تُرسَل المستندات إلى خادم داخل المتجر، وعند تعذّره مباشرة إلى خادم سحابي. يطبّق الخادم كل مستند مرة واحدة بالضبط، حسب معرّف فريد عالمياً وفي المعاملة نفسها مع حركات المخزون والقيود المحاسبية، ولا يرفض مستنداً مالياً أبداً: الحالات الشاذة مثل البيع فوق المخزون تُقبل وتُعلَّم للمراجعة البشرية. النسخ نحو الأسفل يستخدم مؤشرات على تسلسل يحدّده الخادم وفحص سلامة ليلياً. دالة تبديل نقية ومختبرة تقرّر متى يمكن للصندوق ترك خادم المتجر إلى السحابة، وتشترط دليلاً قبل كل تبديل وهامش تأخير ووقتاً رتيباً. نصف هذه الآليات؛ و«قانون الاتجاه» الذي يُبقي النسخ بين المتجر والسحابة خالياً من التعارضات الثنائية؛ ونمط طابور مهام واحداً يتحكّم من خلاله المالك بموازين الملصقات وأجهزة البصمة من الهاتف أو الجهاز اللوحي؛ وفهرساً لعشرين عطلاً ميدانياً وُجدت أثناء الاختبار والتركيب، نستخلص منها ستة مبادئ هندسية. تضمّ الشيفرة نحو 310,000 سطر في 1,243 تعديلاً و156 ترحيلاً لقاعدة البيانات و736 ملف اختبار، منها اختبارات قائمة على الخصائص لعدم التكرار وعدم تأثّر إعادة التشغيل بالترتيب. ونوضّح الحدود: النظام مُركّب لكنه لم يبع لعملاء حقيقيين وقت الكتابة، لذا نقدّم أدلة التصميم والتحقق لا إحصاءات انقطاع من الإنتاج.
الكلمات المفتاحية
offline-first · local-first software · point of sale · exactly-once processing · transactional outbox · tamper-evident logs · failover · label scales · fingerprint attendance · developing regions · experience report
طريقة الاستشهاد
Dilshad, S. (2026). Selling Through the Outage: An Experience Report on an Offline-First, Exactly-Once Supermarket Point-of-Sale in Duhok, Kurdistan. Experience report. https://doi.org/10.5281/zenodo.23282763
بناء وتشغيل: سەردار دلشاد.
لا تحتاج إلى معرفة المصطلحات التقنية. أخبرني بما تريد تحقيقه، أو بما لا يعمل كما ينبغي اليوم.