تطبيق الجوال

واجهة Aptli للجوال مصممة للعاملين الميدانيين على الهواتف الذكية والأجهزة اللوحية. ثبّتها مباشرة من متصفحك — دون الحاجة إلى متجر تطبيقات — واحصل على وصول يعمل بنهج دون اتصال أولاً إلى مهامك الموكلة، وماسح QR لاستلام المخزون، وإنشاء التقارير مع GPS والتقاط الصور، ورسم الخرائط. تركّز تجربة الجوال على التنفيذ؛ أما مهام الإدارة فتبقى على سطح المكتب.

ما هو PWA؟

تطبيق الويب التقدمي = موقع ويب قابل للتثبيت يعمل كتطبيق أصلي:

التثبيت: ١. افتح Aptli في متصفح الجوال (Chrome، Safari، Edge) ٢. يعرض المتصفح مطالبة "تثبيت التطبيق" ٣. اضغط على "تثبيت" ← يضيف رمزاً إلى الشاشة الرئيسية ٤. يفتح في وضع ملء الشاشة (دون واجهة المتصفح)

المزايا مقارنة بمتصفح الجوال:

• تشغيل أسرع (مُخزَّن مؤقتاً على الجهاز)
• يعمل دون اتصال (تخزين مؤقت عبر service worker)
• إشعارات فورية
• اختصارات على الشاشة الرئيسية لوظائف محددة
• أداء أفضل (أصول محسّنة)

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

لا حاجة إلى متجر تطبيقات:

• لا توجد عملية موافقة من Apple/Google
• تُنشر التحديثات فوراً (لا يوجد تأخير في مراجعة متجر التطبيقات)
• قاعدة الكود نفسها مثل إصدار الويب (كفاءة في الصيانة)

نطاق الجوال

مُتضمَّن - وظائف التنفيذ:

• ✅ عرض المهام الموكلة (كلها أو ما يخصني فقط)
• ✅ إنشاء تقارير من المهام الموكلة
• ✅ مسح رموز QR (تفويض الاستلام)
• ✅ عرض الخريطة مع الميزات والمهام
• ✅ إنشاء ميزات خريطة بسيطة (نقطة، خط، مضلع)
• ✅ عرض التقارير (كلها أو ما يخصني فقط)
• ✅ رفع الصور إلى التقارير
• ✅ تحرير ملف تعريف المستخدم الخاص
• ✅ التحقق من رقم الهاتف (2FA)
• ✅ طلب المساعدة (نموذج طلب المساعدة)
• ✅ الرد على طلبات المساعدة الموجَّهة إليك

مُستبعَد - وظائف الإدارة:

• ❌ إنشاء مهام موكلة (على سطح المكتب فقط)
• ❌ تعديل المخزون (على سطح المكتب فقط، باستثناء عمليات المسح التي يقوم بها الموظفون المصرَّح لهم)
• ❌ تسجيل ميزات جديدة (المسودات البسيطة مسموح بها، الاستيراد المُجمَّع على سطح المكتب فقط)
• ❌ إضافة أدوار للمستخدمين (على سطح المكتب فقط)
• ❌ العمليات المُجمَّعة (على سطح المكتب فقط)

المبرر:

• ٥٪ من حجم/تعقيد تطبيق سطح المكتب
• تركيز على التنفيذ الميداني
• المهام الإدارية المعقدة أفضل على سطح المكتب

واجهة الجوال

واجهة PWA للجوال — الشاشة الرئيسية، المهام الموكلة، التقارير، وماسح QR

واجهة ماسح رمز QR داخل التطبيق

شريط التنقل السفلي:

• الرئيسية (نظرة عامة سريعة)
• المهام الموكلة (عرض وتصفية)
• التقارير (إنشاء وعرض)
• الخريطة (الميزات، المهام، الرسم)
• الملف الشخصي (إعدادات الحساب)

الاختصارات (الضغط المطوَّل على أيقونة الرئيسية):

• الماسح (قارئ رمز QR)
• تقرير سريع (إنشاء تقرير من الموقع الحالي)
• مهامي (المهام الموكلة مع تمييز مهامي على الخريطة)

دعم الإيماءات:

• التمرير بين علامات التبويب
• السحب للتحديث (تحديث البيانات)
• الضغط المطوَّل لقوائم السياق
• التكبير/التصغير بالقرص على الخريطة

وظيفة الماسح

ماسح رمز QR لاستلام المخزون ومراجع الميزات:

حالات الاستخدام:

• مسح QR استلام المهمة الموكلة ← تفويض نقل المخزون
• مسح علامة QR للميزة ← فتح تفاصيل الميزة
• مسح QR طلب المساعدة ← الرد على مشكلة محددة

سير العمل: ١. اضغط على اختصار الماسح (أو أيقونة الماسح في شريط التنقل السفلي) ٢. تفتح الكاميرا مع عدسة QR ٣. وجّهها نحو رمز QR ٤. كشف وفك تشفير تلقائي ٥. تنفيذ الإجراء (استلام، الانتقال إلى ميزة، إلخ)

