انتقل إلى المحتوى
كل المقالات
Flutterالعمل-بدون-إنترنتتطبيقات-الموبايلالصيانة-الميدانيةدراسة-حالة

تطبيق Flutter بدون إنترنت: مزامنة عمل الفنيين الميدانيين

١٢ نوفمبر ٢٠٢٦ 9 دقيقة قراءة· Mahmoud Makhlouf
Read this article in English

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

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

المشكلة من زاوية صاحب الشركة

الفنيون يعملون حيث تضعف الشبكة: البدرومات، غرف الماكينات، آبار المصاعد، مواقف السيارات تحت الأرض، والمواقع خارج المدن. التطبيق الذي يفترض وجود اتصال دائم يُكلّفك بثلاث طرق:

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

وهناك تكلفة أهدأ: الثقة. الفني الذي يخسر تقريراً مرة واحدة يبدأ بتدوين ملاحظاته على ورقة "احتياطاً"، فيصبح التطبيق عبئاً إضافياً بدل أن يكون أداة العمل.

ما الخيارات المتاحة، وما تكلفة كل منها؟

عبارة "يعمل بدون إنترنت" تعني أشياء مختلفة جداً. حدّد النطاق الذي تدفع مقابله قبل بدء التطوير، لأن إضافته بعد الإطلاق تمس أغلب شاشات التطبيق.

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

أغلب تطبيقات الصيانة الميدانية تحتاج الصف الثالث، وأغلب تطبيقات العضوية والكتالوجات تكفيها الثانية. قليل جداً من الشركات تحتاج الصف الرابع، وهو بالذات ما يَعِد به بعض المورّدين بسهولة.

كيف بنيناه في Montra ERP

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

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

قائمة مهام الفني في التطبيق مع شريط "لا يوجد إنترنت، هذه آخر نسخة محفوظة" وشارة المزامنة بعدد التعديلات التي لم تُرسل بعدقائمة مهام الفني في التطبيق مع شريط "لا يوجد إنترنت، هذه آخر نسخة محفوظة" وشارة المزامنة بعدد التعديلات التي لم تُرسل بعد

أهم القرارات:

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

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

من الداخل: الطابور المرتب

الطابور (Outbox) قائمة عمليات محفوظة في ملف JSON صغير داخل مجلد التطبيق. كل عملية تساوي طلب API واحداً بالضبط: تغيير حالة، أو تقرير، أو قائمة فحص، أو رفع صورة، أو قراءة عداد. الكتابة على الملف متسلسلة حتى لا يتداخل تعديلان سريعان، وكل كتابة تذهب أولاً إلى ملف مؤقت ثم يُعاد تسميته، فلا يبقى الطابور نصف مكتوب إذا توقف التطبيق فجأة.

 tap "arrive"  ──► try API ──ok──► update screen
                      │
                  network down
                      ▼
               outbox.json  [arrive, photo, report, complete]
                      │
   every 30 s / app resumed / job opened
                      ▼
          send in order, one at a time
     ok ─► remove     network error ─► stop, retry later
     rejected ─► remove + show to technician

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

for (final op in store.outbox) {
  try {
    await send(op);
    await store.remove(op.id);
  } on ApiException catch (e) {
    if (isOffline(e)) {               // no network or a 5xx
      await store.markAttempt(op, e.code);
      break;                          // keep order, try again later
    }
    // The server said no. A status change it already applied
    // (sent before the signal dropped) is not a failure.
    final alreadyDone = op.kind == 'transition' && e.code == 'INVALID_TRANSITION';
    if (!alreadyDone) failures.add(SyncFailure(op.kind, op.jobNumber, e.code));
    await store.remove(op.id);
  }
}

لماذا نعتبر رفض "انتقال غير صالح" نجاحاً؟

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

في المزامنة التالية يرسل الهاتف "وصلت" مرة أخرى. آلة حالات أمر العمل مكتوبة مرة واحدة في حزمة مشتركة يستخدمها الخادم ولوحة الويب والتطبيق، وهي لا تسمح بـ"وصلت" إلا من حالة "مقبولة" أو "في الطريق". المهمة الآن "في الموقع"، فيرفض الخادم بالرمز INVALID_TRANSITION.

هذا الرفض نفسه هو الدليل على أن المحاولة الأولى نجحت. بدل بناء جدول منفصل لمنع تكرار تغييرات الحالة، حصلنا على عدم التكرار (Idempotency) من آلة الحالات ذاتها: انتقال مكرر لا يمكن أن يُطبَّق مرتين، والتطبيق يقرأ هذا الرفض تحديداً على أنه "تم من قبل" لا على أنه خطأ.

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

نمط ثانٍ: دليل مراكز يعمل بدون اتصال في تكافل الذهبية

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

