بوت واتساب لشركات الشحن والتوصيل بكلود AI

// البرومبت لكلود:
"أنت مطور بوتات واتساب متخصص في قطاع اللوجستيات الخليجي.
سنبني بوتاً لشركة شحن تعمل في السعودية والإمارات.
التقنية: Node.js + WhatsApp Business API (Meta) + Redis للجلسات.

القائمة الرئيسية عند أول تواصل:
1️⃣ تتبع شحنة
2️⃣ طلب استلام شحنة
3️⃣ حساب تكلفة الشحن
4️⃣ معلومات التخليص الجمركي
5️⃣ تقديم شكوى أو استفسار
0️⃣ التحدث مع موظف

اكتب State Machine كامل للـ Conversation Flow
مع handling لكل حالة وخطأ محتمل.
اللغة: عربية بشكل أساسي مع fallback إنجليزي."

// البرومبت لكلود:
"اكتب AramexService كامل يشمل:

1. trackShipment(awbNumber):
   - استدعاء Aramex Track Shipments API
   - تحويل الاستجابة لرسالة عربية واضحة:
     'شحنتك رقم [AWB] الآن في [الموقع]
     آخر تحديث: [الوقت]
     حالة: [الوصف بالعربية]
     التسليم المتوقع: [التاريخ]'
   - معالجة حالات: شحنة غير موجودة، شحنة تم تسليمها، شحنة موقوفة

2. calculateRate(origin, destination, weight, dimensions):
   - Aramex Rate Calculator API
   - يُعيد: السعر بالريال/درهم، الخدمة (Express/Economy)، المدة

3. createShipment(shipmentData):
   - إنشاء AWB جديد للشحنات الصادرة من العملاء
   - طباعة Label PDF

معالجة أخطاء API:
- Rate Limiting: Queue مع Exponential Backoff
- Timeout: رسالة للمستخدم 'جاري المحاولة...'
- Error codes: ترجمة كل كود خطأ لرسالة عربية مفهومة"

// البرومبت لكلود:
"اكتب Carrier Interface موحّد يدعم أربع شركات شحن:

interface CarrierService {
  track(awb: string): Promise
  calculateRate(params: RateParams): Promise
  createPickup(params: PickupParams): Promise
}

اكتب Implementation لكل من:
- AramexCarrier: Aramex REST API
- SMSACarrier: SMSA Web Services API (SOAP)
- DHLCarrier: DHL Express MyDHL API
- FedExCarrier: FedEx Web Services REST API

التطبيق:
- كل Carrier مستقل وقابل للاختبار منفرداً
- CarrierFactory يختار الشركة الصحيحة بناءً على AWB Format:
  * يبدأ بـ 1: Aramex
  * يبدأ بـ JD: SMSA
  * يبدأ بـ 235: DHL
  * يبدأ بـ 784: FedEx
- الـ TrackingResult موحّد مهما كان الشركة:
  {status, location_ar, location_en, timestamp, next_step_ar}"

// البرومبت لكلود:
"اكتب Shipment Status Watcher Service:

1. عند إنشاء شحنة: يُسجّل AWB في جدول tracked_shipments
   مع رقم واتساب العميل وآخر حالة معروفة

2. Cron Job كل 30 دقيقة:
   - يستعلم عن حالة كل شحنة نشطة
   - إذا تغيرت الحالة عن آخر مرة:
     * يُرسل إشعار واتساب للعميل
     * يُحدّث السجل في قاعدة البيانات

3. قوالب رسائل التحديث:
   وصول للمخزن: 'وصلت شحنتك [AWB] لمخزننا في [المدينة] ✅'
   خرجت للتوصيل: 'شحنتك في الطريق إليك الآن 🚚 متوقع اليوم [الوقت]'
   محاولة فاشلة: 'حاولنا التوصيل لكن لم نجد أحداً. كيف نرتب وقتاً مناسباً؟'
   تم التسليم: 'تم توصيل شحنتك بنجاح ✅ شكراً لثقتكم!'

4. إيقاف المتابعة بعد التسليم لتوفير API calls"

// البرومبت لكلود:
"اكتب Pickup Scheduling Flow كامل:

