انتقل إلى المحتوى
Derar Sattouf

بناء Pythagoras Apps: منصة عربية لنقاط البيع على سطح المكتب

Derar SattoufDerar Sattoufعرض المشروع
بناء Pythagoras Apps: منصة عربية لنقاط البيع على سطح المكتب

نظرة عامة على المشروع

Pythagoras Apps منظومة منتجات لبرمجيات نقاط البيع العربية. تجمع نظام إدارة محتوى مبنيًا على Laravel، وصفحات تعريفية عامة، وواجهات API للتفعيل، وروابط للتنزيل، وخلاصات للتحديث، وعدة تطبيقات Electron لسطح المكتب تخدم أنواعًا مختلفة من المتاجر.

لم يكن الهدف بناء شاشة بيع واحدة. كان على المنصة أن تدعم عمل المتجر الفعلي: مبيعات المتجر، وإدارة المنتجات، والعمل بالباركود، والمشتريات، والعملاء، والتجار، وكشوف الحساب، وبطاقات قوائم المطاعم، وشراء المكونات، وتفعيل الأجهزة بأمان، وإصدارات موثوقة لتطبيقات سطح المكتب.

منظومة المنتجات

يتمحور المستودع الموحد حول منصة خلفية واحدة وعدة منتجات لسطح المكتب:

  • نظام إدارة محتوى على Laravel للصفحات العامة، وسجلات الإدارة، والتفعيل، ورسائل التواصل، وتنزيل الإصدارات، وخلاصات التحديث.
  • نقطة بيع للسوبرماركت للمنتجات والباركود وحركة المخزون والفواتير والعملاء والتجار والتقارير اليومية.
  • نقطة بيع للمتاجر للمحال العامة التي تبيع منتجات متنوعة وتحتاج تسعيرًا ومخزونًا مرنين.
  • نقطة بيع للملابس لمتاجر الملابس، بتجربة خاصة على سطح المكتب.
  • نقطة بيع للمطاعم لبطاقات القوائم، وخيارات الأصناف، ومبيعات المطعم، وشراء المكونات، وتقارير التشغيل.
  • حزمة مشتركة لسطح المكتب لمنطق التحديث، ومستودعات التفعيل، والسكربتات، وإعدادات التشغيل، وأدوات تعريف الجهاز.

تُبقي هذه البنية كل قطاع مركزًا على حاجته، مع مشاركة الأساس المهم: التفعيل، والتحديثات، وإعداد سطح المكتب، والربط مع الخادم.

نظام إدارة المحتوى ومنصة التفعيل

جانب Laravel هو مركز التحكم في المنظومة. يقدم الصفحات التسويقية، وصفحات التطبيقات، ولوحة الإدارة، وفحوص تفعيل الأجهزة، وبيانات الإصدارات، وإعادة توجيه روابط التنزيل، ونقاط التحديث التي تستخدمها تطبيقات سطح المكتب.

أهم مسؤوليات الخادم:

  • مسارات API خاصة بكل تطبيق، ليفحص كل منتج تفعيله وتحديثاته بشكل مستقل.
  • منطق تفعيل يفصل الأجهزة حسب التطبيق، فلا تصبح رخصة تطبيق صالحة لمنتج آخر دون قصد.
  • واجهات إدارة للأجهزة ورسائل التواصل.
  • مسارات تنزيل عامة لمثبتات Windows وملفات التحديث.
  • معالجة نموذج التواصل مع تحديد معدل الطلبات لتقليل الرسائل المزعجة وسوء الاستخدام.
  • خريطة موقع، وصفحات الخصوصية والشروط، وملفات عامة خفيفة للبحث والظهور.
  • ترويسات أمان مطبقة على كل الطلبات عبر middleware في Laravel.

النتيجة خادم يعمل موقعًا للمنتج وخدمة للترخيص والتحديث معًا، دون فصل هذين الجانبين في أنظمة منفصلة قبل الأوان.

بنية تعمل على الجهاز أولًا لسطح المكتب

بُنيت تطبيقات سطح المكتب باستخدام Electron و React و Vite و Material UI، مع قاعدة بيانات SQLite محلية مشفرة عبر better-sqlite3-multiple-ciphers.

