التثبيت والتحديث
- على هاتف أندرويد، افتح رابط التنزيل. إذا طلب الهاتف ذلك، اسمح للمتصفح بـ Install unknown apps (تثبيت التطبيقات غير المعروفة).
- افتح ملف
BM-AdminApp.apkالذي تم تنزيله واضغط Install (تثبيت). - عند نشر إصدار أحدث، تعرض الشاشة الرئيسية شريط يتوفر تحديث. اضغط تحديث، ثم نزّل الملف وثبّته فوق التطبيق الحالي.
تسجيل الدخول
- Company code (رمز الشركة) — الرمز المختصر لشركتك (3–20 حرفاً صغيراً أو رقماً، مثل
acme). وهو الجزء الأول من عنوان لوحة التحكم. يتذكره التطبيق. - البريد الإلكتروني أو الهاتف وكلمة المرور — بيانات دخولك إلى لوحة التحكم. الحسابات ذات دور admin (مسؤول) فقط يمكنها استخدام هذا التطبيق.
- اضغط تسجيل الدخول.
أول تسجيل دخول على هاتف جديد
هواتف المسؤولين تحتاج إلى موافقة أيضاً. عند تسجيل الدخول لأول مرة على هاتف، يعرض التطبيق بطاقة الموافقة على هذا الهاتف بدلاً من فتحه:
- وافق على الهاتف بنفسك من لوحة التحكم ← Devices (الأجهزة) أو من رابط "devices waiting for OTP" في الشريط العلوي، أو اطلب ذلك من مسؤول آخر. تعرض البطاقة في انتظار المسؤول… وتتحقق كل 5 ثوانٍ؛ وبعد الموافقة يسجّل التطبيق دخولك تلقائياً.
- أو أنشئ هناك الرمز المكوّن من 6 أرقام (صالح لمدة 10 دقائق)، ثم أدخله واضغط تحقق وسجّل الدخول.
تتوقف البطاقة عن التحقق بعد 5 دقائق — إذا تمت الموافقة على الهاتف لاحقاً، فاضغط تسجيل الدخول مرة أخرى. في الشركة التجريبية (demo) تتم الموافقة على الهواتف تلقائياً.
الموافقة على هواتف موظفيك. عندما يسجّل مندوب مبيعات أو عميل أو مراقب الدخول على هاتف جديد، تعرض الشاشة الرئيسية تنبيه "… هواتف بانتظار رمز". اضغط فتح (أو اذهب إلى More ← Devices)، ثم اختر الموافقة بدون رمز أو اضغط إنشاء رمز واقرأ الرمز المكوّن من 6 أرقام للمستخدم — يعمل لمدة 10 دقائق على ذلك الهاتف فقط.
بعد أول تسجيل دخول ناجح قد يعرض عليك التطبيق بصمة الإصبع / Face ID. يقفل التطبيق نفسه بعد 15 دقيقة من عدم الاستخدام.
تغيير كلمة المرور
المستخدم الذي أُعطي كلمة مرور مؤقتة يرى تعيين كلمة مرور جديدة مباشرة بعد أول تسجيل دخول — وينطبق الأمر عليك أيضاً.
إيقاف هاتف أو إزالته
في More → Devices (المزيد ← الأجهزة) تُعرض كل الهواتف المعتمدة مع آخر استخدام. Suspend (إيقاف) يُخرج الهاتف الآن ويمنعه حتى تلغي الإيقاف؛ وRemove (إزالة) يُخرجه ويجعل تسجيل الدخول التالي يطلب رمزاً جديداً. استخدمه عند فقدان هاتف أو مغادرة موظف.
التنقل في التطبيق
لكل شاشة شريط واحد في الأعلى. في التبويبات الخمسة، وفي أي شاشة تفتحها من القائمة، يكون شريط العلامة الملوّن مع زر القائمة؛ والشاشات المفتوحة من داخل شاشة أخرى تعرض شريطاً مسطحاً مع سهم رجوع. Help (المساعدة، من القائمة أو المزيد) تضم نصائح البداية السريعة وما يعمل بدون اتصال وهذا الدليل؛ وNeed help? في شاشة تسجيل الدخول تفتح هذا القسم.
العمل بدون اتصال
يعرض شريط أعلى كل شاشة الحالة: غير متصل — N تغييرات محفوظة محلياً، أو Connected but server is unreachable (متصل لكن تعذر الوصول إلى الخادم)، أو Syncing X of Y… (جارٍ مزامنة X من Y)، أو All changes synced (تمت مزامنة كل التغييرات) باللون الأخضر. اضغط مزامنة لفرض الرفع؛ واضغط على الشريط (أو صف N pending sync في الرئيسية وفي القائمة الجانبية) لفتح Sync issues (مشكلات المزامنة) ثم Retry (إعادة المحاولة) / Dismiss (تجاهل) / Retry all (إعادة محاولة الكل).
- يزامن التطبيق تلقائياً كل 45 ثانية أثناء فتحه، وكلما عدت إليه، ومباشرة بعد حفظ أي شيء بدون اتصال.
- يعمل بدون اتصال: إنشاء الطلبات وإلغاؤها، تسجيل المصروفات، وتصفح العملاء والمنتجات والتقارير المحفوظة.
- يحتاج إلى إنترنت: كل ما عدا ذلك: تعديل الكتالوج والعملاء، الموافقات، الأجهزة، المخزون، الإعدادات.
الرئيسية والتنقل
التبويبات السفلية: Home (الرئيسية) · Sales (المبيعات) · Customers (العملاء) · Inventory (المخزون) · More (المزيد). أيقونة القائمة (أعلى الشاشة) تفتح قائمة جانبية تسرد كل الشاشات مجمّعة: Overview (نظرة عامة)، Catalog (الكتالوج)، Customers (العملاء)، Sales (المبيعات)، Shipping (الشحن)، Expenses (المصروفات)، Inventory (المخزون)، Reports (التقارير)، Admin (الإدارة).
تعرض الرئيسية المبيعات (هذا الشهر)، والمصروفات (منذ بداية السنة)، والطلبات اليدوية المعلقة، وصف pending sync، وتنبيهاً عندما تنتظر هواتف الموافقة أو تحتاج استثناءات ميدانية إلى مراجعة، وروابط سريعة: New Order، New Expense، Products، Warehouse. حسابك وSign out (تسجيل الخروج) في أسفل القائمة.
المبيعات
الطلبات
- كل طلبات الشركة. أيقونة الفلتر تفتح البحث، والحالة، وحالة الدفع، ونطاق التاريخ، ومندوب المبيعات، وفلتر المؤرشف؛ ويعرض العنوان عدد الفلاتر النشطة. أيقونة التحديث تعيد التحميل من الخادم.
- + ينشئ طلباً: عميل أو Walk-in quick order (طلب سريع بدون موعد)، وتاريخ الطلب ووقته، والبنود، وApply VAT (تطبيق ضريبة القيمة المضافة)، وملاحظة، ثم إما Save as draft (حفظ كمسودة) ("Draft orders skip inventory/credit checks until confirmed" — المسودات تتخطى فحوصات المخزون والائتمان حتى التأكيد) أو التأكيد.
- افتح طلباً: Confirm order (تأكيد الطلب) للمسودات، وCollect payment (تحصيل الدفع)، وتعديل البنود أو تسجيل المرتجعات، والطلبات اليدوية المرتبطة، وطباعة/مشاركة الفاتورة. تعرض التنبيهات Pending sync (في انتظار المزامنة) أو Pending approval (في انتظار الموافقة).
الطلبات اليدوية
صندوق وارد لطلبات العملاء (ملاحظة، صور، صوت، فيديو). افتح أحدها لتشغيل الوسائط، أو Assign (تعيين) إلى مندوب مبيعات، أو Convert (تحويل) إلى طلب بنفسك.
مندوبو المبيعات وتقويم الفريق
أنشئ مندوبي المبيعات وعدّلهم، واتصل بهم أو راسلهم عبر واتساب، وحدد نطاق الخصم المسموح لهم. يعرض Team calendar (تقويم الفريق) كل الزيارات المخططة عبر الفريق.
النشاط الميداني
Sales → Field activity يعرض، لتاريخ تختاره، كل مندوب: في الطريق أو لم يبدأ أو انتهى اليوم، مع الساعات والكيلومترات والزيارات والطلبات والمبالغ المحصّلة. اضغط على شخص لعرض الخط الزمني لليوم (البداية، وكل تسجيل دخول وخروج مع نتيجته، والطلبات والدفعات والمصروفات)، والمسار على الخريطة، وأي تسجيلات للزيارات. Exceptions only (الاستثناءات فقط) يصفّي الأيام التي تحتاج إلى نظرة: يوم لم يُنهَ، زيارات طويلة أو خاملة، بُعد عن المحل، محل غير معيّن، GPS مزيّف، ساعة هاتف خاطئة، كيلومترات غير معتادة، قراءة عداد مفقودة. الزيارة التي أرسلها المندوب إلى الإدارة تبقى في الأعلى حتى تزيل العلامة. كل صباح في 05:30 تصلك إشعاراً واحداً داخل التطبيق بقائمة استثناءات الأمس. قراءات العداد وتقرير مسافات المركبات في لوحة التحكم على الويب.
العملاء
- Shops, Vans, Importers (المتاجر، الشاحنات، المستوردون) — سجلات كاملة: جهات الاتصال، وGPS والخريطة، والصور، والاسم العربي، وأرقام ضريبة القيمة المضافة/السجل التجاري، وحد الائتمان وشروط الدفع، وحساب دخول العميل (أنشئه هنا ليتمكن من استخدام تطبيق الطلبات أو البوابة).
- Customer types (أنواع العملاء) وAreas (المناطق) — القوائم المرجعية التي يقوم عليها التسعير والمناطق الجغرافية.
- Assignments (التعيينات) — أي مندوب مبيعات يخدم أي عميل، بشكل دائم أو مؤقت (تغطية الإجازات). Territories (المناطق الجغرافية) تربط المناطق بمندوبي المبيعات؛ Assignment calendar (تقويم التعيينات) يعرض التغطيات المؤقتة عبر الزمن؛ Unassigned (غير معيّن) يسرد العملاء الذين لا يخدمهم أحد؛ Assignment audit (سجل التعيينات) هو سجل التغييرات.
- SP dashboard (لوحة مندوب المبيعات) — نظرة عامة لكل مندوب مبيعات.
- Shop map (خريطة المتاجر) — دبابيس المتاجر وقائمة المراقبة مع الفلاتر. Watch-list (قائمة المراقبة) — العملاء المحتملون الذين وجدهم مندوبو المبيعات: راجع، وأعد التعيين، وحوّل. Churn risk (خطر فقدان العملاء) — العملاء الذين توقفوا عن الطلب.
ينتمي المندوب إلى فرع واحد ويمكنه التحميل من مستودع أو أكثر من مستودعاته (يُحدَّد في نموذج المندوب). تغيير فرع المندوب يُبقي فقط المستودعات داخل الفرع الجديد — راجع التعيينات بعد ذلك.
المخزون
- مخزون المستودع — الأرصدة لكل منتج؛ اختر مستودعاً لعرض تفصيله، أو الكل للإجمالي. مخزون الشاحنة — لكل شاحنة مندوب.
- Load van (تحميل الشاحنة) — انقل منتجات من مستودع إلى شاحنة؛ يعرض كل بند المتاح: N. لا يستطيع المندوبون التحميل إلا من مستودعاتهم المعيّنة.
- التحويل بين المستودعات — نقل المخزون بين المستودعات (مسودة ثم ترحيل).
- Stock adjust (تسوية المخزون) — تصحيح يدوي مع ذكر السبب. Damage write-off (شطب التالف) — إزالة المخزون التالف (يُنشأ مصروف معتمد تلقائياً).
- الجرد — عدّ فعلي لشاحنة واحدة أو مستودع واحد مقابل السجل؛ إكماله يرحّل تسويات الفروق. جرد مفتوح واحد لكل موقع.
- الفروع والمستودعات تُدار من لوحة التحكم على الويب. يُرفض تعطيل أو حذف المستودع الافتراضي، أو آخر مستودع نشط في الفرع، أو مستودع ما زال يحتوي على مخزون أو فيه جرد مفتوح، أو مستودع هو الوحيد لأحد المندوبين — وتوضح الرسالة ما يجب إصلاحه أولاً.
التقارير
من More ← Reports: Sales report (تقرير المبيعات: الطلبات والإيرادات حسب الفترة)، وSales performance (أداء المبيعات: لكل مندوب مبيعات — المبيعات والكراتين والمستحقات والاتجاه وحسب البند)، وProfit report (تقرير الأرباح: الإيرادات والتكلفة والربح)، وExpense report (تقرير المصروفات: حسب الفئة) وExpense summary (ملخص المصروفات: السنة حتى تاريخه حسب الفترة). يبقى آخر تقرير منزّل قابلاً للقراءة بدون اتصال مع تنبيه cached.
المصروفات
More ← Expenses: القائمة، و+ لتسجيل مصروف (الفئة، والمبلغ، والتاريخ، والمركبة، وملاحظة، وصورة الإيصال)، والتعديل، وإدارة Expense categories (فئات المصروفات) وVehicles (المركبات). الإنشاء والتعديل يعملان بدون اتصال.
الكتالوج
More ← Catalog: Products (المنتجات: الاسم والاسم العربي، والصور، وحجم الكرتون، والتكلفة، وسعر لكل نوع عميل، والوسوم)، وCategories (الفئات)، وTags (الوسوم)، وBrands (العلامات التجارية)، وUnits (الوحدات)، وPromotions (العروض الترويجية).
الشحن والمشتريات
More ← Shipping: Countries (الدول)، وSuppliers (المورّدون: مع أرقام ضريبة القيمة المضافة والسجل التجاري)، وContainers (الحاويات: الاستيراد) وPurchases (المشتريات: الشراء المحلي). ترحيل عملية شراء يضيف البضائع إلى مخزون المستودع.
الموافقات
More ← Approvals يحتوي على تبويبين: Discounts (الخصومات) التي طلبها مندوبو المبيعات فوق النطاق المسموح لهم، وCancellations (الإلغاءات) للطلبات الأقدم من يوم إنشائها. لكل طلب زرا Approve (موافقة) وReject (رفض). يُخطَر مندوبو المبيعات في تطبيقهم.
الإعدادات والمستخدمون والطابعة
- Pricing & VAT settings (إعدادات التسعير وضريبة القيمة المضافة) — نسبة الضريبة وخيارات التسعير التي تستخدمها التطبيقات.
- Users (المستخدمون) — حسابات الموظفين والأدوار (مسؤول، مندوب مبيعات، مراقب).
- Printer settings (إعدادات الطابعة) — اقرن طابعة إيصالات بلوتوث (58 أو 80 مم) واطبع صفحة اختبار.
- Profile (الملف الشخصي) — حسابك، واللغة، وتسجيل الدخول بالبصمة، وتسجيل الخروج (يحذّرك التطبيق إذا وُجدت بيانات غير متزامنة).
- Help (المساعدة) — نصائح البداية السريعة، وما يعمل بدون اتصال، وهذا الدليل (موجودة أيضاً في أسفل القائمة).
حل المشكلات
| المشكلة | ما يجب فعله |
|---|---|
| العودة إلى شاشة تسجيل الدخول بعد تسجيل الدخول | الحساب ليس حساب مسؤول. يستخدم المراقبون تطبيق المراقبة، ومندوبو المبيعات تطبيق المبيعات. |
| "3–20 lowercase letters/digits" تحت رمز الشركة | اكتب الرمز تماماً، بدون مسافات أو أحرف كبيرة — وهو الجزء الأول من عنوان لوحة التحكم. |
| "This action requires an internet connection" | الطلبات والمصروفات والتقارير المخزنة فقط تعمل بدون اتصال. أعد الاتصال وحاول مرة أخرى. |
| شريط أحمر بمشكلات مزامنة | اضغط عليه واقرأ الخطأ (حد الائتمان، المخزون، تكرار)؛ أصلح السبب في لوحة التحكم، ثم Retry. |
| الموظفون لا يرون شريط "يتوفر تحديث" | ارفع ملفات APK الجديدة وحدد أحدث رقم بنية لكل تطبيق في الإعدادات المركزية. |
| الطابعة غير موجودة | اقرنها في إعدادات بلوتوث بالهاتف أولاً، ثم اخترها في Printer settings واطبع صفحة اختبار. |
| رابط التنزيل يعرض "403" أو "expired" | الروابط صالحة لمدة 60 دقيقة. افتح Download App في لوحة التحكم مرة أخرى. |
| "لا يمكن التعطيل" / "لا يمكن الحذف" لمستودع أو فرع | انقل مخزونه، أو أكمل الجرد المفتوح أو ألغه، أو اجعل مستودعاً آخر افتراضياً، أو أعد تعيين المندوب المذكور — ثم حاول مرة أخرى. |
| فقد مندوب تعيينات مستودعاته | تغيّر فرعه؛ ولا تبقى إلا مستودعات الفرع الجديد. عيّن المستودعات الصحيحة في نموذج المندوب. |
| هاتف يطلب الرمز باستمرار | تمت إزالته من الأجهزة. اعتمده مرة أخرى أو أنشئ رمزاً جديداً. |