أتمتة عمليات شركات الشحن بكلود AI: من الاستلام للتسليم

// البرومبت لكلود:
"اكتب Order Intake Module يستقبل طلبات الشحن من:

1. API Integration (للتجار الكبار):
   POST /api/v1/orders
   Body: {shipper_id, recipient_name, recipient_phone,
   address, city, cod_amount, weight, notes}
   Response: {awb_number, tracking_url, pickup_scheduled}

2. Portal للشاحن (واجهة ويب):
   نموذج بسيط يُدخل منه التاجر الصغير بياناته
   يدعم رفع ملف Excel لطلبات متعددة دفعة واحدة

3. واتساب Bot (للطلبات الفردية):
   المستخدم يُرسل: الاسم / الجوال / العنوان / مبلغ COD
   البوت يُنشئ الشحنة ويُرسل AWB كـ PDF

4. التحقق التلقائي:
   - التحقق من صحة رقم الجوال (صيغة سعودية/خليجية)
   - التحقق من اكتمال بيانات العنوان
   - في حالة نقص البيانات: طلب إتمامها تلقائياً"

// البرومبت لكلود:
"اكتب AWB Generation Service:

1. توليد رقم AWB فريد:
   تنسيق: [كود الشركة][سنة][رقم متسلسل]
   مثال: SHC-2026-00001234
   مضمون الفرادة: Atomic Counter في Redis لمنع التكرار

2. طباعة ملصق الشحنة (Label PDF):
   - شعار الشركة
   - رقم AWB كـ Barcode (Code 128) وكنص
   - اسم المستلم والجوال
   - العنوان بخط كبير واضح
   - مبلغ COD بخط أحمر بارز (إذا وجد)
   - اسم الشاحن ورقمه
   - الوزن والملاحظات
   - مربع توقيع المستلم

3. إرسال فوري:
   - AWB PDF لجوال الشاحن عبر واتساب
   - إشعار تأكيد الاستلام للمستلم:
     'سيصلك شحنة [X] قريباً، رقم تتبعك: SHC-2026-00001234'"

// البرومبت لكلود:
"اكتب Daily Route Planning System:

كل صباح الساعة 7:
1. يجمع كل الشحنات المجدولة لليوم
2. يُصنّف حسب المنطقة الجغرافية
3. يُوزّع على السائقين المتاحين مع مراعاة:
   - طاقة كل مركبة (عدد الشحنات / الوزن)
   - أولوية الشحنات المتأخرة
   - مواعيد التسليم المحددة (Time Windows)

4. يُرتّب مسار كل سائق بأقصر طريق:
   Google Maps Directions API مع Waypoints Optimization

5. يُرسل لكل سائق على تطبيقه:
   - قائمة شحناته مرتبة
   - الخريطة مع المسار المحدد
   - أرقام جوال المستلمين

6. تقدير وقت الوصول (ETA) لكل عنوان:
   يُحسب بناءً على ترتيب المسار والمسافة"

// البرومبت لكلود:
"اكتب Automated Status Update System:

المحطات التي تُرسل فيها رسالة تلقائية:

1. عند استلام الشحنة من الشاحن:
   للشاحن: 'تم استلام شحنتك رقم SHC-2026-00001234، وستُسلّم خلال 24-48 ساعة'
   للمستلم: 'لديك شحنة في الطريق من [اسم الشاحن]، التسليم المتوقع غداً'

2. عند خروج الشحنة مع السائق:
   للمستلم: 'سائقنا في طريقه إليك، وصول متوقع بعد X ساعات - [رابط تتبع]'

3. عند قرب الوصول (آخر محطة قبل العنوان):
   للمستلم: 'سائقنا على بُعد 2 كم — يرجى التواجد لاستقبال الشحنة'
   (يُرسل تلقائياً بناءً على GPS السائق)

4. عند التسليم الناجح:
   للشاحن: 'تم تسليم شحنتك للمستلم [الاسم] الساعة [الوقت]'

5. عند تعذّر التسليم:
   للشاحن: 'لم نتمكن من التسليم — [السبب]. سنُعيد المحاولة غداً'"

// البرومبت لكلود:
"اكتب Proof of Delivery (POD) Module في تطبيق السائق:

عند التسليم:
1. السائق يفتح شاشة التسليم
2. يُدخل اسم المستلم الفعلي
3. يأخذ صورة للشحنة عند باب المستلم
4. المستلم يوقّع على شاشة الهاتف (Canvas Signature)
5. يُدخل مبلغ COD المحصّل (إذا وجد)

