عميل في جدة طلب قطعة مستعملة من تشليح، ودفع ثمنها، ثم انتظر. مرت ساعة والتطبيق يقول "جاري التوصيل"، والمندوب لا يرد لأنه يقود. في الدقيقة الحادية والستين يفتح العميل محادثة مع الدعم ويطلب استرداد المبلغ.
الإجابة المختصرة: التتبع المباشر والمحادثة داخل التطبيق يجيبان عن سؤال واحد يشغل العميل: هل طلبي يتحرك فعلاً؟ وبناؤهما بشكل صحيح يعني ثلاثة أمور: توزيع الطلب على المناديب لحظياً، وإبقاء الاتصال المستمر حياً عبر الخادم الوسيط وتوفير الطاقة في الجوال، وجمع موقع المندوب فقط أثناء التوصيل ولمن يحق له رؤيته.
نبدأ بالجانب التجاري: لماذا يترك العملاء خدمات الطلب الفوري، وما التكلفة الحقيقية للتتبع، والمحادثة مقابل الاتصال، وخصوصية المندوب. ثم ننتقل إلى طريقة بنائنا لهذه الميزات في أجزاء، سوق قطع غيار السيارات العامل في السعودية، مع مقارنة سريعة بما فعلناه في Montra ERP.
المشكلة التجارية: الصمت يبدو كأنه فشل
العميل في خدمات الطلب الفوري لا يشتري القطعة فقط، بل يشتري الاطمئنان. دفع المال وينتظر شخصاً لا يعرفه. كل دقيقة بلا خبر ترفع احتمال الإلغاء أو الاتصال بالدعم أو عدم العودة أبداً.
وتظهر التكلفة في مواضع واضحة:
- ضغط على خدمة العملاء. سؤال "وين طلبي؟" هو أكثر سؤال يصل لأي نشاط توصيل، وكل مرة يتصل موظفكم بالمندوب وهو في الطريق.
- إلغاء في أسوأ توقيت. العميل الذي يلغي بعد استلام المندوب للقطعة يترك لكم تكلفة مشوار وقطعة مرتجعة وتاجراً أنجز عمله.
- خلافات بلا دليل. إذا اتُّفق على السعر وحالة القطعة بالهاتف، فلا أحد يستطيع إثبات ما قيل.
- وقت المندوب. المندوب الذي يرد على ثلاث مكالمات في كل مشوار يقود أقل.
خريطة عليها علامة تتحرك، ومحادثة تجمع العرض والفاتورة ورسالة "أنا عند الباب"، تزيل أغلب أسباب الاتصال.
ما الذي يكلفه التتبع المباشر فعلاً؟
كثير من أصحاب المشاريع يرون التتبع مجرد خريطة داخل التطبيق. الخريطة هي الجزء الأرخص. التكلفة الحقيقية في أماكن أخرى:
| البند | ماذا يعني عملياً |
|---|---|
| البطارية | تشغيل GPS وإرسال الموقع كل بضع ثوانٍ يستنزف جوال المندوب خلال يوم عمل كامل. الفاصل الزمني بين التحديثات قرار تجاري قبل أن يكون تقنياً. |
| باقة البيانات | كل إرسال صغير، لكن الإرسال المتواصل طوال اليوم يتراكم، وكثير من المناديب على باقات مسبقة الدفع. |
| صلاحيات الخلفية | ليستمر التتبع والشاشة مطفأة أو المندوب في تطبيق آخر، يحتاج Android إلى خدمة أمامية (Foreground Service) مع إشعار ظاهر، ويطلب المتجران تبريراً لاستخدام الموقع في الخلفية. |
| مراجعة المتاجر | يطلب Google Play نموذج إقرار، وإفصاحاً واضحاً داخل التطبيق يظهر قبل طلب الصلاحية، وفيديو قصيراً للميزة. وتشترط إرشادات Apple أن يرتبط استخدام الموقع مباشرة بخدمة التطبيق، وأن تشرحوا الغرض وتأخذوا الموافقة. |
| اتصالات الخادم | كل عميل يتابع الخريطة يبقي اتصالاً مفتوحاً، ويجب ضبط الخادم الوسيط والمهلات لذلك. |
| الخصوصية | أنتم تخزنون أين كان شخص ما دقيقة بدقيقة، وتحتاجون قواعد واضحة لمن يرى ذلك ومتى يتوقف الجمع. |
وحتى وقت كتابة هذا المقال (نوفمبر 2026)، التطبيقات التي تستهدف Android 14 أو أحدث يجب أن تعلن نوع الخدمة الأمامية location مع صلاحية FOREGROUND_SERVICE_LOCATION، وأن تصرّح بهذا الاستخدام في Play Console أيضاً.
المحادثة أم المكالمة؟
المكالمة أسرع لسؤال عاجل واحد. أما في بقية الحالات فالمحادثة أفضل: تعمل والمندوب يقود، وتبقى سجلاً يرجع إليه فريق الدعم عند الخلاف، ويمكن أن تحمل محتوى منظماً مثل عرض سعر أو فاتورة يقبلها العميل بضغطة. أغلب تطبيقات التوصيل الناجحة توفر الاثنين، وتجعل المحادثة هي القناة الأساسية.
خصوصية موقع المندوب
موقع المندوب بيانات شخصية. قاعدتنا بسيطة: نتتبع فقط أثناء توصيل بدأه المندوب بنفسه، ولا يرى الموقع إلا عميل هذا الطلب والمندوب، ويتوقف التتبع فور التسليم أو الإلغاء. أي توسع بعد ذلك يحتاج سبباً قوياً وموافقة صريحة.
كيف بنيناها في أجزاء
أجزاء سوق متعدد الأطراف لقطع غيار وخدمات السيارات: متجر قطع، وخدمات سيارات عند الطلب، وقسم "التشليح" حيث يطلب العميل قطعة مستعملة فيبحث عنها مندوب مستقل ويوصلها. الميزات اللحظية تعمل على خادم NestJS واحد، ولوحة ويب بـ Next.js للإدارة والشركاء، وتطبيقات Flutter للعملاء والمتاجر والمناديب. والمحادثة وحدها موجودة في أربعة أقسام: طلبات المتاجر، والطلبات الخاصة الموجهة للمتاجر، وطلبات المناديب، ودعم الإدارة.
قائمة الطلبات في تطبيق المندوب ويظهر فيها طلب تشليح جديد يصل لحظياً وآخر يختفي بعد قبول مندوب آخر له
مسار طلب التشليح كالتالي:
- يرسل العميل طلب القطعة، فيبثه الخادم إلى كل المناديب المتصلين في اللحظة نفسها.
- أول مندوب يقبل يأخذ الطلب، ويختفي من قوائم بقية المناديب فوراً مع ذكر السبب.
- تُفتح محادثة بين العميل والمندوب. يرسل المندوب عرض السعر والفاتورة داخل المحادثة، ويدفع العميل من التطبيق.
- لا يبدأ التوصيل إلا بوجود عرض مقبول وفاتورة ودفع مكتمل. ويختار المندوب طريقة التوصيل: بنفسه، فيبدأ التتبع المباشر، أو عبر شركة شحن، فيدخل رقم الشحنة ويراه العميل في المحادثة.
- يتابع العميل المندوب على الخريطة حتى التسليم، ثم تُغلق المحادثة برسالة من النظام.
وإذا لم يقبل أي مندوب الطلب خلال 15 دقيقة، ينتهي تلقائياً ويختفي من قوائم الجميع.
شاشة تتبع المندوب في تطبيق العميل مع خط المسار ونقطتي البداية والوجهة وعلامة المندوب وهي تتحرك
من الداخل: اتصال واحد وغرف كثيرة
كل ذلك يعمل عبر Socket.IO. والقرار الذي جعله موثوقاً هو ألا نعتمد على "الشاشة المفتوحة حالياً عند المستخدم".
Rider app ──POST /rep-orders/:id/track──▶ API ──save ping──▶ PostgreSQL
│
└─emit rep-location-update─▶ room rep-order:{id}
│
Customer app ◀── WebSocket (via nginx /socket.io/) ◀───────────────────┘
New request ─▶ emit new-rep-order ─▶ room "representatives" (every rider)
Accept / expire / cancel ─▶ emit rep-order-removed {reason} ─▶ same room
Chat message ─▶ emit new-message ─▶ chat room + user:{a} + user:{b}
عند الاتصال يتحقق الخادم من رمز الدخول (JWT) المرسل مع المصافحة، ويحمّل المستخدم، ويرفض الحسابات الموقوفة أو غير النشطة. بعدها يضم الاتصال إلى غرفة شخصية user:{id}، ويضم المناديب أيضاً إلى غرفة مشتركة اسمها representatives. لا يحتاج المندوب إلى فتح أي شاشة ليعرف بالطلبات الجديدة.
وأي حدث يجب أن يصل للشخص نرسله إلى غرفة الموضوع والغرف الشخصية في استدعاء واحد:
async handleConnection(client) {
const payload = this.jwt.verify(extractToken(client));
const user = await this.users.findOne({ where: { id: payload.sub } });
if (!user || user.status === 'suspended' || user.status === 'inactive') {
return client.disconnect();
}
client.join(`user:${user.id}`);
if (user.role === 'representative') client.join('representatives');
}
emitNewMessageToUsers(chatRoom: string, userIds: number[], message: object) {
const rooms = [chatRoom, ...userIds.map((id) => `user:${id}`)];
this.server.to(rooms).emit('new-message', message);
}
توثيق Socket.IO ينص على أن الإرسال لعدة غرف في استدعاء واحد يصل لكل اتصال مرة واحدة حتى لو كان في أكثر من غرفة. فالعميل الذي يفتح المحادثة تصله الرسالة مرة واحدة، والعميل الموجود في الشاشة الرئيسية تصله أيضاً. الرسائل تُحفظ في PostgreSQL قبل إرسالها، وإشعار Push يغطي حالة التطبيق المغلق.
التوزيع: بث، ثم سحب، ثم انتهاء
بث الطلب للمناديب إرسال واحد إلى غرفة representatives. الجزء الأصعب هو سحبه. ثلاثة أشياء تزيل الطلب من كل القوائم: قبول مندوب له، أو إلغاء العميل، أو انتهاء المهلة. وكل واحد منها يرسل حدث rep-order-removed مع السبب (accepted أو cancelled_by_customer أو cancelled_by_rep أو expired)، فيعرض تطبيق المندوب "أخذ مندوب آخر هذا الطلب" بدلاً من اختفاء غير مفهوم.
@Cron(CronExpression.EVERY_MINUTE)
async expirePendingRepOrders() {
const cutoff = new Date(Date.now() - 15 * 60 * 1000);
const expired = await this.orders.find({
where: { status: 'pending', createdAt: LessThan(cutoff) },
select: ['id'],
});
if (!expired.length) return;
const ids = expired.map((o) => o.id);
await this.orders.update(ids, { status: 'cancelled', cancelledAt: new Date() });
ids.forEach((id) => this.events.emitRepOrderRemoved(id, 'expired'));
}
ومن تجربة التشغيل: كانت محادثة المندوب تُنشأ عند أول رسالة. فبعد القبول لا يجد التطبيق محادثة يفتحها، ويبقى المندوب في شاشة تفاصيل الطلب. صرنا ننشئ المحادثة في طلب القبول نفسه ونعيد معرّفها، فينتقل التطبيق مباشرة إلى المحادثة، ويفتح إشعار "قبل المندوب طلبك" عند العميل المحادثة نفسها.
شاشة المحادثة بين العميل والمندوب وفيها بطاقة عرض السعر ورسالة الفاتورة ورسالة النظام "بدأ التوصيل"
إبقاء WebSocket يعمل خلف nginx
مكتبة Socket.IO التي نستخدمها في Flutter تتصل عبر WebSocket فقط، دون الرجوع إلى الاستطلاع الدوري (Polling). معنى ذلك أن الميزات اللحظية لن تعمل في الإنتاج إلا إذا كان كل وسيط بين الجوال والخادم يدعم ترقية الاتصال. في أجزاء هذا الوسيط هو nginx:
location /socket.io/ {
proxy_pass http://ajza_api;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
proxy_buffering off;
}
بدون ترويستي Upgrade وConnection ترجع المصافحة كاستجابة HTTP عادية، ولا يستطيع تطبيق الجوال الاتصال أصلاً. ودليل Socket.IO للخوادم الوسيطة ينبه إلى أن proxy_read_timeout يجب أن يتجاوز مجموع فاصل النبض ومهلته، وإلا أغلق nginx الاتصالات الهادئة. ضبطناها على ساعة كاملة حتى لا ينقطع العميل وهو يتابع توصيلاً بطيئاً. ولمسار الاتصال المباشر قسم مستقل في الإعداد، بينما تخضع نقاط تسجيل الدخول ورمز التحقق OTP لحد طلبات أشد من بقية الواجهة البرمجية.
وفي التطبيق نفسه ثلاث عادات أهم من أي إعداد في الخادم:
- إعادة الانضمام للغرف عند كل اتصال. خدمة الاتصال تحفظ الغرف التي طلبتها الشاشات، وتعيد الانضمام إليها كلها عند الاتصال، فيعود كل شيء بعد نفق أو تبديل شبكة.
- إعادة جلب البيانات بعد الاتصال وعند عودة التطبيق للواجهة. الجوال يقطع الاتصال في الخلفية، فنستدعي
ensureConnected()عند العودة، وتستمع الشاشات إلىonReconnectedلتحميل ما فاتها. - لقطة أولاً ثم بث. شاشة التتبع تحمّل آخر موقع معروف عبر REST، ثم تشترك في
rep-location-update. وكل مستمع يعيد دالة تُستدعى عند إغلاق الشاشة، فلا تتراكم مستمعات مكررة عند فتح الخريطة مرة أخرى.
جانب المندوب: الموقع دون استنزاف الجوال
يبدأ التتبع فقط عندما يؤكد المندوب أنه سيوصل بنفسه، ويتوقف عند التسليم أو الإلغاء، ولا يُتتبع إلا طلب واحد في كل مرة. على Android يشغّل تطبيق المندوب خدمة أمامية من نوع location مع إشعار ثابت، وعلى iOS تعمل الخدمة نفسها بمؤقت ضمن صلاحية الموقع في الخلفية التي يمنحها المندوب. وإذا لم يختر "السماح دائماً"، يخبره التطبيق بالإعداد الذي يجب تغييره بالضبط.
كل موقع يُرسل كطلب POST صغير إلى مسار التتبع الخاص بالطلب. وإذا فشلت قراءة الموقع، تعيد الخدمة المحاولة بتأخير متضاعف (ثانيتان ثم أربع ثم ثمانٍ) قبل الإبلاغ عن الخطأ. في نسخ الإنتاج يرسل المندوب موقعه كل ثلاث دقائق. لقطعة مستعملة تُنقل داخل المدينة يكفي هذا لإظهار التقدم، ويحافظ على بطارية المندوب وباقته طوال يوم العمل.
والخادم هو من يفرض قاعدة الخصوصية: المندوب المعيّن وحده يستطيع إرسال مواقع الطلب، وعميل الطلب والمندوب وحدهما يستطيعان قراءة سجل التتبع. والمواقع تذهب إلى غرفة الطلب فقط، لا إلى قناة عامة.
مثال ثانٍ: Montra ERP
في Montra ERP، نظامنا لإدارة الصيانة الميدانية، كانت الحاجة مختلفة: موزع العمل يراقب عدداً كبيراً من الفنيين على لوحة واحدة، والمتصفح لا يرسل بيانات لحظية للخادم. لذلك استخدمنا Server-Sent Events بدلاً من Socket.IO. الفني يرسل مواقعه على دفعات عبر HTTP عادي (قراءة كل 25 متراً، وإرسال كل 30 ثانية أثناء التوجه للمهمة وكل دقيقتين في غير ذلك)، والخادم يوزع الأحداث عبر Redis pub/sub حتى تستطيع أي نسخة من الخادم إيصالها للوحة المتصلة بها. ولكل حدث جمهور محدد، والفني لا يستقبل إلا ما يخصه.
اختبرنا هذا المسار محلياً على نسخة خادم واحدة: 200 فني افتراضي لمدة 3 دقائق، فكان p95 عند 31 ملّي ثانية وp99 عند 41، دون أي أخطاء، مع تخزين 7,200 قراءة موقع.
خريطة التتبع المباشر في لوحة الموزع مع عدة فنيين يتحركون نحو مهامهم
الدرس المشترك بين المشروعين: أرسلوا الموقع من الجوال عبر طلبات HTTP عادية، فهي سهلة الإعادة والتوثيق وتحديد المعدل، واتركوا الاتصال المستمر لدفع التغييرات إلى من يتابع.
قائمة تحقق قبل إضافة التتبع والمحادثة
- حددوا فاصل التحديث حسب نوع الخدمة (طعام، قطع غيار، صيانة) قبل كتابة أي كود، فهو يحدد البطارية والبيانات وحمل الخادم.
- ابدأوا التتبع عند بدء التوصيل وأوقفوه عند التسليم أو الإلغاء، واكتبوا هذه القاعدة في الخادم لا في التطبيق فقط.
- اجعلوا رؤية موقع المندوب مقصورة على أطراف الطلب نفسه.
- جهزوا إقرار الموقع في الخلفية والإفصاح داخل التطبيق والفيديو لـ Google Play، ونصوص الغرض في iOS، قبل موعد الإطلاق.
- تأكدوا أن الخادم الوسيط يرقّي اتصال WebSocket وأن مهلة القراءة أطول من النبض، وجربوا من جوال حقيقي على بيانات الجوال لا من المتصفح فقط.
- تحققوا من هوية المستخدم عند الاتصال، وارفضوا الحسابات الموقوفة هناك.
- أرسلوا الأحداث المهمة إلى غرفة شخصية لكل مستخدم حتى تصل أياً كانت الشاشة المفتوحة.
- اجعلوا لكل طلب مبثوث مهلة انتهاء وحدث "سحب" مع السبب.
- أعيدوا الانضمام للغرف وجلب البيانات بعد كل إعادة اتصال وعند عودة التطبيق.
- احفظوا الرسائل قبل إرسالها، وأرسلوا إشعار Push عندما يكون التطبيق مغلقاً.
الأسئلة الشائعة
كيف يعمل تتبع الطلب المباشر في تطبيقات التوصيل؟
يقرأ تطبيق المندوب موقعه من GPS على فترات محددة ويرسله للخادم. يحفظه الخادم ويدفعه لتطبيق العميل عبر اتصال مستمر مثل WebSocket، فتتحرك علامة المندوب على الخريطة. ويحمّل العميل أولاً آخر موقع معروف ثم يستقبل التحديثات اللحظية.
هل يستنزف التتبع المباشر بطارية جوال المندوب؟
قد يحدث ذلك إذا طلب التطبيق موقعاً عالي الدقة كل بضع ثوانٍ طوال اليوم. اختيار فاصل يناسب طبيعة الخدمة، والتتبع أثناء التوصيل فقط، وتقليل عدد طلبات الشبكة، كلها تبقي الاستهلاك معقولاً. في أجزاء يرسل المندوب موقعه كل ثلاث دقائق أثناء التوصيل.
لماذا يعمل WebSocket على جهاز المطور ويتعطل في الإنتاج؟
السبب الأشهر أن الخادم الوسيط أو شبكة CDN أمام الخادم لا يمرر ترويستي Upgrade وConnection، أو يغلق الاتصالات الهادئة قبل النبضة التالية. ومكتبات Socket.IO في الجوال التي تتصل عبر WebSocket فقط لا تملك بديلاً، فيتعطل الاتصال تماماً. الحل ضبط قسم خاص لمسار الاتصال المباشر ورفع مهلة القراءة.
هل أحتاج موافقة Google Play لاستخدام الموقع في الخلفية؟
نعم، إذا كان التطبيق يصل للموقع في الخلفية. يطلب Google Play إقراراً بالصلاحية، وإفصاحاً واضحاً داخل التطبيق قبل طلب الصلاحية، وفيديو قصيراً يعرض الميزة. والتطبيقات التي تستهدف Android 14 أو أحدث يجب أن تعلن نوع الخدمة الأمامية الخاص بالموقع.
هل الأفضل في تطبيق التوصيل المحادثة أم الاتصال الهاتفي؟
اجعلوا المحادثة هي القناة الأساسية والاتصال للحالات العاجلة. المحادثة تبقى سجلاً مكتوباً عند الخلاف، وتعمل والمندوب يقود، ويمكن أن تحمل عروض الأسعار والفواتير التي يقبلها العميل بضغطة.
الخطوة التالية
إذا كنتم تخططون لتطبيق توصيل أو خدمة عند الطلب، فاكتبوا ثلاثة قرارات قبل الحديث مع أي جهة تنفيذ: كل كم يرسل المندوب موقعه، ومن يحق له رؤيته، وماذا يحدث لطلب لم يقبله أحد. ولفهم الصورة الأوسع راجعوا مقالنا عن تكلفة تطبيق توصيل مثل طلبات وواجهاته الأربع وقائمة تحقق النسخة الأولى من سوق قطع الغيار. وحين تكونون جاهزين، أرسلوا لنا وصف المشروع وسنخبركم كيف سنبنيه وما الذي يتطلبه.