الفصل 2 — تطبيق الهاتف المحمول للتاجر

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

⚠️ لغة البرنامج إنجليزية. واجهة المستخدم في هذا التطبيق بالإنجليزية فقط (بلا ألمانية/فارسية)؛ وتُعرَض البيانات فقط (اسم المنتج وسعره) بلغة المتجر. الملصقات داخل الأقواس في هذا الفصل هي ذاتها النص الإنجليزي الظاهر على الشاشة.

2-1. تسجيل الدخول

1. أدخِل نطاق المتجر واضغط التحقق من النطاق (Verify domain). تعرض بطاقة المتجر المُتحقَّق منه الاسمَ والعنوانَ وشارة الخطة (إذا لم توجد خطة: «No plan published»)؛ ويوجد أيضًا زر إعادة التحقق (Re-verify). (النطاق غير الصالح لا يمنع تسجيل الدخول كي لا تتصل بمتجر خاطئ.)
2. أدخِل البريد الإلكتروني وكلمة المرور (وهما معطّلان حتى التحقق من النطاق) واضغط تسجيل الدخول.
3. إذا كان التحقق بخطوتين مفعّلًا، أدخِل الرمز لمرة واحدة أو أحد رموز الاسترداد؛ ويوجد أيضًا زر «Start over» للبدء من جديد.
4. حالات البدء: عند الفتح قد ترى «Restoring mobile session» ثم «Loading tenant workspace»؛ وإذا فشل التهيئة، تظهر «Workspace bootstrap failed» مع زر إعادة المحاولة / تسجيل الخروج.

💡 الصلاحيات: معظم الصفحات تحتاج إلى صلاحية؛ وبدون الصلاحية اللازمة تُعرَض بطاقة «Permission required» بدلًا من الصفحة (مثلًا يتطلب استلام البضاعة صلاحية إنشاء منتج أو تعديل المخزون).

2-2. الصفحة الرئيسية والتنقّل

• الصفحة الرئيسية: بطاقات اختصار مجمّعة بحسب الدور — مالك العمل، المخزون، الشراء، الاستلام، التسليم، المبيعات — للمهام كثيرة الاستخدام. إضافةً إلى قسم التنبيهات.
• صف الإحصاءات العامة: ⚠️ هذه الأرقام هي عدد البيانات المرجعية (عدد الفئات الضريبية، والفئات، والمصادر، والفروع)، وليست أرقام مبيعات.
• القائمة الجانبية المنسدلة: تنقّل متعدد المستويات؛ وقد جُمِعت كل أقسام الإعدادات وإدارة الضرائب تحت مجموعة واحدة «System».
• الملف الشخصي في الشريط السفلي.

2-3. الأقسام الرئيسية

المبيعات

• نظرة عامة على المبيعات.
• المهام اليومية: الطلبات، والسلال، والفواتير، والمرتجعات، والمعاملات (لكلٍّ منها قائمة + تفاصيل).
• التسليم: الشحنات، وطلبات الإرجاع، والتواقيع، وتقييم المخاطر.
• البرامج: بطاقات الهدايا، والاشتراكات.

الكتالوج والمنتجات

• قائمة المنتج وتفاصيله/تحريره، وإنشاء منتج، والاستيراد الجماعي (Import).
• الاستلام بالباركود (Intake) — سير عمل كامل، لا مجرد مسح: باركود معروف ← إضافة المخزون أو ضبطه في فرع مع ملاحظة؛ باركود مجهول ← إنشاء منتج كامل (مجموعة السمات، والاسم، والرمز، والفئة، والوحدة وتحويل الوحدات، والفئة الضريبية، والسعر الصافي/الإجمالي متعدد الأدوار، والمعرض، والمخزون الأولي). حالة التكرار (Repeat) للمسح المتواصل، وربطه بسلسلة إلى المسح/الجرد/استلام الشراء.
• الفئات والعلامات التجارية والمجموعات: لكلٍّ منها إنشاء/تفاصيل/تحرير كامل (لا مجرد قائمة).

الباركود