بعد التأكيد:
- يُحفظ POD: الصورة + التوقيع + الوقت + الموقع GPS
- يُغلق الشحنة تلقائياً في النظام
- يُرسل للشاحن:
  'تم التسليم: صورة + رابط لتحميل وصل التسليم الرقمي'

عند التعذر:
- السائق يختار سبب من قائمة: غائب / رفض / عنوان خاطئ / COD لا يملك فكة
- يأخذ صورة دليل (باب مغلق مثلاً)
- تُجدول محاولة ثانية تلقائياً"

// البرومبت لكلود:
"اكتب COD Reconciliation System:

1. تتبع COD في الوقت الفعلي:
   - كل مبلغ محصّل يُسجّل فوراً عبر تطبيق السائق
   - رصيد كل سائق يُحدَّث تلقائياً
   - تنبيه إذا تجاوز رصيد السائق حداً معيناً

2. تسوية نهاية اليوم:
   تقرير لكل سائق:
   - المبالغ التي كان يجب يجمعها (من الشحنات المُسلَّمة)
   - ما سجّله كمحصّل في التطبيق
   - الفرق (إذا وجد) — يحتاج توضيحاً
   يُرسل للمشرف + للسائق

3. تحويل المبالغ للشاحن:
   بعد تأكيد الاستلام من السائق:
   يُنشئ كشف حساب للشاحن:
   - قائمة الشحنات المُسلَّمة مع COD
   - خصم رسوم الشحن
   - المبلغ الصافي المحوَّل

4. تقرير شهري:
   إجمالي COD المحصّل / المحوّل / المتأخر"

// البرومبت لكلود:
"اكتب Returns Management Module:

1. إنشاء طلب إرجاع تلقائي:
   عند فشل التسليم 3 مرات:
   - يُنشئ Return Shipment برقم RMA تلقائياً
   - يُحدّث حالة الشحنة للشاحن: 'تعذّر التسليم، جارٍ الإرجاع'
   - يُجدوّل استلام الشحنة من المستلم أو من المستودع

2. تتبع المرتجعات:
   نفس تتبع الشحنات الأصلية لكن بحالات مختلفة:
   Return Initiated → Picked Up → In Warehouse → Returned to Shipper

3. تقرير المرتجعات للشاحن:
   أسباب الإرجاع مُصنّفة:
   - غائب (X%) / رفض الاستلام (X%) / عنوان خاطئ (X%)
   هذه المعلومات تُساعد الشاحن في تحسين جودة بياناته

4. معالجة المخزن:
   الشحنة التي وصلت للمستودع كـ Return:
   - فحص الحالة وتوثيق بالصور
   - إشعار الشاحن بجاهزيتها للاستلام أو إعادة الشحن"

// البرومبت لكلود:
"اكتب KPI Dashboard لشركة شحن:

المؤشرات الرئيسية (تُحدَّث تلقائياً):

1. معدل التسليم في الموعد (On-Time Delivery Rate):
   الهدف: 95%+ — التنبيه إذا انخفض عن 90%

2. معدل التسليم من أول محاولة (First Attempt Rate):
   الهدف: 85%+ — الأعلى = تكاليف أقل

3. متوسط وقت التسليم (Average Delivery Time):
   من وقت الاستلام من الشاحن حتى التسليم للمستلم

4. نسبة المرتجعات (Return Rate):
   الهدف: أقل من 10% — أعلى من ذلك = مراجعة الأسباب

5. أداء كل سائق:
   عدد التسليمات / نسبة النجاح / متوسط الوقت / COD محصّل

6. لوحة الإدارة العليا (ملخص يُرسل يومياً):
   إجمالي الشحنات اليوم / مُسلَّمة / متأخرة / مرتجعة /
   COD محصّل / إيراد اليوم"

// البرومبت لكلود:
"اكتب Driver App بـ React Native:

الشاشات الرئيسية:

1. قائمة الشحنات اليومية:
   مرتبة حسب المسار المُحسَّن
   كل شحنة: اسم + رقم + العنوان + مبلغ COD + حالة

2. شاشة التنقل:
   Google Maps مع المسار المحدد مسبقاً
   زر 'وصلت' عند الاقتراب من العنوان

3. شاشة التسليم:
   - أخذ صورة الشحنة
   - توقيع المستلم
   - إدخال مبلغ COD المحصّل
   - ملاحظات (اختياري)
   - زر تأكيد التسليم

4. تعذّر التسليم:
   اختيار السبب من قائمة + صورة دليل

5. وضع بدون إنترنت (Offline):
   يحفظ البيانات محلياً ويرفعها عند عودة الاتصال"