Selgorithm User Manual

================================================================================
  SELGORITHM — نظام نقاط البيع
  دليل المستخدم
  الإصدار 2026
================================================================================

--------------------------------------------------------------------------------
جدول المحتويات
--------------------------------------------------------------------------------
  1. المقدمة ونظرة عامة على النظام
  2. المزايا الرئيسية
  3. البدء باستخدام البرنامج
  4. الميزات الأساسية
     4.1  إدخال المنتجات وقراءة الباركود
     4.2  إدارة سلة التسوق
     4.3  الدفع ومعالجة المبيعات
     4.4  إدارة العملاء (الحسابات)
     4.5  تأجيل الطلب
     4.6  إدارة المنتجات
     4.7  نظام رموز الأنواع
     4.8  بطاقات الولاء والنقاط
     4.9  التقارير
     4.10 تقرير الأرباح
     4.11 إلغاء المبيعات وتصحيحها
     4.12 تقرير حركة المنتجات
     4.13 وحدة المالية والموارد البشرية
     4.14 قائمة إخراج المستودع
     4.15 استيراد / تصدير البيانات
     4.16 طباعة الفواتير
     4.17 طباعة ملصقات الباركود
  5. الإدارة
     5.1  إدارة المستخدمين
     5.2  الإعدادات والسمات البصرية
  6. اختصارات لوحة المفاتيح
  7. أمان البيانات والنسخ الاحتياطي
  8. ملاحظات تقنية

================================================================================
1. المقدمة ونظرة عامة على النظام
================================================================================

Selgorithm هو تطبيق نقطة بيع (POS) احترافي يعمل دون الحاجة إلى الإنترنت،
مصمم خصيصاً للمكتبات ومحلات التجزئة. مبني على واجهة ويب حديثة تعمل محلياً
على Windows، يجمع بين مرونة واجهة المستخدم المبنية على المتصفح وموثوقية وسرعة
تطبيقات سطح المكتب.

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

يدعم التطبيق 8 لغات و13 سمة بصرية وتنسيقات عملات متعددة — مما يجعله مناسباً
للعمليات المحلية والدولية.

================================================================================
2. المزايا الرئيسية
================================================================================

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

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

  وضوح الأرباح
  ——————————————
  يحسب تقرير الأرباح المدمج صافي الربح يومياً وأسبوعياً وشهرياً وسنوياً
  بمقارنة أسعار البيع بتكاليف الشراء. يمكّن ذلك الملاك من تحديد الفترات
  ذات الهامش العالي واتخاذ قرارات التوريد المستنيرة.

  علاقات العملاء
  ———————————————
  يشجع نظام بطاقات الولاء والنقاط العملاء على التكرار. يساعد تتبع الحسابات
  التفصيلي (مبيعات الآجل) على إدارة عملاء الائتمان والأرصدة المستحقة بشفافية.

  التحكم في الوصول متعدد المستخدمين
  ————————————————————————————————
  يضمن الوصول المستند إلى الأدوار (المشرف مقابل الموظف) أن أمناء الصندوق
  يمكنهم فقط تنفيذ العمليات المسموح بها، بينما يحتفظ المدراء بالسيطرة الكاملة
  على الوظائف الحساسة كالإلغاءات والتقارير والتهيئة.

  التحكم في المخزون
  ——————————————————
  تحديثات تلقائية للمخزون عند كل عملية بيع وإلغاء. تمنع تحذيرات انخفاض
  المخزون نفاد الكميات للعناوين الشائعة. تُنتج قائمة إخراج المستودع ملف
  PDF قابلاً للطباعة يعرض جميع العناصر المباعة في أي نطاق زمني.