• مركز الباركود / المسح: مسح أو كتابة ← إيجاد المنتج ← فتح المنتج/تحرير/تفاصيل الباركود، أو «إنشاء من باركود» عند عدم العثور على منتج.
• ثلاثة أوضاع للماسح (تُحفَظ): كاميرا الهاتف، والإدخال العتادي (الماسحات التي تكتب)، والكاميرا العتادية (الأجهزة المخصّصة).
• قائمة الباركود + وضع التحديد: تحديد جماعي، وإعادة تعيين جماعية إلى منتج آخر، وتصدير CSV من المحدَّد أو من القائمة كاملة، وطباعة الملصقات.
• تفاصيل الباركود: تعديل الكمية / إعادة التعيين / الحذف، مع بطاقة طباعة الملصق.
• صفحة «ربط باركود بمنتج» منفصلة (من داخل المنتج نفسه) للمسح والربط.

المخزون

• نظرة عامة على المخزون؛ تفاصيل مخزون كل صنف.
• الجرد سير عمل: قائمة + إنشاء + صفحة تفاصيل الجرد (مسح ← عدّ ← حفظ كل صنف ← إتمام).
• سجل المخزون وتعديله؛ المواقع والمصادر بإنشاء/تفاصيل/تحرير كامل.

الشراء

• نظرة عامة؛ الطلبات/الإيصالات/الطلبات المقدَّمة؛ الموردون والتوريد؛ المخزون المنخفض؛ الفواتير، والمرتجعات، والإرجاعات، والتقارير، والإشعارات.
• استلام الشراء (Receiving): صفحة المسح والمطابقة مع سطر الطلب التي تنشئ الإيصال.
• إجراءات طلب الشراء: تحرير، واستلام، وإنشاء فاتورة من الطلب، وإنشاء مرتجَع، وإنشاء إرجاع؛ وتحويل الطلب المقدَّم إلى طلب.

المستخدمون والنظام

• العملاء والأدوار بإنشاء/تفاصيل/تحرير كامل.
• الإعدادات (12 قسمًا + الصفحة الرئيسية): عام، والكتالوج، والعميل، والضريبة، والمبيعات، والسمة، والدفع، والشحن، والطابعات، والشهادات، والتكامل، والسمات. ⚠️ ملاحظات مهمة:
• إعدادات السمات لا تعمل بعد (الصفحة محظورة/قيد الإنشاء).
• الشهادات والتكامل للقراءة فقط.
• الضريبة — في موضعين: صفحة إعدادات، وقسم منفصل System ← Tax بقائمة كاملة وعمليات CRUD لـالفئات والقواعد والنسب الضريبية.
• الطابعات — في موضعين: الإعدادات ← الطابعات، ومدير أجهزة الطابعات (System ← Printers) لتعريف النوع (شبكة/بلوتوث/USB/iMin)، والطراز (Epson/Star)، والعنوان/البروتوكول/المنفذ، وعرض الورق 58/80 مم، والتفعيل/التعطيل.
• الحساب/الملف الشخصي: تحرير الملف الشخصي، والأمان، والمظهر، والإشعارات، والاتصالات (هذه «الاتصالات» الخاصة بالحساب منفصلة عن تكامل النظام).

2-4. طباعة الملصقات من الهاتف

⚠️ هذا التطبيق لا يطبع الإيصالات — بل ملصقات المنتجات فقط.

• القالب والعدد: اختر نمط الملصق (مضغوط / قياسي / عريض) وعدد النسخ من 1 إلى 50.
• طرق إخراج الملصق: تنزيل PDF، أو المشاركة، أو الإرسال إلى نافذة طباعة نظام الهاتف، أو الطباعة المباشرة إلى طابعة شبكية.
• الطابعة الشبكية: Epson (ePOS) أو Star (WebPRNT) على الشبكة المحلية — الطريقة الأكثر استقرارًا.
• البلوتوث (BLE): مُبرمَج لكنه لم يُتحقَّق منه مع العتاد بعد ويحتاج إلى نسخة خاصة من التطبيق (لا يعمل على Expo Go).
• USB وiMin: غير مدعومين حاليًا.

💡 لوسم الرفوف السريع بالملصقات، فإن المسار الأكثر ضمانًا حاليًا هو الطابعة الشبكية أو إخراج PDF/المشاركة.