بوت تيليجرام للسائقين

بوت تيليجرام للسائقين هو نظام للإشعارات التلقائية وإدارة الرحلات. يسجّل السائق مرة واحدة عبر رابط يصله برسالة SMS، وبعدها تصله جميع الأوامر النشطة في Telegram. يتيح البوت تأكيد الرحلات وتغيير حالات التنفيذ مباشرة من داخل تطبيق المراسلة.

تسجيل السائق في النظام

كيف يعمل ذلك؟

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

الخطوة 1. أضف السائق إلى بطاقة الرحلة

1. افتح قسم إنشاء رحلة جديدة
2. انقر على «إضافة وسيلة نقل» (Add Transportation)
3. املأ بيانات السائق:
   • الاسم الأول (First Name)
   • اسم العائلة (Last Name)
   • رقم الهاتف (Phone Number)
4. احفظ بطاقة الرحلة

الخطوة 2. يتحقق النظام من السائق

• ✅ يتحقق النظام تلقائيًا من رقم الهاتف في قاعدة البيانات
• ✅ إذا كان السائق مسجلًا بالفعل — تصله فورًا رسالة عن الرحلة الجديدة
• 📱 إذا كان السائق جديدًا — تُرسَل رسالة SMS إلى رقمه

الخطوة 3. يسجّل السائق عبر SMS

1. يستلم السائق رسالة SMS تحتوي على رابط إلى بوت Telegram
2. يفتح الرابط وينقر على «ابدأ» (Start)
3. يحفظ النظام معرّف Telegram الخاص بالسائق
4. ✅ اكتمل التسجيل — يمكن للسائق الآن استلام الرحلات

العمل مع الرحلات عبر البوت

كيف يستلم السائق الرحلات؟

بعد التسجيل، تصل جميع الأوامر النشطة إلى السائق تلقائيًا في Telegram.

الخطوة 1. استلام رسالة عن رحلة جديدة

• يستلم السائق رسالة: «لديك رحلة جديدة»
• تعرض الرسالة معلومات عن المسار والحمولة والوقت
• أسفل الرسالة يوجد زر «تأكيد» (Confirm / Approve)

الخطوة 2. تأكيد الرحلة

1. ينقر السائق على زر «تأكيد»
2. يسجّل النظام أن السائق اطّلع على الأمر
3. ينتقل البوت إلى العمل مع حالات الرحلة

الخطوة 3. تغيير حالات الرحلة

يستلم السائق أزرارًا لتغيير الحالة:

• 🚗 «انطلق إلى التحميل» (Departed for loading)
• 📍 «وصل إلى التحميل» (Arrived at loading)
• ⚖️ «تم التحميل» (Loaded)
• 🚗 «انطلق إلى التفريغ» (Departed for unloading)
• 📍 «وصل إلى التفريغ» (Arrived at unloading)
• ✅ «تم التفريغ» (Unloaded)

ينقر السائق على الزر المناسب في كل مرحلة، فتتحدّث حالة الرحلة تلقائيًا في النظام.

💡 نصائح وأخطاء محتملة

نصائح:

• ✓ تحقق دائمًا من صحة رقم هاتف السائق — فوصول رسالة SMS يعتمد على ذلك
• ✓ نبّه السائقين إلى أنهم سيستلمون رسالة SMS تحتوي على رابط — حتى لا يفوّتوا التسجيل
• ✓ يمكن للسائق التسجيل لاحقًا — الرابط في رسالة SMS لا تنتهي صلاحيته
• ✓ رقم هاتف واحد = حساب واحد. إذا غيّر السائق رقمه، أضفه كسائق جديد

⚠️ أخطاء محتملة:

🎯 ما تعلمته

أنت تعرف الآن كيف يعمل نظام تسجيل السائقين وإدارة الرحلات عبر Telegram. يسجّل السائق مرة واحدة عبر رابط في رسالة SMS، وبعدها تتم جميع الرحلات وتغييرات الحالات تلقائيًا عبر البوت. هذا يوفّر الوقت ويبسّط التواصل مع السائقين.

📦 العمل مع الرحلات عبر بوت تيليجرام

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

استلام رحلة جديدة

كيف يعمل ذلك؟

عندما ينشئ منسّق الحركة (dispatcher) رحلة ويعيّن سائقًا، تصل إلى السائق رسالة في Telegram تلقائيًا.

الخطوة 1. استلم رسالة الرحلة

1. ستصلك رسالة: «رحلة جديدة» (New Voyage)
2. انقر على زر «عرض الرحلة» (View Voyage)

الخطوة 2. اطّلع على معلومات الرحلة