================================================================================
3. البدء باستخدام البرنامج
================================================================================

  التشغيل الأول
  ——————————————
  عند التشغيل الأول، سيرشدك معالج الإعداد لتهيئة:
    - اسم الشركة ورمز الشعار (إيموجي)
    - اللغة والعملة الافتراضيتين
    - اسم مستخدم المشرف وكلمة المرور

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

  توافق الأجهزة
  ——————————————
  يكتشف Selgorithm نوع جهازك تلقائياً ويحمّل التخطيط المحسّن:
    - سطح المكتب: تخطيط كامل بلوحتين
    - الجهاز اللوحي: تخطيط متكيف مع درج تنقل منزلق
    - الهاتف المحمول: واجهة مدمجة محسّنة للمس

================================================================================
4. الميزات الأساسية
================================================================================

4.1  إدخال المنتجات وقراءة الباركود
——————————————————————————————————
  امسح باركود المنتج باستخدام ماسح USB أو Bluetooth، أو اكتب الباركود
  يدوياً في حقل الإدخال. يُسترجع المنتج فوراً من قاعدة البيانات ويُضاف
  إلى سلة التسوق.

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

  - اضغط F4 في أي وقت لنقل التركيز فوراً إلى حقل إدخال الباركود.
  - اضغط F3 للبحث عن المنتجات بالاسم عند عدم توفر الباركود.


4.2  إدارة سلة التسوق
——————————————————————
  تعرض السلة جميع العناصر الممسوحة مع حقول قابلة للتعديل للكمية والخصم
  وسعر الوحدة. انقر على أي خلية للتعديل المباشر.

  الفائدة: يتيح تعديل السلة في الوقت الفعلي لأمناء الصندوق تطبيق خصومات
  مخصصة وتصحيح الكميات وتعديل الأسعار دون إعادة تشغيل المعاملة.

  - حدد صفاً واضغط F2 لفتح نافذة تعديل المنتج الكاملة.
  - استخدم Ctrl+↓ / Ctrl+↑ للتنقل بين صفوف السلة من لوحة المفاتيح.
  - انقر بزر الماوس الأيمن على أي صف لخيارات القائمة السياقية (تعديل / حذف).


4.3  الدفع ومعالجة المبيعات
——————————————————————————
  يدعم Selgorithm ثلاث طرق دفع:

    نقداً (F8)       — دفع نقدي فوري. يُخفَّض المخزون، ويُحدَّث عداد
                        الإيرادات اليومية.
    بطاقة (F9)       — الدفع بالبطاقة الائتمانية أو البطاقة المدينة.
                        نفس عملية الدفع النقدي.
    آجل (F6)         — دفع مؤجل يُسند إلى حساب العميل. يُنشئ تلقائياً
                        قيد دين في دفتر حسابات العميل. متاح فقط عند
                        تحديد عميل.

  الفائدة: تدعم خيارات الدفع المرنة جميع سيناريوهات البيع بالتجزئة.
  تُتيح مبيعات الآجل إدارة الحسابات الرسمية دون برامج محاسبة خارجية.


4.4  إدارة العملاء (الحسابات)
———————————————————————————
  أضف حسابات العملاء وأدرها لتتبع الائتمان. لكل عميل دفتر حسابات يعرض
  جميع مبيعات الآجل والمدفوعات والأرصدة.

  الفائدة: استبدل دفاتر الحسابات الورقية بسجل رقمي قابل للبحث دائماً
  دقيق يُبيّن رصيد كل عميل المستحق وسجل معاملاته.

  - أعد تسمية العملاء أو احذفهم من قائمة الإعدادات.
  - تتكامل حسابات العملاء مباشرة مع مبيعات الآجل.


4.5  تأجيل الطلب (F7)
——————————————————
  احفظ سلة تسوق مكتملة جزئياً في قائمة الانتظار بينما تخدم عميلاً آخر.
  تُدرج الطلبات المؤجلة في اللوحة اليمنى ويمكن استعادتها في أي وقت.

  الفائدة: يُلغي خسارة المبيعات بسبب مقاطعات العملاء. يمكن لأمناء
  الصندوق التعامل مع معاملات متعددة في وقت واحد دون فقدان البيانات.