دليل المراكز الطبية مع نتائج بحث بالعربي ومرشحات المدينة والتخصصدليل المراكز الطبية مع نتائج بحث بالعربي ومرشحات المدينة والتخصص

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

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

إبعاد الردود الكبيرة عن الخيط الرئيسي

الدليل ملف JSON كبير، وتحليله له تكلفة تغيّرت مؤخراً. منذ Flutter 3.29 أصبح كود Dart على Android وiOS يعمل على الخيط الرئيسي للتطبيق، بلا خيط UI منفصل. أي تحليل طويل هناك يجمّد الواجهة، وعلى Android قد يظهر للمستخدم مربع "التطبيق لا يستجيب".

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

const backgroundParseThreshold = 50 * 1024;

Future<List<T>> decodeListInBackground<T>(String body, T Function(Map<String, dynamic>) fromJson) {
  if (body.length < backgroundParseThreshold) {
    return Future.sync(() => decodeList(body, fromJson));
  }
  return Isolate.run(() => decodeList(body, fromJson));
}

وفي جهة الإرسال، يعيد عميل HTTP في التطبيق محاولة الطلب الفاشل ثلاث مرات، بانتظار ثانية ثم ثانيتين ثم ثلاث. وكل طلب POST أو PUT أو PATCH أو DELETE يحمل ترويسة X-Idempotency-Key تُولَّد مرة واحدة للطلب وتبقى ثابتة في المحاولات المعادة، فيستطيع الخادم الذي يدعمها أن يتعرّف على التكرار بدل إنشاء سجل ثانٍ.

قائمة أسئلة قبل توقيع العقد

إذا كان العمل بلا شبكة مهماً لشركتك، اكتبه في المواصفات واسأل المورّد هذه الأسئلة صراحة:

  1. أي الشاشات يجب أن تعمل بلا شبكة؟ وهل المطلوب قراءة فقط أم تسجيل عمل أيضاً؟
  2. أين تُحفظ التعديلات أثناء الانقطاع؟ وهل تبقى إذا أُغلق التطبيق أو أُعيد تشغيل الهاتف أو نظّف النظام الملفات المؤقتة؟
  3. بأي ترتيب تُرسل التعديلات المؤجلة؟ وماذا يحدث لما بعدها إذا فشل أحدها؟
  4. إذا وصل الطلب إلى الخادم وضاع الرد، كيف تمنعون تطبيقه مرتين؟
  5. أي وقت يُسجَّل: وقت تنفيذ الفني للإجراء أم وقت استلام الخادم له؟
  6. إذا رفض الخادم تعديلاً مؤجلاً، هل يرى المستخدم أي تعديل رُفض ولماذا؟
  7. كيف يعرف المستخدم أن ما يراه نسخة محفوظة، وكم عمرها؟
  8. كيف ستختبرون ذلك: وضع الطيران، شبكة ضعيفة، إغلاق التطبيق أثناء المزامنة، وعلى أجهزة حقيقية؟

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

الأسئلة الشائعة

ما معنى أن يكون التطبيق Offline-first؟

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

هل يمكن لتطبيقات Flutter أن تعمل بدون إنترنت؟

نعم. يستطيع تطبيق Flutter حفظ البيانات محلياً عبر الملفات أو Hive أو SQLite وغيرها، وتشغيل المزامنة عند العودة إلى التطبيق أو على مؤقت. الإطار نفسه لا يحدد سلوك العمل بلا شبكة، بل تصميم التطبيق. ويجب أن يُصمَّم لكل ميزة على حدة، بقواعد واضحة للترتيب وإعادة الإرسال والتعارض.

كيف نمنع تكرار الطلب عندما تنقطع الشبكة؟

بجعل التكرار غير مؤذٍ. في تغييرات الحالة، آلة حالات في الخادم لا تسمح بكل خطوة إلا من حالات محددة تحوّل التكرار إلى رفض بدل سجل مكرر. وفي إنشاء السجلات، مفتاح Idempotency يُرسل مع الطلب يسمح للخادم بالتعرف على المحاولة المعادة. تعطيل الزر وحده لا يكفي، لأن التكرار يأتي غالباً من إعادة الإرسال التلقائية.

كم مدة الاحتفاظ بالبيانات المحفوظة على الهاتف؟

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

هل يرفع العمل بدون إنترنت تكلفة التطبيق كثيراً؟

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

الخطوة التالية

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

// لنبدأ

عندك فكرة منتج؟ خذ خطة واضحة و مكالمة تعارف مجانية 15 دقيقة.

احكِ لنا عن مشروعك، ونرجع لك بتصوّر للتنفيذ وجدول زمني مبدئي وتقدير أولي للتكلفة — عادةً خلال 24 ساعة.

احجز مكالمة مجانية WhatsApp