سترى جميع التفاصيل:

• رقم الرحلة (Voyage #) — رقم فريد (مثلًا، f3e228e1...)
• المركبة (Vehicle): لوحة الترخيص (مثلًا، ВН5903ІС)
• المقطورات (Trailers): لوحات ترخيص المقطورات (مثلًا، ВН5534ХІ، ВН5535ХІ)

المسار (Route):

• 📍 النقطة A (Point A): عنوان التحميل الكامل (مثلًا، 123 Main Street, Kyiv)
• 📍 النقطة B (Point B): عنوان التفريغ الكامل (مثلًا، 456 Oak Street, Lviv)

التاريخ التقديري (Estimated date): فترة تنفيذ الرحلة (مثلًا، 2025-03-13 - 2025-03-16 حتى 12:00:00)

الحمولة (Cargo):

• تم التحميل: غير محدد
• تم التفريغ: غير محدد

الحالة (Status): مُعلَنة (Announced)

الخطوة 3. اتخذ القرار

في أسفل الرسالة يوجد زران:

• ✅ تأكيد الرحلة (Confirm Voyage) — تقبل الأمر
• ❌ رفض الرحلة (Reject Voyage) — ترفض الرحلة

تأكيد الرحلة أو رفضها

✅ الخيار 1. تأكيد الرحلة

الخطوة 1. انقر على زر «تأكيد الرحلة»

الخطوة 2. سترى رسالة التأكيد:

✅ تم تأكيد الرحلة بنجاح! يمكنك الآن عرض الرحلة الحالية

الخطوة 3. سترى زر «الرحلة الحالية» (Current Voyage)

• سيختفي زر «رحلة جديدة»
• تُعتبر الرحلة الآن نشطة

❌ الخيار 2. رفض الرحلة

الخطوة 1. انقر على زر «رفض الرحلة»

⚠️ مهم:

• تبقى الرحلة في النظام
• يمكنك إعادة النظر وقبولها لاحقًا
• لا تختفي الرحلة ولا تُنقل إلى سائق آخر

لقبول رحلة مرفوضة:

1. انقر على «عرض الرحلة»
2. انقر على «تأكيد الرحلة»

العمل مع الرحلة الحالية

كيف تعرض الرحلة النشطة؟

بعد تأكيد الرحلة، يمكنك متابعة تنفيذها وتغيير حالاتها.

الخطوة 1. افتح الرحلة الحالية

1. انقر على زر «الرحلة الحالية»
2. سترى معلومات الرحلة نفسها
3. الحالة: تعرض الآن مقبولة (Accepted)

الخطوة 2. ابدأ تنفيذ الرحلة

أسفل معلومات الرحلة سيظهر زر:

🚗 «الانطلاق إلى التحميل» (Depart for Loading)

انقر عليه عندما تبدأ التحرك نحو نقطة التحميل.

⚖️ إدخال وزن الحمولة

متى يلزم إدخال الوزن؟

بعد وصولك إلى التحميل، يلزم إدخال بيانات الوزن: الوزن الإجمالي (gross — الوزن الكلي) والوزن الفارغ (tare — وزن المركبة).

الخطوة 1. افتح الرحلة الحالية

• انقر على «الرحلة الحالية»
• تغيّرت حالة الرحلة بعد النقر على «الانطلاق إلى التحميل»

الخطوة 2. أدخل الوزن الإجمالي

سيرسل البوت رسالة: «أدخل الوزن الإجمالي بالأطنان»

💡 تلميح:

• الصيغة: 20.5
• مثال: 25.5 أو 30.25

1. أدخل الوزن الإجمالي كرقم (مثلًا، 30.2)
2. أرسل الرسالة

الخطوة 3. أدخل الوزن الفارغ

بعد تأكيد الوزن الإجمالي، سيرسل البوت: «الإجمالي: 30.2 طن»

وسيطلب البوت إدخال الوزن الفارغ: «أدخل الآن الوزن الفارغ بالأطنان»

💡 تلميح:

• الصيغة: 2.5
• مثال: 2.3 أو 3.15

1. أدخل الوزن الفارغ كرقم (مثلًا، 10)
2. أرسل الرسالة

الخطوة 4. تحقق من البيانات

سيعرض البوت جميع المعلومات:

⚖️ الإجمالي: 30.2 طن
⚖️ الفارغ: 10.5 طن
⚖️ الصافي: 20.20 طن (يُحسب تلقائيًا)

سيسأل البوت: «هل هذا صحيح؟»

سترى زرين:

• ✅ كل شيء صحيح (All correct) — ستُحفظ البيانات
• 🔄 إدخال مرة أخرى (Enter again) — يمكنك تصحيح الخطأ

الخطوة 5. أكّد أو صحّح

• إذا كان كل شيء صحيحًا — انقر على «كل شيء صحيح»
• إذا أخطأت — انقر على «إدخال مرة أخرى» وكرّر الإدخال

💡 نصائح وأخطاء محتملة

نصائح:

• ✓ راجع جميع معلومات الرحلة قبل التأكيد
• ✓ إذا رفضت الرحلة عن طريق الخطأ — يمكنك قبولها لاحقًا
• ✓ أدخل بيانات الوزن بعناية — فالبيانات الخاطئة قد تسبب مشاكل أثناء التفريغ
• ✓ تحقق دائمًا من المعلومات النهائية قبل النقر على «كل شيء صحيح»
• ✓ استخدم النقطة وليس الفاصلة للأرقام العشرية (30.2 وليس 30,2)

⚠️ أخطاء محتملة:

🎯 ما تعلمته

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

🔄 دورة تنفيذ الرحلة الكاملة

بعد إدخال وزن التحميل، تنتقل الرحلة إلى حالة «في الطريق» (In Transit). يمرّ السائق بجميع المراحل: السير، والوصول، والفحص، والتفريغ، وإنهاء الرحلة مع معالجة المستندات.

🚗 الحالة «في الطريق»

كيف يعمل ذلك؟

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

الخطوة 1. حصلت الرحلة على حالة «في الطريق»

انقر على «الرحلة الحالية» (Current Voyage)

سترى المعلومات المحدّثة:

⚖️ الحمولة:
  تم التحميل:
    الإجمالي: 50.0 طن
    الصافي: 45.0 طن
    الفارغ: 5.0 طن
  تم التفريغ: غير محدد

📊 الحالة: في الطريق

الخطوة 2. اختر الإجراء

أسفل معلومات الرحلة يظهر زران:

• ⏰ «تأخير» (Delayed) — إذا لم تكن ستصل في الموعد
• 📍 «وصلت» (Arrived) — عند وصولك إلى نقطة التفريغ

⏰ الإبلاغ عن التأخير

متى تستخدمه؟

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

الخطوة 1. أبلغ عن التأخير

1. انقر على زر «تأخير»
2. يسجّل النظام التأخير
3. يستلم منسّق الحركة (dispatcher) إشعارًا

الخطوة 2. واصل السير

• تبقى حالة الرحلة «في الطريق»
• عند وصولك، انقر على «وصلت»

📍 الوصول إلى نقطة التفريغ

ماذا يحدث عند الوصول؟

عندما تنقر على «وصلت»، يرسل النظام تلقائيًا رسائل SMS إليك وإلى محطة التفريغ.

الخطوة 1. أكّد الوصول

1. بعد الوصول إلى عنوان التفريغ، انقر على «وصلت»
2. الحالة (Status): تتغير إلى وصل (Arrived)

الخطوة 2. رسائل SMS

يحدث تلقائيًا ما يلي:

• 📱 تستلم أنت رسالة SMS: «لقد وصلت إلى المحطة. انتظر الاستدعاء للفحص»
• 📱 تستلم المحطة رسالة SMS: «وصل السائق [اسمك]. المركبة [الرقم]»

الخطوة 3. انتظر الاستدعاء

• ستستلم المحطة الرسالة وتستدعيك للفحص
• تابع الإعلانات أو انتظر رسالة SMS/مكالمة من المحطة

🔬 الفحص في المحطة

ما هو الفحص؟

الفحص هو إجراء للتحقق من الحمولة: تُؤخذ عينات من الحبوب ويُجرى وزن مراقبة. وبناءً على النتائج يتقرر ما إذا كانت الحمولة ستُقبل للتفريغ.

الخطوة 1. سيتم استدعاؤك للفحص

1. ستستدعيك المحطة (برسالة SMS أو إعلان أو شخصيًا)
2. توجّه إلى نقطة الفحص وفق تعليمات المحطة

الخطوة 2. الحالة «قيد الفحص»

عندما تكون في نقطة الفحص، تتحدّث الحالة تلقائيًا:

الحالة: قيد الفحص (At Inspection)

سيقوم مختصو المحطة بما يلي:

• 🧪 أخذ عينات من الحبوب للتحليل
• ⚖️ إجراء وزن مراقبة عند الحاجة
• ✅ التحقق من جودة الحمولة

الخطوة 3. انتظر نتائج التحليل

إذا كانت نتائج التحليل جيدة:

• ✅ سيتم توجيهك إلى التفريغ
• تتغير الحالة إلى «في التفريغ» (At Unloading)

إذا كانت نتائج التحليل لا تستوفي المتطلبات:

• ❌ قد يُرفض قبول الحمولة
• 📞 تواصل مع منسّق الحركة للحصول على تعليمات إضافية

📦 تفريغ الحمولة

كيف يعمل ذلك؟

بعد اجتياز الفحص بنجاح، تتوجه إلى التفريغ. بعد التفريغ، يلزم إدخال بيانات الوزن وإرفاق صورة بوليصة الشحن (TTN).

الخطوة 1. الحالة «في التفريغ»

1. بعد الفحص تتغير الحالة: إلى في التفريغ
2. توجّه إلى نقطة التفريغ المحددة
3. فرّغ الحمولة وفق تعليمات المحطة

الخطوة 2. أدخل الوزن بعد التفريغ

1. بعد التفريغ، انقر على «الرحلة الحالية»
2. سيرسل البوت: «⚖️ أدخل الوزن الإجمالي بعد التفريغ بالأطنان»
3. أدخل الوزن الإجمالي (مثلًا، 5.2)
4. سيرسل البوت: «⚖️ أدخل الآن الوزن الفارغ بالأطنان»
5. أدخل الوزن الفارغ (مثلًا، 5.0)

الخطوة 3. تحقق من بيانات التفريغ

سيعرض البوت الحساب:

⚖️ الإجمالي: 5.2 طن
⚖️ الفارغ: 5.0 طن
⚖️ الصافي: 0.2 طن (ما تبقّى بعد التفريغ)

السؤال: «هل هذا صحيح؟»

• ✅ كل شيء صحيح (All correct) — ستُحفظ البيانات
• 🔄 إدخال مرة أخرى (Enter again) — صحّح الخطأ

الخطوة 4. صوِّر بوليصة الشحن (TTN)

1. بعد تأكيد الوزن، سيطلب البوت: «أرفق صورة بوليصة الشحن (TTN)»
2. صوِّر بوليصة الشحن
3. أرسل الصورة في دردشة البوت

📸 تأكد من أن الصورة تُظهر بوضوح:

• رقم بوليصة الشحن (TTN)
• التاريخ
• الوزن
• التوقيعات والأختام

الخطوة 5. إنهاء الرحلة

✅ بعد إرفاق صورة بوليصة الشحن (TTN)

الحالة: تتغير تلقائيًا إلى تم التفريغ (Unloaded)

🎉 اكتملت الرحلة بنجاح!

📋 المعلومات الكاملة عن الرحلة المكتملة

بعد إنهاء الرحلة، يمكنك عرض جميع المعلومات:

🚛 رقم الرحلة # f3e228e1...
🚗 المركبة: ВН5903ІС12212131
🚚 المقطورات: ВН5534ХІ, ВН5535ХІ

📍 المسار:
   123 Main Street, Kyiv
   ↓
   456 Oak Street, Lviv

📅 التاريخ التقديري:
   2025-03-13 - 2025-03-16 (حتى 12:00:00)

⚖️ الحمولة:
   تم التحميل:
     الإجمالي: 50.0 طن
     الصافي: 45.0 طن
     الفارغ: 5.0 طن

   تم التفريغ:
     الإجمالي: 5.2 طن
     الصافي: 0.2 طن
     الفارغ: 5.0 طن

📊 الحالة: تم التفريغ ✅

🔄 مخطط جميع حالات الرحلة (المسار القياسي — Happy Flow)

💡 نصائح وأخطاء محتملة

نصائح:

• ✓ أبلغ عن التأخير مسبقًا — فهذا يساعد المحطة على تعديل الجدول
• ✓ أثناء الفحص، احتفظ بمستندات الحمولة معك
• ✓ صوِّر بوليصة الشحن (TTN) في إضاءة جيدة — يجب أن يكون المستند مقروءًا
• ✓ احتفظ بأصل بوليصة الشحن حتى اكتمال الرحلة بالكامل
• ✓ تحقق من بيانات الوزن قبل التأكيد — فمن الصعب تصحيح الخطأ بعد الإنهاء

⚠️ أخطاء محتملة:

🎯 ما تعلمته

أنت تعرف الآن دورة تنفيذ الرحلة الكاملة من التأكيد إلى الإنهاء. يمكنك:

✅ الإبلاغ عن التأخير

✅ اجتياز الفحص

✅ إدخال بيانات الوزن

✅ إنهاء الرحلة مع بوليصة الشحن (TTN)

كل العمل يتم عبر بوت Telegram دون مكالمات زائدة أو معاملات ورقية! 🚛📱