هذا النموذج المحلي مهم لبرمجيات نقاط البيع، لأن فريق المتجر يحتاج شاشات سريعة ومسار بيع يعتمد عليه حتى حين يضعف الاتصال بالإنترنت. يتولى الخادم التفعيل والتحديثات، ويبقى العمل اليومي قريبًا من الجهاز.

أهم قرارات سطح المكتب:

  • تخزين محلي مشفر للسجلات التشغيلية الحساسة.
  • ضبط عنوان الخادم وقت التشغيل للتطوير المحلي وللإنتاج.
  • أدوات تعريف الجهاز لفحوص التفعيل.
  • تحديث تلقائي في Electron لتوزيع الإصلاحات والإصدارات الجديدة.
  • كود مشترك للتفعيل والتحديث بين التطبيقات لتقليل التكرار.
  • إعداد Electron Builder لحزم Windows و macOS.
  • إعدادات Electron fuses لتقليل سطح الهجوم وقت التشغيل وتحميل التطبيق من ملفاته المحزمة.

وبذلك يبدو كل تطبيق نقطة بيع كأنه أداة أصلية مركزة، مع نموذج هندسي واحد لكل عائلة المنتجات.

تجربة المستخدم بالعربية ومن اليمين إلى اليسار

صُمّمت التطبيقات ونظام إدارة المحتوى للمستخدمين العرب. يُعرض تطبيق الويب من اليمين إلى اليسار، وتستخدم منتجات سطح المكتب نصوصًا عربية وخط Cairo ودعم RTL عبر Material UI وإضافات Stylis.

لم يقتصر أثر ذلك على اتجاه النص. شاشات نقطة البيع يجب أن تُقرأ بسرعة تحت الضغط، فكان على الواجهة أن تُبقي الأزرار والمجاميع وجداول المنتجات ومسارات العملاء وخطوات الدفع واضحة للموظفين. نقطة البيع الجيدة لا تكفيها الصحة التقنية، بل يجب أن تكون بديهية في يوم عمل مزدحم.

أتمتة الإصدارات والتحديثات

لكل تطبيق سطح مكتب مسار إصدار خاص في GitHub Actions. يرفع المسار رقم الإصدار، وينشئ وسومًا خاصة بالتطبيق، ويبني ملفات Windows و macOS، ويرفع ملفات الإصدار، وينشرها لمسارات التنزيل والتحديث.

وتنسق المنصة مهام الإصدار بمجموعة تزامن مشتركة، فلا تتداخل إصدارات سطح المكتب وتنتج حالات إصدار مربكة.

يفيد هذا منظومة منتجات لأن عملية الإصدار تصبح قابلة للتكرار:

  • شغّل فحوص الواجهة وعمليات البناء قبل الإصدار.
  • ادفع تحديث التطبيق إلى الفرع الرئيسي.
  • اترك المسار يرفع رقم الإصدار ويضع الوسم ويبني وينشر الملفات.
  • قدّم بيانات أحدث إصدار عبر API الخاص بـ Laravel.
  • اترك محدث سطح المكتب يكتشف الإصدار الجديد.

بهذا يتحول تسليم التطبيق من تحزيم يدوي إلى مسار تشغيلي.

نشر الخادم وتشغيله

يدفع مسار نشر نظام إدارة المحتوى تطبيق Laravel إلى خادم الإنتاج، ويثبت اعتماديات PHP المحسنة، ويبني ملفات الواجهة، وينفذ الترحيلات، ويُدخل البيانات الأولية عند الحاجة، ويربط التخزين، ويمسح ذاكرة Laravel المؤقتة ويعيد بناءها، ويعيد تحميل PHP-FPM.

يمنح ذلك المشروع طريقًا عمليًا إلى الإنتاج: يصدر الخادم بالثقة نفسها التي تصدر بها تطبيقات سطح المكتب، وتُنشر التغييرات على الصفحات التعريفية أو مسارات التفعيل أو طبقة الأمان أو مزايا الإدارة بطريقة واحدة.

الأمان والموثوقية

