# 📊 نظام السكرول الجانبي - Horizontal Scroll System

## 🎯 الميزات

### ✅ السكرول الجانبي الذكي
- تلقائياً على جميع الجداول في الصفحات ما عدا الرئيسية
- يعمل على الهاتف والتابلت والكمبيوتر
- سلس وسهل الاستخدام

### ✅ مؤشرات بصرية ذكية
- مؤشرات جانبية تظهر عند وجود محتوى مخفي
- تلاشي سلس للمؤشرات
- ألوان متناسقة مع تصميم التطبيق

### ✅ شريط سكرول محسّن
- شريط سكرول جميل وسهل الاستخدام
- على Firefox و Chrome
- يعمل على جميع المتصفحات

### ✅ توافقية كاملة
- الهاتف: يدعم `touch` scroll سلس
- التابلت: مؤشرات واضحة
- الكمبيوتر: شريط سكرول احترافي

---

## 📁 الملفات المستخدمة

```
public/
├── js/
│   └── horizontal-scroll.js          ✅ منطق السكرول
├── css/
│   └── style.css                     ✅ تصاميم السكرول (مضافة)
└── [صفحات البيانات]:
    ├── suppliers.html                ✅
    ├── employees.html                ✅
    ├── products.html                 ✅
    ├── categories.html               ✅
    ├── branches.html                 ✅
    ├── customers.html                ✅
    └── inventory.html                ✅
```

---

## 🚀 كيفية العمل

### 1. التثبيت التلقائي

```javascript
// يتم تلقائياً عند تحميل الصفحة:
// 1. البحث عن جميع الجداول
// 2. إضافة wrapper بـ overflow-x: auto
// 3. إضافة مؤشرات بصرية
// 4. مراقبة السكرول
```

### 2. المراقبة الديناميكية

```javascript
// يراقب إضافة جداول جديدة
// إذا تم تحديث البيانات وإضافة جدول جديد
// سيتم إعداده تلقائياً
```

### 3. إعادة التهيئة

```javascript
// عند تحديث البيانات:
reinitializeTables();

// يعيد تهيئة جميع الجداول
```

---

## 💡 الاستخدام

### من JavaScript (في ملفات العمليات)

```javascript
// بعد تحديث البيانات:
function loadSuppliers() {
  // ... جلب البيانات ...
  
  // تحديث الجدول
  updateTableDOM();
  
  // إعادة تهيئة السكرول
  reinitializeTables();
}
```

### من الـ HTML

```html
<!-- لا يلزم أي تعديل - يعمل تلقائياً -->
<table id="suppliersTable">
  <thead>...</thead>
  <tbody>...</tbody>
</table>

<!-- سيُلف تلقائياً بـ div.table-wrapper -->
```

---

## 🎨 التصميم والتأثيرات

### مؤشرات السكرول

```css
.scroll-indicator-left {
  /* مؤشر يسار - يظهر عند وجود محتوى غير مرئي على اليسار */
  background: linear-gradient(to right, rgba(102, 126, 234, 0.3) 0%, transparent 100%);
}

.scroll-indicator-right {
  /* مؤشر يمين - يظهر عند وجود محتوى غير مرئي على اليمين */
  background: linear-gradient(to left, rgba(102, 126, 234, 0.3) 0%, transparent 100%);
}
```

### شريط السكرول

```css
.table-wrapper::-webkit-scrollbar {
  height: 8px;
}

.table-wrapper::-webkit-scrollbar-thumb {
  background: #888;
  border-radius: 10px;
}

.table-wrapper::-webkit-scrollbar-thumb:hover {
  background: #555;
}
```

---

## 📱 السلوك حسب الجهاز

### على الهاتف (< 480px)
- جداول أصغر (font-size: 13px)
- تعديل padding (8px بدل 12px)
- مؤشرات واضحة للسكرول
- دعم كامل للـ touch scroll

### على التابلت (480px - 768px)
- حجم طبيعي للخط
- مؤشرات بصرية واضحة
- سكرول سلس