المحادثة:
بوت: 'سأساعدك في حساب تكلفة الشحن. من أي مدينة؟'
عميل: 'الرياض'
بوت: 'وإلى أي مدينة/دولة؟'
عميل: 'دبي'
بوت: 'كم وزن الشحنة تقريباً؟ (بالكيلو)'
عميل: '5 كيلو'
بوت: 'الأبعاد؟ (الطول × العرض × الارتفاع بالسنتيمتر) — أو اكتب 'تجاوز' إذا مش عارف'
عميل: '30x20x15'

بوت يحسب:
الحجم الحجمي = (30×20×15)/5000 = 1.8 كيلو
الوزن الفعلي = 5 كيلو
الوزن المحاسبي = الأكبر = 5 كيلو

بوت يستعلم من Aramex Rate API وDHL API ويعرض:
'تكلفة الشحن من الرياض لدبي (5 كيلو):
🚀 Express (1-2 يوم): 85 درهم
📦 Economy (3-5 أيام): 52 درهم

هل تريد إنشاء شحنة الآن؟'"

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

1. اكتشاف نية الشكوى من الرسالة:
   كلمات: 'تأخر'، 'ضايع'، 'مكسور'، 'سرق'، 'مو وصل'، 'delayed'، 'lost'، 'damaged'
   يُحدد نوع الشكوى تلقائياً

2. معالجة حسب النوع:
   تأخير: يسأل عن AWB → يستعلم → إذا طبيعي يشرح السبب + يعطي وقت متوقع
            إذا غير طبيعي → يفتح تذكرة Priority Medium

   فقدان: فوراً → تذكرة Priority High + تحويل لموظف
           رسالة: 'نأسف جداً! خصصنا لك موظفاً متخصصاً الآن.'

   تلف: يطلب صورة من العميل → يحفظها → تذكرة Priority High

3. نظام Ticketing:
   كل شكوى تُنشئ Ticket: رقم، النوع، AWB، الوصف، الصور، رقم العميل، الوقت
   العميل يستلم رقم التذكرة: 'رقم شكواك: TK-2026-00891 سنتواصل معك خلال 4 ساعات.'

4. التصعيد التلقائي:
   إذا التذكرة لم تُحل خلال SLA المحدد → إشعار واتساب للمشرف"

// البرومبت لكلود:
"اكتب Customs Information Module:

1. قاعدة بيانات بسيطة لمتطلبات الجمارك لأشهر الدول الخليجية:
   السعودية ← الإمارات: فاتورة تجارية، بيان شحن، لا رسوم تحت 1000 درهم
   الإمارات ← الكويت: فاتورة، Certificate of Origin للمنتجات الصناعية
   السعودية ← مصر: فاتورة، COO، شهادة SASO لبعض المنتجات

2. محادثة ذكية:
   بوت: 'من أي دولة للشحن؟'
   بوت: 'إلى أي دولة؟'
   بوت: 'ما نوع البضاعة؟ (إلكترونيات/ملابس/أغذية/أخرى)'
   بوت يعرض: المستندات المطلوبة + تقدير الرسوم الجمركية + تحذيرات خاصة

3. إذا الدولة غير موجودة أو المنتج غير معتاد:
   'للشحنات الخاصة، تواصل مع فريق التخليص مباشرة: [الرقم]'"

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

للعميل المستلم:
- عند خروج الشحنة للتوصيل: 'شحنتك في الطريق. المبلغ المطلوب: 185 ريال'
- يدعم: نقداً / Apple Pay / STC Pay / Mada
- عند التسليم: 'تم استلام المبلغ. رقم العملية: [#]. شكراً!'

للتاجر (صاحب الشحنة):
- يستطيع الاستعلام عن حالة COD الخاصة به
- كم شحنة سُلّمت اليوم وما المبالغ المحصّلة
- متى يصله التحويل (عادة T+2 أيام عمل)

تقرير يومي للشركة:
- إجمالي COD المحصّل من كل سائق
- الشحنات التي رُفض استلامها (مع سبب العميل إن ذكر)
- يُرسل للمحاسبة كل مساء الساعة 9"