تفويض الاستلام: ١. امسح QR استلام المهمة الموكلة ٢. التحقق:

• أنك المستلم المصرَّح له (أو لديك إذن canFacilitatePickups)
• توفر المخزون في موقع المصدر
• موقع GPS (داخل السياج الجغرافي إذا كان مُكوَّناً) ٣. تأكيد الاستلام ٤. تُنشأ معاملة النقل تلقائياً ٥. يُضاف المخزون إلى موقعك الشخصي

مسح QR دون اتصال:

• تُخزَّن عمليات المسح مؤقتاً أثناء عدم الاتصال
• تُعالَج عند عودة الاتصال
• تمنع الاستلام المكرر (منطق إزالة التكرار)

عرض المهام الموكلة

خيارات التصفية:

• جميع المهام الموكلة
• المُسنَدة إلي
• التي أنشأتُها
• الحالة (pending، in-progress، completed)

بطاقة المهمة الموكلة:

• الاسم والوصف
• المستخدمون المسنَدون (الصور الرمزية)
• شارة الحالة
• ملخص أهداف الموارد
• شريط التقدم
• مؤشر تاريخ الاستحقاق

الإجراءات:

• اضغط للاطلاع على التفاصيل
• إنشاء تقرير (زر إجراء سريع)
• عرض رمز QR (إذا كنت مصرَّحاً وكان رمز الاستلام موجوداً)
• تحديث الحالة (in-progress ← completed)

إنشاء التقارير

تدفق التقرير السريع: ١. من المهمة الموكلة ← اضغط "إنشاء تقرير" ٢. معبّأ مسبقاً: المهمة الموكلة، المهام، الاستهلاك المقترح ٣. عدّل القيم الفعلية (ما حدث بالفعل) ٤. اضغط أيقونة الكاميرا ← التقط الصور ٥. يُلتقط GPS تلقائياً (الموقع الحالي) ٦. إرسال ← تُنشأ معاملات الاستهلاك

الحقول المُحسَّنة للجوال:

• أهداف لمس كبيرة (أزرار، مدخلات)
• تحويل الصوت إلى نص للأوصاف
• رفع الصور من الكاميرا أو المعرض
• ملء GPS تلقائياً (أو اختيار يدوي من الخريطة)
• حد أدنى من الحقول المطلوبة (الاسم، العمل المنجز، مصدر الاستهلاك)

إنشاء التقرير دون اتصال:

• إنشاء تقرير أثناء عدم الاتصال
• تُخزَّن الصور محلياً
• إرسال تلقائي عند استعادة الاتصال
• حل التعارضات إذا تغيّرت البيانات على الخادم

عرض الخريطة

الميزات المعروضة:

• جميع الميزات الملتزم بها (من الطبقات)
• المهام القريبة من الموقع الحالي (مرشّح القرب)
• مهامك الموكلة مميّزة (مُرمَّزة بالألوان)

عناصر التحكم في الخريطة:

• محدد الطبقات (تبديل ظهور الميزات)
• زر الموقع الحالي (إعادة التمركز على GPS)
• مبدِّل الخريطة الأساسية (طرق، قمر صناعي، تضاريس)
• بحث (العثور على الميزة بالاسم/المعرف)

الرسم البسيط:

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

مربعات الخريطة دون اتصال:

• تُخزَّن مربعات الخريطة مؤقتاً (انتهاء صلاحية ٣٠ يوماً)
• استراتيجية CacheFirst (تحميل سريع)
• تعمل دون اتصال إنترنت
• تُزامَن الميزات عند عودة الاتصال

نقل المخزون (للموظفين المصرَّح لهم فقط)

الموظفون الذين لديهم إذن canFacilitatePickups:

سير العمل: ١. يصل العامل إلى المستودع ٢. يعرض رمز QR للمهمة الموكلة ٣. يمسح الموظف QR نيابة عن العامل ٤. يتحقق النظام:

• العامل هو المستلم المصرَّح له
• الموظف لديه إذن canFacilitatePickups
• توفر المخزون ٥. يُنفَّذ النقل ٦. تُسجَّل المعاملة من قام بالمسح، ونيابة عن من، وطريقة المسح (ذاتية مقابل بمساعدة الموظف)

إنشاء نقل يدوي: يمكن للموظفين إنشاء عمليات نقل يدوية:

• تحديد موقع المصدر
• تحديد المستلم
• تحديد الموارد والكميات
• تأكيد ← تُنشأ المعاملة

إدارة الملف الشخصي

الحقول القابلة للتحرير:

• الاسم، المسمى، القسم
• رقم الهاتف (مع التحقق)
• تفضيلات الإشعارات
• اختيار اللغة

التحقق من الهاتف: ١. أدخل رقم الهاتف ٢. اضغط "إرسال الرمز" ٣. استلم SMS مع رمز من ٦ أرقام ٤. أدخل الرمز ٥. التحقق من الهاتف (يُمكِّن إشعارات SMS)

المصادقة الثنائية:

• فعّل 2FA من الملف الشخصي
• امسح TOTP QR بتطبيق مصادقة
• أدخل رمزاً من ٦ أرقام للتأكيد
• مطلوب في عمليات تسجيل الدخول المستقبلية