4.6  إدارة المنتجات
——————————————————
  يحتوي كل سجل منتج على:
    - الباركود والعنوان ودار النشر
    - سعر القائمة (سعر الغلاف)
    - خصم الشراء (أساس التكلفة لحساب الربح)
    - خصم تاجر التجزئة
    - خصم العميل
    - مستوى المخزون الحالي
    - رمز النوع (الفئة)
    - صورة الغلاف

  انقر بزر الماوس الأيمن على أي منتج ممسوح لتعديل تفاصيله.

  الفائدة: تضمن بيانات المنتجات المركزية تسعيراً متسقاً عبر جميع
  المعاملات. يُتيح تكامل خصم الشراء تتبع الأرباح تلقائياً دون إدخال
  تكاليف يدوي.


4.7  نظام رموز الأنواع
————————————————————
  خصص رموز أنواع من 1 إلى 3 أحرف لتصنيف المنتجات (مثال: R = رواية،
  T = اختبارات/دراسة، C = أطفال). أنشئ رموزاً مخصصة غير محدودة بألوان
  مخصصة عبر الإعدادات ← إدارة رموز الأنواع.

  الفائدة: تُتيح رموز الأنواع قوائم إخراج المستودع المُصفّاة، مما يسمح
  لموظفي المستودع برؤية فئات المنتجات ذات الصلة بمنطقة عملهم فقط.


4.8  بطاقات الولاء والنقاط
——————————————————————————
  أصدر بطاقات ولاء مادية بأرقام بطاقات فريدة. تُكتسب النقاط تلقائياً
  بناءً على معدل ربح قابل للتهيئة لكل عملية شراء. اعرض إجمالي نقاط كل
  عميل وسجل معاملاته في وحدة المالية.

  الفائدة: تزيد برامج الولاء معدلات الشراء المتكرر. لا يتطلب نظام
  النقاط الآلي تتبعاً يدوياً ويتكامل بسلاسة مع معالجة المبيعات.


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

  الفائدة: وصول فوري إلى البيانات التاريخية للمبيعات لأي فترة. التصدير
  إلى Excel للتحليل الإضافي أو التكامل المحاسبي. الطباعة مباشرة من
  المتصفح للسجلات المادية.


4.10 تقرير الأرباح
——————————————————
  الوصول عبر التقارير ← تقرير الأرباح. اعرض بيانات الأرباح المجمعة عبر
  أربعة مقاييس زمنية: يومي، أسبوعي، شهري، سنوي.

  يعرض كل صف: الفترة | الكمية | الإيرادات | التكلفة | الربح | هامش%
  تعرض بطاقات الملخص إجمالي الإيرادات والتكاليف وصافي الربح ومتوسط الهامش.

  الربح = الإيرادات − (الكمية × سعر القائمة × (1 − خصم الشراء%))

  الفائدة: بيانات الربحية في الوقت الفعلي دون محاسب. حدد الفترات أو
  المواسم أو الأشهر التي تولّد أعلى الهوامش. قارن الأداء الأسبوعي
  لتحسين قرارات الطلب والتوظيف.


4.11 إلغاء المبيعات وتصحيحها
——————————————————————————
  الإلغاء: ابحث عن عملية بيع سابقة بالباركود. راجع تفاصيل البيع وأكد
  الإلغاء. يُؤرشف السجل الملغى، ويُستعاد المخزون تلقائياً، وتُعدَّل
  الإيرادات.

  التصحيح: ينقل عناصر عملية بيع سابقة مرة أخرى إلى السلة النشطة لإعادة
  التسعير أو إعادة المسح قبل إعادة البيع بقيم مصححة.

  الفائدة: تصحيحات آمنة للتدقيق دون حذف دائم للبيانات. تُحفظ المبيعات
  الملغاة في أرشيف منفصل للامتثال والمراجعة.


