# دليل تحديث حالة الشحنات 📦🔄

## نظرة عامة

صفحة **تحديث حالة الشحنات** تتيح لك تحديث حالة الطلبات المشحونة بسهولة باستخدام:
- 🔍 البحث السريع
- 📱 ماسح الباركود
- ✅ التحديد الجماعي

## الوصول للصفحة

```
المسار: admin/shipping/update-status.php
الرابط: من صفحة إدارة الشحن → زر "تحديث الحالة"
```

## المميزات الرئيسية ✨

### 1. البحث السريع 🔍
- البحث برقم الطلب
- البحث باسم العميل
- البحث برقم الهاتف
- البحث بالباركود
- **تحديد تلقائي** عند وجود نتيجة واحدة

### 2. ماسح الباركود 📱
- مسح سريع للطلبات
- صوت تأكيد عند كل مسح
- تحديد تلقائي
- عداد للطلبات الممسوحة

### 3. التحديد الجماعي ✅
- تحديد الكل
- إلغاء التحديد
- تحديد يدوي
- عداد للطلبات المحددة

### 4. حالات الشحن المتاحة 📊

| الحالة | الوصف | الأيقونة |
|--------|-------|---------|
| **في الانتظار** | pending | ⏰ |
| **قيد المعالجة** | processing | 🔄 |
| **تم الشحن** | shipped | 🚚 |
| **في الطريق للتسليم** | out_for_delivery | 🏃 |
| **تم التسليم** | delivered | ✅ |
| **مرتجع** | returned | ↩️ |
| **ملغي** | cancelled | ❌ |

## طرق الاستخدام 🎯

### الطريقة 1: المسح بالباركود (الأسرع) ⚡

```
1. اضغط زر "ماسح الباركود"
2. امسح باركود كل طلب تريد تحديث حالته
3. اختر الحالة الجديدة من القائمة
4. أضف ملاحظة (اختياري)
5. اضغط "تحديث الحالة"
```

**مثال:**
```
- امسح 10 طلبات تم تسليمها
- اختر "تم التسليم"
- اكتب ملاحظة: "تم التسليم بنجاح"
- اضغط تحديث
✅ تم تحديث 10 طلبات!
```

### الطريقة 2: البحث والتحديد 🔍

```
1. اكتب رقم الطلب أو اسم العميل في حقل البحث
2. إذا ظهر طلب واحد، سيتم تحديده تلقائياً
3. إذا ظهرت عدة طلبات، حدد يدوياً
4. اختر الحالة الجديدة
5. اضغط "تحديث الحالة"
```

**مثال:**
```
- ابحث عن "أحمد"
- ظهر 3 طلبات
- حدد الطلبات المطلوبة
- اختر "تم التسليم"
- اضغط تحديث
```

### الطريقة 3: التحديد الجماعي 📋

```
1. اضغط "تحديد الكل" لتحديد كل الطلبات الظاهرة
2. أو حدد يدوياً الطلبات المطلوبة
3. اختر الحالة الجديدة
4. اضغط "تحديث الحالة"
```

## سيناريوهات الاستخدام 💼

### سيناريو 1: تحديث طلبات تم تسليمها
```
الموقف: المندوب عاد وأحضر 15 طلب تم تسليمهم

الحل:
1. افتح صفحة تحديث الحالة
2. افتح ماسح الباركود
3. امسح الـ 15 طلب
4. اختر "تم التسليم"
5. اكتب "تم التسليم - دفعة 1"
6. اضغط تحديث

النتيجة: ✅ تم تحديث 15 طلب في ثوانٍ!
```

### سيناريو 2: تحديث طلب واحد
```
الموقف: عميل اتصل وقال استلم الطلب

الحل:
1. ابحث برقم الطلب أو اسم العميل
2. سيتم تحديده تلقائياً
3. اختر "تم التسليم"
4. اضغط تحديث

النتيجة: ✅ تم التحديث فوراً!
```