### على الكمبيوتر (> 768px)
- شريط سكرول كامل
- حجم كبير للخط
- تأثيرات hover على شريط السكرول

---

## 🧪 الاختبار

### 1. اختبار السكرول

```
على الهاتف:
1. افتح صفحة products
2. اسحب يساراً على الجدول
3. يجب أن تظهر أعمدة جديدة

على الكمبيوتر:
1. قلّل عرض الشاشة (F12 > Toggle Device)
2. يجب أن يظهر شريط سكرول
```

### 2. اختبار المؤشرات

```javascript
// في console:
horizontalScrollManager.getHiddenColumnsCount(
  document.querySelector('table')
);

// سيعيد عدد الأعمدة المخفية
```

### 3. اختبار إعادة التهيئة

```javascript
// بعد تحديث البيانات:
reinitializeTables();

// يجب أن تتحدث المؤشرات
```

---

## 🔧 الخصائص والدوال

### HorizontalScrollManager

```javascript
new HorizontalScrollManager()         // إنشاء مدير
.setupTableScroll(table)             // إعداد جدول
.addScrollIndicator(wrapper)         // إضافة مؤشرات
.updateScrollIndicators(wrapper)     // تحديث المؤشرات
.scrollTableToRight(table)           // سكرول يمين سلس
.scrollTableToLeft(table)            // سكرول يسار سلس
.reinitialize()                      // إعادة تهيئة
.getHiddenColumnsCount(table)        // عد الأعمدة المخفية
.addScrollHint(wrapper)              // إضافة رسالة تلميح
```

### الدوال العامة

```javascript
reinitializeTables()  // إعادة تهيئة جميع الجداول
```

---

## 🎯 أمثلة عملية

### مثال 1: تحديث البيانات

```javascript
function loadSuppliers() {
  const suppliers = JSON.parse(localStorage.getItem('suppliers') || '[]');
  
  // تحديث الجدول
  const tbody = document.getElementById('suppliersBody');
  tbody.innerHTML = '';
  
  suppliers.forEach(supplier => {
    const row = `
      <tr>
        <td>${supplier.name}</td>
        <td>${supplier.phone}</td>
        <td>${supplier.email}</td>
        <td>${supplier.address}</td>
        <td>...</td>
      </tr>
    `;
    tbody.innerHTML += row;
  });

  // ✅ إعادة تهيئة السكرول
  reinitializeTables();
}
```

### مثال 2: البحث في الجدول

```javascript
function searchSuppliers() {
  const query = document.getElementById('searchInput').value;
  const suppliers = JSON.parse(localStorage.getItem('suppliers') || '[]');
  
  const filtered = suppliers.filter(s => 
    s.name.includes(query) || s.phone.includes(query)
  );

  // تحديث الجدول بالنتائج
  updateTable(filtered);

  // ✅ إعادة تهيئة السكرول
  reinitializeTables();
}
```

---

## 🚨 استكشاف الأخطاء

### المؤشرات لا تظهر؟

```javascript
// تحقق من:
const table = document.querySelector('table');
const wrapper = table.parentElement;

console.log(wrapper.classList.contains('table-wrapper')); // يجب true
console.log(table.scrollWidth > wrapper.clientWidth);     // يجب true
```

### السكرول لا يعمل؟

```javascript
// إعادة تهيئة كاملة:
reinitializeTables();

// أو يدويًا:
horizontalScrollManager.reinitialize();
```

### مشاكل الأداء؟

```javascript
// تأكد من عدم إساءة استخدام reinitializeTables
// استدعها مرة واحدة فقط بعد تحديث البيانات
```

---

## ✨ ملخص

✅ **نظام سكرول ذكي**:
- تلقائي بالكامل
- مؤشرات بصرية واضحة
- يعمل على جميع الأجهزة
- قابل للتخصيص

**الآن جداولك تدعم السكرول الجانبي الكامل!** 📊
