# دليل استخدام ماسح الباركود 📱

## نظرة عامة
تم إضافة ميزة البحث والتحديد بماسح الباركود في صفحات إدارة الطلبات والشحن. هذه الميزة تسمح لك بمسح الباركود على الطلبات لتحديدها تلقائياً مع إصدار صوت تأكيد.

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

### 1. المسح التلقائي
- امسح الباركود باستخدام ماسح الباركود (Barcode Scanner)
- يتم البحث عن الطلب تلقائياً في الجدول
- يتم تحديد الطلب وتمييزه بلون مختلف

### 2. الصوت التأكيدي 🔊
- **صوت نجاح**: عند العثور على الطلب وتحديده
- **صوت خطأ**: عند عدم العثور على الطلب
- يمكن تفعيل/تعطيل الصوت من لوحة التحكم

### 3. التحديد التلقائي ✅
- يتم تحديد الطلب تلقائياً عند المسح
- يمكن تعطيل هذه الميزة والمسح فقط للبحث
- عداد يعرض عدد الطلبات المحددة

### 4. التمييز البصري 🎨
- **تمييز مؤقت**: لون أصفر لمدة ثانية عند المسح
- **تمييز دائم**: خلفية زرقاء للطلبات المحددة
- التمرير التلقائي للطلب الممسوح

## كيفية الاستخدام 📖

### في صفحة إدارة الطلبات

1. **فتح لوحة الماسح**
   - اضغط على زر "ماسح الباركود" في الهيدر
   - ستظهر لوحة تحكم في الزاوية السفلية اليسرى

2. **إعدادات الماسح**
   - **الصوت**: تفعيل/تعطيل الصوت التأكيدي
   - **التحديد التلقائي**: تفعيل/تعطيل التحديد عند المسح
   - **العداد**: يعرض عدد الطلبات المحددة

3. **المسح**
   - استخدم ماسح الباركود لمسح الباركود على الطلب
   - سيتم البحث تلقائياً وتحديد الطلب
   - سيصدر صوت تأكيد عند النجاح

4. **معالجة الطلبات المحددة**
   - اضغط على زر "معالجة" لإنشاء مانيفست للطلبات المحددة
   - أو استخدم زر "مسح التحديد" لإلغاء التحديد

### في صفحة إنشاء المانيفست

1. **فتح لوحة الماسح**
   - اضغط على زر "ماسح الباركود" بجانب "تحديد الكل"

2. **مسح الطلبات**
   - امسح باركود كل طلب تريد إضافته للمانيفست
   - سيتم تحديده تلقائياً في الجدول
   - العداد يعرض عدد الطلبات الممسوحة

3. **إنشاء المانيفست**
   - بعد مسح جميع الطلبات المطلوبة
   - أدخل بيانات شركة الشحن والمندوب
   - اضغط "إنشاء المانيفست وطباعته"

## صيغ الباركود المدعومة 🏷️

الماسح يدعم الصيغ التالية:

1. **رقم الطلب المباشر**: `123`
2. **باركود بصيغة ORD**: `ORD000123`
3. **رقم الطلب الكامل**: `ORD-2024-001`

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

### للحصول على أفضل أداء:

1. **استخدم ماسح باركود USB أو Bluetooth**
   - أسرع وأكثر دقة من الكاميرا
   - يعمل مباشرة كلوحة مفاتيح

2. **تأكد من جودة طباعة الباركود**
   - استخدم طابعة باركود احترافية
   - تأكد من وضوح الباركود

3. **المسح السريع**
   - يمكنك مسح عدة طلبات بسرعة
   - الماسح يتعامل مع المسح المتتالي

4. **استخدم البحث اليدوي كبديل**
   - حقل البحث في الهيدر للبحث اليدوي
   - يدعم البحث برقم الطلب أو اسم العميل

## استكشاف الأخطاء 🔧

### المشكلة: لا يعمل الماسح

**الحلول:**
- تأكد من أن ماسح الباركود متصل بشكل صحيح
- جرب المسح في حقل نصي للتأكد من عمل الماسح
- تأكد من أن الماسح مضبوط على وضع "Keyboard Emulation"

### المشكلة: لا يتم العثور على الطلب

**الحلول:**
- تأكد من أن الباركود يطابق رقم الطلب
- جرب البحث اليدوي للتأكد من وجود الطلب
- تحقق من صيغة الباركود

### المشكلة: لا يصدر صوت

**الحلول:**
- تأكد من تفعيل الصوت في لوحة التحكم
- تحقق من إعدادات الصوت في المتصفح
- بعض المتصفحات تحتاج إذن لتشغيل الصوت

## الملفات المعدلة 📁

```
backend/admin/
├── assets/js/
│   └── barcode-scanner.js          # مكتبة الماسح
├── orders/
│   └── index.php                   # صفحة الطلبات مع الماسح
└── shipping/
    ├── create-manifest.php         # صفحة المانيفست مع الماسح
    └── BARCODE-SCANNER-GUIDE.md    # هذا الملف
```

## التطوير المستقبلي 🚀

### ميزات مقترحة:

1. **دعم الكاميرا**
   - مسح الباركود باستخدام كاميرا الهاتف/الكمبيوتر
   - مفيد عند عدم توفر ماسح باركود

2. **تاريخ المسح**
   - حفظ سجل بالطلبات الممسوحة
   - عرض وقت وتاريخ كل مسح

3. **المسح الجماعي**
   - مسح عدة باركودات دفعة واحدة
   - استيراد من ملف CSV

4. **التكامل مع الطابعة**
   - طباعة الباركود مباشرة من النظام
   - طباعة ملصقات الشحن مع الباركود

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

للمساعدة أو الإبلاغ عن مشاكل:
- راجع هذا الدليل أولاً
- تحقق من console المتصفح للأخطاء
- تواصل مع فريق التطوير

---

**تم التطوير بواسطة**: Kiro AI Assistant  
**التاريخ**: نوفمبر 2025  
**الإصدار**: 1.0