لا يمكن التحرير على الجوال:

• البريد الإلكتروني (قيد أمني)
• الأدوار (وظيفة مسؤول)
• حقوق المسؤول (وظيفة مسؤول)

طلبات المساعدة

إنشاء طلب مساعدة: ١. اضغط "طلب المساعدة" (من الملف الشخصي أو القائمة) ٢. املأ النموذج:

• سطر الموضوع
• الوصف (يدعم تحويل الصوت إلى نص)
• الفئة (تقنية، وصول، مواد، إلخ)
• الأولوية (منخفضة، متوسطة، عالية، عاجلة) ٣. اختياري: إضافة صور ٤. إرسال ← يُرسَل إشعار إلى الفريق المناسب

الرد على طلبات المساعدة:

• اعرض الطلبات الموجَّهة إليك
• أضف تعليقات/ملاحظات
• حدّث الحالة
• ارفع صور الرد
• أغلق عند الحل

الإمكانات دون اتصال

تخزين Service Worker المؤقت:

• استجابات API مُخزَّنة مؤقتاً (انتهاء صلاحية ساعة واحدة)
• مربعات الخريطة مُخزَّنة مؤقتاً (انتهاء صلاحية ٣٠ يوماً)
• غلاف التطبيق مُخزَّن مؤقتاً (تحميل فوري)
• الصور والأصول مُخزَّنة مؤقتاً

إجراءات تعمل بنهج دون اتصال أولاً:

• إنشاء تقارير (إرسال عند الاتصال)
• التقاط صور (رفع عند الاتصال)
• مسودة ميزات الخريطة (مزامنة عند الاتصال)
• عرض المهام/التقارير المُخزَّنة مؤقتاً

مؤشرات المزامنة:

• متصل: نقطة خضراء
• دون اتصال: نقطة رمادية + "X عنصر في انتظار المزامنة"
• مزامنة: أيقونة دوّارة + "جارٍ مزامنة X عنصر..."
• عرض وقت آخر مزامنة

تعليمات التثبيت

iOS (Safari): ١. افتح aptli.com في Safari ٢. اضغط زر المشاركة (مربع مع سهم) ٣. مرّر واضغط "إضافة إلى الشاشة الرئيسية" ٤. اضغط "إضافة" ٥. تظهر أيقونة التطبيق على الشاشة الرئيسية

Android (Chrome): ١. افتح aptli.com في Chrome ٢. اضغط القائمة (ثلاث نقاط) ٣. اضغط "إضافة إلى الشاشة الرئيسية" ٤. اضغط "إضافة" ٥. تظهر أيقونة التطبيق على الشاشة الرئيسية

بديلاً:

• يعرض المتصفح لافتة "تثبيت التطبيق" تلقائياً
• اضغط "تثبيت" عند المطالبة

التحديثات

يُحدَّث PWA تلقائياً:

• لا حاجة إلى تحديثات من متجر التطبيقات
• يُنزَّل الإصدار الجديد في الخلفية
• مطالبة بالتحديث عندما يكون جاهزاً
• نشر فوري للإصلاحات/الميزات

اعتبارات الأمان

التخزين على الجهاز:

• بيانات الجلسة مؤمَّنة على الجهاز
• لا تُخزَّن بيانات حساسة بنص صريح
• تُمحى جميع البيانات المحلية عند تسجيل الخروج

خصوصية GPS:

• يُصل إلى الموقع فقط عند الحاجة (التقارير، استلام QR)
• يُطلب الإذن صراحة
• يمكن الرفض (يُدعم إدخال الموقع يدوياً)
• بيانات GPS مُشفَّرة أثناء النقل (HTTPS)

خصوصية الصور:

• تُخزَّن الصور محلياً حتى تُرفع
• تُحذف بعد الرفع الناجح
• تخزين الخادم مُشفَّر
• يُتحكَّم بالوصول عبر الأذونات

أفضل الممارسات

ثبّت PWA:

• أسرع من متصفح الجوال
• يعمل دون اتصال
• تجربة أفضل

فعّل الإشعارات:

• استلام تحديثات المهام الموكلة
• ردود طلبات المساعدة
• انتهاء صلاحية رموز الاستلام

زامِن بانتظام:

• افتح التطبيق يومياً (حتى دون اتصال)
• تُعالَج الإجراءات في قائمة الانتظار تلقائياً
• يمنع تراكم الأعمال

استخدم الكاميرا:

• تثبت الصور إنجاز العمل
• توثّق مشكلات الجودة
• أسرع من كتابة الأوصاف

أبلغ من الميدان:

• أرسل وأنت لا تزال في الموقع
• الذاكرة الطازجة = تفاصيل دقيقة
• التقاط GPS تلقائي (لا تنسَ الموقع)

خزّن مربعات الخريطة مؤقتاً:

• افتح الخريطة في منطقة الخدمة أثناء الاتصال
• تُخزَّن المربعات لمدة ٣٠ يوماً
• الخريطة قابلة للاستخدام دون اتصال