4.12 تقرير حركة المنتجات
——————————————————————
  الوصول عبر التقارير ← الحركات. امسح أو أدخل باركوداً لعرض آخر 7 أيام
  من نشاط المبيعات لذلك المنتج المحدد، بما يشمل الكمية المباعة يومياً.

  الفائدة: تحديد المخزون سريع الحركة بسرعة لإعطاء الأولوية لإعادة الطلب
  قبل نفاد الكميات.


4.13 وحدة المالية والموارد البشرية
——————————————————————————————
  الوصول عبر المشرف ← المالية والموارد البشرية (/finans).

  الميزات:
    - إدارة الموظفين: إضافة موظفين، تتبع ساعات العمل (دعم العمل الإضافي)
    - مدفوعات الرواتب: تسجيل وتتبع سجل المدفوعات لكل موظف
    - تتبع المصروفات: تسجيل مصروفات الأعمال حسب الفئة
    - ملخص مالي يومي: الإيرادات والمصروفات وصافي الرصيد
    - حسابات العملاء: دفتر حسابات مدين/دائن كامل لكل عميل
    - تصدير البيانات المالية إلى Excel

  الفائدة: نظرة عامة مالية شاملة للأعمال الصغيرة في شاشة واحدة. لا حاجة
  لبرامج رواتب أو مصروفات منفصلة للفرق الصغيرة.


4.14 قائمة إخراج المستودع (eksik-listesi)
—————————————————————————————————————————
  الوصول عبر المشرف ← القائمة المفقودة. حدد نطاق تاريخ ومرشحات نوع
  المنتج لإنشاء ملف PDF قابل للطباعة يعرض جميع العناصر المباعة (قائمة
  إخراج/انتقاء المستودع).

  الفائدة: يوفر لموظفي المستودع قائمة انتقاء واضحة مصفّاة حسب النوع
  مباشرة من بيانات المبيعات — مما يلغي إعداد القوائم اليدوي ويقلل أخطاء
  التنفيذ.


4.15 استيراد / تصدير البيانات
——————————————————————————
  الوصول عبر قائمة البيانات.

  التصدير:
    - قائمة المخزون إلى Excel (.xlsx)
    - تقرير المبيعات إلى Excel لأي نطاق زمني
    - نسخة احتياطية كاملة لقاعدة البيانات (ملف .db)

  الاستيراد:
    - استيراد منتجات جماعي عبر قالب Excel
    - يعرض وضع المعاينة المشكلات المحتملة قبل التطبيق
    - استعادة قاعدة البيانات من النسخة الاحتياطية

  الفائدة: تكامل سلس مع مسارات العمل المبنية على Excel. يقلل إدخال
  المنتجات الجماعي بشكل كبير من وقت الإعداد للمتاجر الجديدة. تحمي
  النسخ الاحتياطية المنتظمة من فقدان البيانات.


4.16 طباعة الفواتير
——————————————————
  هيّئ طابعة الفواتير الحرارية في الإعدادات ← إعدادات الفاتورة. تتضمن
  الفواتير اسم الشركة والعنوان الفرعي وتفاصيل السلة والمجاميع وملخص
  الخصومات ومعلومات العميل.

  الفائدة: تعزز الفواتير الاحترافية ثقة العملاء وتوفر سجلاً مادياً
  لكل معاملة لكلا الطرفين.


4.17 طباعة ملصقات الباركود
————————————————————————
  في نافذة تعديل المنتج، انقر على زر الطباعة لفتح مصمم ملصقات الباركود.
  اختر حجم الملصق والكمية والتخطيط. اطبع مباشرة على أي طابعة متصلة.

  الفائدة: تُلغي طباعة الملصقات داخلياً الاعتماد على الملصقات المطبوعة
  مسبقاً وتتيح إعادة التصنيف الفوري عند تغيير الأسعار.

================================================================================
5. الإدارة
================================================================================

