🎯 نظرة عامة

يتيح لك هذا النظام استيراد الأصناف والوحدات والمجموعات والمخازن بشكل كامل من ملف Excel واحد.

📝 الخطوات

  1. انقر على زر "تحميل نموذج Excel" لتحميل ملف نموذجي
  2. افتح الملف باستخدام Microsoft Excel أو Google Sheets
  3. عدّل البيانات في الصفحات الستة حسب احتياجاتك
  4. احفظ الملف
  5. انقر على زر "استيراد من Excel" وحمّل الملف

⚠️ ملاحظات مهمة

  • يجب أن يحتوي الملف على 6 صفحات بنفس الأسماء الموجودة في النموذج
  • إذا كانت المجموعة أو الوحدة أو المخزن موجوداً بنفس الاسم، لن يتم تكراره
  • لا تحذف أو تعدّل أسماء الأعمدة في الصف الأول
  • استخدم أكواداً فريدة للربط بين البيانات

📚 الصفحات المطلوبة

1️⃣ Categories

المجموعات - تصنيفات الأصناف

2️⃣ Units

الوحدات - وحدات القياس

3️⃣ Warehouses

المخازن - مواقع التخزين

4️⃣ Products

الأصناف - بيانات المنتجات

5️⃣ ProductUnits

ربط الأصناف بالوحدات

6️⃣ ProductWarehouses

ربط الأصناف بالمخازن

🔗 مثال: كيفية ربط البيانات

المرحلة 1️⃣: إنشاء المجموعة

في صفحة Categories:

code: CAT001 | name: Electronics | name_ar: إلكترونيات

✅ تم حفظ المجموعة في قاعدة البيانات بـ ID = 5

المرحلة 2️⃣: إنشاء الوحدة

في صفحة Units:

code: UNIT001 | name: Piece | name_ar: قطعة

✅ تم حفظ الوحدة في قاعدة البيانات بـ ID = 12

المرحلة 3️⃣: ربط الصنف

في صفحة Products:

code: PRD001 | name: Laptop
category_code: CAT001 ← يبحث عن المجموعة
base_unit_code: UNIT001 ← يبحث عن الوحدة

⚡ يحدث الربط التلقائي:

  • النظام يجد CAT001 ← يحوله لـ category_id = 5
  • النظام يجد UNIT001 ← يحوله لـ base_unit_id = 12
  • يحفظ الصنف مرتبطاً بالمجموعة والوحدة ✅

💡 المبدأ الأساسي:

الأكواد (codes) في ملف Excel هي المفاتيح التي يستخدمها النظام للربط. لا تحتاج لمعرفة الـ IDs - فقط استخدم الأكواد بشكل صحيح!

📊 نسب التحويل

في صفحة ProductUnits، العمود conversion_factor يحدد نسبة التحويل:

مثال 1: الوحدة الرئيسية

product_code: PRD001 | unit_code: UNIT_PIECE | conversion_factor: 1

✅ الوحدة الرئيسية دائماً = 1

مثال 2: كرتونة = 12 قطعة

product_code: PRD001 | unit_code: UNIT_BOX | conversion_factor: 12

✅ كرتونة واحدة = 12 قطعة

مثال 3: شيكارة = 50 كيلو

product_code: PRD_RICE | unit_code: UNIT_BAG | conversion_factor: 50

✅ شيكارة واحدة = 50 كيلو

✨ ميزة عدم التكرار

النظام يتحقق تلقائياً من البيانات الموجودة. إذا كانت المجموعة أو الوحدة أو المخزن موجوداً بنفس الاسم، سيستخدم النظام البيانات الموجودة بدلاً من إنشاء سجل مكرر.

🎯 كيف يعمل الربط؟

1️⃣

النظام يستورد المجموعات أولاً ويحفظ أكوادها

2️⃣

ثم يستورد الوحدات ويحفظ أكوادها

3️⃣

ثم يستورد المخازن ويحفظ أكوادها

4️⃣

عند استيراد الأصناف، يستخدم الأكواد المحفوظة للربط

مثال:

عندما تكتب category_code: CAT001 في صفحة Products، النظام يبحث عن الكود CAT001 ويربط الصنف بتلك المجموعة تلقائياً! ✨