تتعامل برمجيات نقاط البيع مع سجلات العمل والحركات المالية وأرصدة العملاء وتراخيص الأجهزة، فكان على التنفيذ أن ينظر إلى الأمان من عدة زوايا:

  • تخزين SQLite مشفر على سطح المكتب.
  • فحوص تفعيل مرتبطة بهوية الجهاز.
  • مسارات تفعيل خاصة بكل تطبيق لفصل المنتجات.
  • تحديد معدل الطلبات في واجهات API التفعيل والتواصل والإصدارات والتنزيل والتحديث.
  • ترويسات أمان في تطبيق Laravel.
  • Electron fuses تعطل السلوكيات غير الآمنة وقت التشغيل.
  • روابط تنزيل وتحديث مضبوطة بدل روابط إصدارات غير مُدارة.
  • خطوات نشر تحسن Laravel وتعيد تحميل خدمات الإنتاج بسلاسة.

النهج الأمني عملي: تقليل طرق سوء الاستخدام الواضحة، وضبط وصول الأجهزة، وجعل عمليات الإنتاج قابلة للتكرار.

التقنيات المستخدمة

  • الخادم: Laravel و PHP 8.3 و Inertia و Fortify و Pest وطبقة بيانات متوافقة مع MySQL.
  • واجهة نظام إدارة المحتوى: React و Vite و Tailwind CSS و Inertia.
  • تطبيقات سطح المكتب: Electron و React و Vite و Material UI و React Router.
  • قاعدة البيانات المحلية: SQLite مشفرة عبر better-sqlite3-multiple-ciphers.
  • التحديثات والتحزيم: Electron Builder و Electron Updater و GitHub Releases.
  • DevOps: GitHub Actions، ونشر عبر SSH، و Composer، وبناء npm، وترحيلات Laravel، وإعادة تحميل PHP-FPM.
  • تجربة المستخدم: واجهة عربية أولًا، وتخطيط RTL، وخط Cairo، وأيقونات وصفحات تعريفية لكل تطبيق.

التحديات والحلول

خادم واحد ومنتجات متعددة

كان التحدي أن تبقى منصة Laravel واحدة مفيدة لعدة تطبيقات نقاط بيع دون أن تصبح كل المسارات عامة أكثر من اللازم. الحل كان مسارات وسجلات منتجات خاصة بكل تطبيق، فتستدعي التطبيقات النوع نفسه من النقاط ويُحسم السياق الصحيح لكل تطبيق.

سرعة سطح المكتب مع تحكم من الخادم

شاشات نقطة البيع يجب أن تكون سريعة، والترخيص والتحديثات تحتاج خدمة مركزية. تُبقي تطبيقات سطح المكتب العمل اليومي محليًا، ويتولى نظام إدارة المحتوى التفعيل واكتشاف الإصدارات. فتبقى تجربة البيع سريعة والمنتج مضبوطًا.

إصدارات قابلة للتكرار

الإصدارات اليدوية لسطح المكتب عرضة للخطأ. حصل كل تطبيق على مسار إصدار، وتسمية للوسوم، وعملية بناء للملفات، وتكامل مع المحدث. فصار إصدار نسخة جديدة أكثر قابلية للتنبؤ وأسهل في التدقيق.

مسارات عمل المتاجر العربية

منطق نقطة البيع العام لم يكن كافيًا. مبيعات المطاعم تعتمد على بطاقات القوائم والخيارات، والمتاجر والسوبرماركت تعتمد كثيرًا على المنتجات والباركود والفواتير والمخزون والعملاء والتجار. تتشارك التطبيقات البنية التحتية، ويبقى مسار العمل خاصًا بنوع النشاط.

النتيجة

تملك Pythagoras Apps اليوم أساس منصة منتجات حقيقية: خادم Laravel يدير الصفحات العامة والتفعيل والإصدارات والتنزيلات وعمليات الإدارة، وعدة تطبيقات عربية لنقاط البيع على سطح المكتب تُحزَّم وتُحدَّث وتُصان من مستودع واحد.

أقوى ما في المشروع هو التوازن بين حاجات المتاجر العملية وتشغيل البرمجيات. المتاجر تحصل على تطبيقات مركزة، والشركة تحصل على تحكم في التفعيل، وأتمتة للإصدارات، ونشر للخادم، وكود يواصل النمو دون أن يتحول كل قطاع جديد إلى نظام منفصل تمامًا.