5.1  إدارة المستخدمين
————————————————————
  يمكن للمستخدمين المشرفين إنشاء حسابات الموظفين وتعديلها وحذفها من
  /admin/users. يتوفر دوران:

    مشرف    — وصول كامل إلى جميع الميزات بما في ذلك التقارير والإلغاءات
               وإدارة المستخدمين والتهيئة.
    موظف    — الوصول إلى المبيعات والسلة والتأجيلات واختيار العملاء فقط.

  الفائدة: يمنع الفصل بين الأدوار الوصول غير المصرح به إلى الوظائف
  الحساسة مثل التقارير المالية وإلغاءات المبيعات.


5.2  الإعدادات والسمات البصرية
———————————————————————————
  الوصول عبر المشرف ← الإعدادات.

    - اسم الشركة ورمز الشعار (إيموجي)
    - لغة العرض (8 خيارات)
    - السمة البصرية (13 خياراً)
    - رمز العملة
    - عتبة تنبيه انخفاض المخزون
    - اسم العميل الافتراضي
    - إدارة رموز الأنواع

  الفائدة: يضمن التخصيص الكامل أن تعكس الواجهة علامتك التجارية وتبدو
  مألوفة لفريقك منذ اليوم الأول.

================================================================================
6. اختصارات لوحة المفاتيح
================================================================================

  المفتاح     الإجراء
  ——————————  ————————————————————————————————————————
  F1          فتح مرجع اختصارات لوحة المفاتيح
  F2          تعديل المنتج المحدد (يجب تحديد صف السلة)
  F3          فتح البحث عن المنتج بالاسم
  F4          التركيز على حقل إدخال الباركود (تحديد الكل)
  F5          إعادة تحميل الصفحة
  F6          معالجة عملية بيع آجل
  F7          تأجيل الطلب الحالي
  F8          معالجة عملية بيع نقدي
  F9          معالجة عملية دفع بالبطاقة
  F11         تبديل وضع ملء الشاشة
  Ctrl+↓      نقل التحديد إلى صف السلة التالي
  Ctrl+↑      نقل التحديد إلى صف السلة السابق
  Enter       تأكيد الباركود / تأكيد تعديل الخلية
  Escape      إلغاء التعديل المباشر / إغلاق النافذة
  ↑ / ↓       التنقل داخل الخلية القابلة للتعديل

================================================================================
7. أمان البيانات والنسخ الاحتياطي
================================================================================

  يتم تخزين جميع البيانات محلياً في:
    %LOCALAPPDATA%\Selgorithm_Web\

  يتم إنشاء أسرار الجلسة تلقائياً عند التشغيل الأول وتخزينها محلياً.
  لا يتم إرسال أي بيانات إلى خوادم خارجية.

  جدول النسخ الاحتياطي الموصى به:
    - يومياً: تصدير نسخة احتياطية لقاعدة البيانات عبر البيانات ← نسخ
      احتياطي
    - أسبوعياً: نسخ مجلد Selgorithm_Web إلى محرك أقراص خارجي أو خدمة
      تخزين سحابي من اختيارك

  الاستعادة: استخدم البيانات ← استعادة قاعدة البيانات لتحميل ملف نسخ
  احتياطي سابق.

================================================================================
8. ملاحظات تقنية
================================================================================

  - يعمل على Python 3.10+ مع إطار عمل Flask للويب
  - قاعدة البيانات: SQLite (ملف .db واحد، محمول)
  - الواجهة: WebView2 (مدمج في Windows) يعرض خادم ويب محلي
  - الحد الأدنى لنظام التشغيل: Windows 10 (64 بت)
  - لا يلزم توفر اتصال بالإنترنت للتشغيل
  - تشغيل أجهزة متعددة ممكن على شبكة محلية (تواصل مع موزعك)

================================================================================
  © 2026 Selgorithm. جميع الحقوق محفوظة.
================================================================================