### سيناريو 3: طلبات مرتجعة
```
الموقف: المندوب أرجع 5 طلبات لم يتم التسليم

الحل:
1. امسح الـ 5 طلبات بالباركود
2. اختر "مرتجع"
3. اكتب السبب في الملاحظات
4. اضغط تحديث

النتيجة: ✅ تم تسجيل المرتجعات!
```

### سيناريو 4: طلبات في الطريق
```
الموقف: المندوب خرج للتوصيل مع 20 طلب

الحل:
1. ابحث عن طلبات المندوب
2. حدد الـ 20 طلب
3. اختر "في الطريق للتسليم"
4. اكتب "مع المندوب أحمد"
5. اضغط تحديث

النتيجة: ✅ العملاء يعرفون أن طلباتهم في الطريق!
```

## نصائح للاستخدام الأمثل 💡

### للسرعة القصوى ⚡
1. استخدم ماسح باركود USB
2. افتح لوحة الماسح مرة واحدة
3. امسح كل الطلبات بسرعة
4. اختر الحالة واضغط تحديث

### للدقة العالية 🎯
1. استخدم البحث للتأكد من الطلب
2. راجع بيانات العميل قبل التحديث
3. أضف ملاحظات توضيحية
4. تأكد من العدد قبل الضغط

### للتنظيم الأفضل 📊
1. حدث الحالات بشكل دوري
2. استخدم الملاحظات لتوثيق التغييرات
3. راجع الطلبات المرتجعة
4. تابع الطلبات في الطريق

## الاختصارات ⌨️

| الإجراء | الطريقة |
|---------|---------|
| فتح الماسح | زر "ماسح الباركود" |
| البحث | اكتب في حقل البحث |
| تحديد الكل | زر "تحديد الكل" |
| إلغاء التحديد | زر "إلغاء" أو "مسح التحديد" |
| التحديث | زر "تحديث الحالة" |

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

**س: هل يمكن تحديث حالة طلب واحد فقط؟**
ج: نعم! ابحث عنه وسيتم تحديده تلقائياً.

**س: ماذا لو مسحت طلب بالخطأ؟**
ج: ببساطة ألغِ تحديده من الجدول قبل الضغط على تحديث.

**س: هل يمكن إضافة ملاحظات؟**
ج: نعم! حقل الملاحظات اختياري ويضاف لكل الطلبات المحددة.

**س: كم طلب يمكن تحديثه دفعة واحدة؟**
ج: لا يوجد حد! يمكنك تحديث 1 أو 100 طلب في نفس الوقت.

**س: هل يتم حفظ تاريخ التحديث؟**
ج: نعم! يتم تحديث حقل `updated_at` تلقائياً.

**س: ماذا عن الطلبات الملغاة؟**
ج: الصفحة تعرض فقط الطلبات النشطة (pending, processing, shipped).

## التكامل مع الأنظمة الأخرى 🔗

### مع صفحة الطلبات
- يمكن الوصول من صفحة الطلبات
- التحديثات تظهر فوراً في جدول الطلبات

### مع المانيفستات
- الطلبات المشحونة تظهر في المانيفستات
- يمكن تحديث حالتها بعد الشحن

### مع التقارير
- التحديثات تؤثر على تقارير الشحن
- يمكن تتبع الطلبات المسلمة والمرتجعة

## الأمان 🔒

- ✅ يتطلب تسجيل دخول كمسؤول
- ✅ تأكيد قبل التحديث
- ✅ حفظ سجل التغييرات
- ✅ لا يمكن التراجع (كن حذراً!)

## الدعم الفني 📞

للمساعدة:
1. راجع هذا الدليل
2. تحقق من console المتصفح
3. تواصل مع فريق التطوير

---

**تم الإنشاء**: نوفمبر 2025  
**الإصدار**: 1.0  
**المطور**: Kiro AI Assistant