# 🎓 دليل سريع: كيف يعمل الربط في استيراد الأصناف

## السؤال: الأصناف حترتبط بالباقيين إزاي؟

---

## ✨ الإجابة المختصرة

**عبر الأكواد (Codes)!**

كل صف في ملف Excel له `code` (كود فريد). النظام يستخدم هذا الكود كـ "مفتاح" للربط بين الجداول.

---

## 🔄 الآلية بالترتيب

### 1️⃣ استورد المجموعة
```excel
صفحة Categories:
code: CAT001
name: Electronics
```
✅ النظام يحفظ: `CAT001` ← مرتبط بالمجموعة

---

### 2️⃣ استورد الوحدة
```excel
صفحة Units:
code: UNIT001
name: Piece
```
✅ النظام يحفظ: `UNIT001` ← مرتبط بالوحدة

---

### 3️⃣ استورد الصنف واربطه
```excel
صفحة Products:
code: PRD001
name: Laptop
category_code: CAT001    ← هنا الربط!
base_unit_code: UNIT001  ← وهنا!
```

⚡ **النظام يقول:**
- "شوف `CAT001`؟ آه دي المجموعة اللي حفظتها قبل كده!"
- "و `UNIT001`؟ دي الوحدة اللي حفظتها!"
- "يلّا نربط الصنف بيهم!" ✅

---

### 4️⃣ أضف وحدات فرعية
```excel
صفحة ProductUnits:
product_code: PRD001     ← الصنف
unit_code: UNIT002       ← الوحدة الفرعية (كرتونة)
conversion_factor: 12    ← 12 قطعة
```

⚡ النظام يربط الصنف بالوحدة الفرعية

---

### 5️⃣ أضفه للمخازن
```excel
صفحة ProductWarehouses:
product_code: PRD001     ← الصنف
warehouse_code: WH001    ← المخزن
current_stock: 25        ← الكمية
```

⚡ النظام يربط الصنف بالمخزن ويحفظ الرصيد

---

## 💡 مثال عملي واحد يوضح كل شيء

### الهدف: استيراد "أرز أبيض"

#### الخطوة 1: المجموعة
```
Categories:
code: FOOD
name: Groceries
```

#### الخطوة 2: الوحدات
```
Units:
code: KG
name: Kilogram
---
code: BAG
name: Bag
```

#### الخطوة 3: المخزن
```
Warehouses:
code: MAIN
name: Main Store
```

#### الخطوة 4: الصنف
```
Products:
code: RICE01
name: White Rice
category_code: FOOD    ← ربط!
base_unit_code: KG     ← ربط!
```

#### الخطوة 5: الوحدات الفرعية
```
ProductUnits:
product_code: RICE01
unit_code: KG
conversion_factor: 1
---
product_code: RICE01
unit_code: BAG
conversion_factor: 50   ← الشيكارة = 50 كيلو
```

#### الخطوة 6: المخزن
```
ProductWarehouses:
product_code: RICE01
warehouse_code: MAIN
current_stock: 1000     ← عندنا 1000 كيلو
```

---

## ✅ النتيجة النهائية

بعد الاستيراد، سيكون عندك:

### صنف "أرز أبيض":
- ✅ موجود في مجموعة "Groceries"
- ✅ الوحدة الرئيسية: كيلوجرام
- ✅ وحدة فرعية: شيكارة (50 كيلو)
- ✅ موجود في "المخزن الرئيسي"
- ✅ الكمية: 1000 كيلو

**كل هذا من ملف Excel واحد!** 🎉

---

## ⚠️ الأخطاء الشائعة

### ❌ خطأ 1: الكود غلط
```
Products:
category_code: CAT999  ← الكود مش موجود!
```
**النتيجة:** الصنف بدون مجموعة ⚠️

### ✅ الحل:
تأكد إن الكود موجود في صفحة Categories

---

### ❌ خطأ 2: ترتيب خاطئ
```
استوردت Products قبل Categories!
```
**النتيجة:** مش هيلاقي الأكواد ⚠️

### ✅ الحل:
الترتيب الصحيح:
1. Categories
2. Units
3. Warehouses
4. Products
5. ProductUnits
6. ProductWarehouses

**النظام يستوردهم بالترتيب الصحيح تلقائياً** ✅

---

## 🎯 الملخص في 3 نقاط

1. **الأكواد = المفاتيح**
   - كل شيء له كود فريد
   
2. **الربط = استخدام الأكواد**
   - في الأصناف، تكتب كود المجموعة → يحصل الربط
   
3. **الترتيب مهم**
   - النظام يستورد بالترتيب الصحيح تلقائياً

**ما عليك إلا تملى البيانات صح في Excel والباقي تلقائي!** ✨

---

## 📚 للمزيد من التفاصيل

راجع:
- [HOW_PRODUCTS_LINKING_WORKS.md](HOW_PRODUCTS_LINKING_WORKS.md) - شرح تفصيلي كامل
- زر "تعليمات الاستيراد" في صفحة الأصناف - شرح مرئي