# 📦 دليل نظام إدارة المخزون - Roz Skin

## 🎯 نظرة عامة

نظام إدارة مخزون متكامل يوفر:
- ✅ تتبع دقيق لكميات المنتجات
- ✅ تسجيل جميع حركات المخزون
- ✅ تنبيهات تلقائية للمخزون المنخفض
- ✅ إدارة الموردين
- ✅ تقارير وتحليلات شاملة

---

## 📊 المكونات الرئيسية

### 1. إدارة المخزون (`index.php`)
**الوظائف:**
- عرض جميع المنتجات مع كمياتها
- تحديث المخزون (إضافة/صرف/تعديل/إرجاع)
- بحث وفلترة المنتجات
- عرض حالة المخزون (متوفر/منخفض/نفذ)
- حساب قيمة المخزون الإجمالية

**الإحصائيات:**
- إجمالي المنتجات المتتبعة
- عدد المنتجات ذات المخزون المنخفض
- عدد المنتجات النافذة
- القيمة الإجمالية للمخزون

### 2. إدارة الموردين (`suppliers.php`)
**الوظائف:**
- إضافة/تعديل/حذف الموردين
- معلومات الاتصال الكاملة
- حالة المورد (نشط/غير نشط)
- روابط واتساب مباشرة

**البيانات المخزنة:**
- اسم المورد
- جهة الاتصال
- رقم الهاتف
- البريد الإلكتروني
- العنوان
- ملاحظات

### 3. تقارير المخزون (`reports.php`)
**التقارير المتاحة:**
- حركات المخزون حسب الفترة
- إحصائيات الحركات (إضافة/صرف/تعديل/إرجاع)
- المنتجات الأكثر حركة
- التنبيهات النشطة
- رسم بياني للحركات

**الفلاتر:**
- تصفية حسب التاريخ (من - إلى)
- طباعة التقارير

---

## 🗄️ قاعدة البيانات

### الجداول المستخدمة:

#### 1. `products` (محدث)
```sql
- stock_quantity INT         -- الكمية الحالية
- low_stock_alert INT        -- حد التنبيه
- sku VARCHAR(100)           -- رمز المنتج
- track_inventory BOOLEAN    -- تتبع المخزون
```

#### 2. `inventory_movements`
```sql
- id INT PRIMARY KEY
- product_id INT             -- المنتج
- movement_type ENUM         -- نوع الحركة (in/out/adjustment/return)
- quantity INT               -- الكمية
- previous_quantity INT      -- الكمية السابقة
- new_quantity INT           -- الكمية الجديدة
- reference_type VARCHAR     -- نوع المرجع
- reference_id INT           -- معرف المرجع
- notes TEXT                 -- ملاحظات
- created_by INT             -- المستخدم
- created_at TIMESTAMP       -- تاريخ الإنشاء
```

#### 3. `inventory_alerts`
```sql
- id INT PRIMARY KEY
- product_id INT             -- المنتج
- alert_type ENUM            -- نوع التنبيه (low_stock/out_of_stock)
- current_quantity INT       -- الكمية الحالية
- threshold_quantity INT     -- حد التنبيه
- is_resolved BOOLEAN        -- تم الحل
- resolved_at TIMESTAMP      -- تاريخ الحل
- created_at TIMESTAMP       -- تاريخ الإنشاء
```

#### 4. `suppliers`
```sql
- id INT PRIMARY KEY
- name VARCHAR(255)          -- اسم المورد
- contact_person VARCHAR     -- جهة الاتصال
- phone VARCHAR(20)          -- الهاتف
- email VARCHAR(255)         -- البريد
- address TEXT               -- العنوان
- notes TEXT                 -- ملاحظات
- is_active BOOLEAN          -- نشط
- created_at TIMESTAMP
- updated_at TIMESTAMP
```

#### 5. `purchase_orders` (للمستقبل)
```sql
- id INT PRIMARY KEY
- order_number VARCHAR(50)   -- رقم الطلب
- supplier_id INT            -- المورد
- total_amount DECIMAL       -- المبلغ الإجمالي
- status ENUM                -- الحالة
- notes TEXT                 -- ملاحظات
- created_by INT             -- المستخدم
- received_at TIMESTAMP      -- تاريخ الاستلام
- created_at TIMESTAMP
- updated_at TIMESTAMP
```

#### 6. `purchase_order_items` (للمستقبل)
```sql
- id INT PRIMARY KEY
- purchase_order_id INT      -- طلب الشراء
- product_id INT             -- المنتج
- quantity INT               -- الكمية
- unit_price DECIMAL         -- سعر الوحدة
- total_price DECIMAL        -- السعر الإجمالي
- received_quantity INT      -- الكمية المستلمة
- created_at TIMESTAMP
```

---

## 🔄 أنواع حركات المخزون

### 1. إضافة (in)
- إضافة كمية جديدة للمخزون
- مثال: استلام شحنة من المورد
- **التأثير:** زيادة الكمية

### 2. صرف (out)
- صرف كمية من المخزون
- مثال: بيع منتج للعميل
- **التأثير:** تقليل الكمية

### 3. تعديل (adjustment)
- تعديل الكمية (جرد/تصحيح)
- مثال: تصحيح خطأ في الجرد
- **التأثير:** تقليل الكمية

### 4. إرجاع (return)
- إرجاع منتج للمخزون
- مثال: إرجاع من عميل
- **التأثير:** زيادة الكمية

---

## 🚨 نظام التنبيهات

### التنبيهات التلقائية:

#### 1. مخزون منخفض (Low Stock)
- **الشرط:** `stock_quantity <= low_stock_alert AND stock_quantity > 0`
- **اللون:** أصفر ⚠️
- **الإجراء:** طلب من المورد

#### 2. نفذ من المخزون (Out of Stock)
- **الشرط:** `stock_quantity <= 0`
- **اللون:** أحمر 🔴
- **الإجراء:** طلب عاجل من المورد

### حل التنبيهات:
- يتم حل التنبيه تلقائياً عند تحديث المخزون
- يمكن حل التنبيه يدوياً من صفحة التقارير

---

## 📈 الإحصائيات والتقارير

### 1. إحصائيات المخزون
```
- إجمالي المنتجات
- مخزون منخفض
- نفذ من المخزون
- قيمة المخزون (الكمية × السعر)
```

### 2. إحصائيات الحركات
```
- عدد الإضافات
- عدد الصرف
- عدد التعديلات
- عدد الإرجاع
```

### 3. المنتجات الأكثر حركة
```
- عدد الحركات لكل منتج
- إجمالي الإضافات
- إجمالي الصرف
- الصافي (إضافات - صرف)
```

---

## 🎨 واجهة المستخدم

### الألوان المستخدمة:

#### صفحة المخزون
- **الأساسي:** بنفسجي (Purple) `#9333ea`
- **النجاح:** أخضر (Green) `#22c55e`
- **التحذير:** أصفر (Yellow) `#eab308`
- **الخطر:** أحمر (Red) `#ef4444`

#### صفحة الموردين
- **الأساسي:** نيلي (Indigo) `#4f46e5`

#### صفحة التقارير
- **الأساسي:** تركواز (Teal) `#14b8a6`

### الأيقونات:
- 📦 `fa-boxes` - المخزون
- 🏭 `fa-truck` - الموردين
- 📊 `fa-chart-bar` - التقارير
- ⚠️ `fa-exclamation-triangle` - التنبيهات
- ✏️ `fa-edit` - تحديث
- 🔍 `fa-search` - بحث

---

## 🔧 التثبيت والإعداد

### 1. إنشاء الجداول
```bash
php backend/setup/create_inventory_tables.php
```

### 2. التحقق من الصلاحيات
```php
// يجب أن يكون المستخدم admin
if ($_SESSION['role'] !== 'admin') {
    header('Location: ../login.php');
    exit;
}
```

### 3. الوصول للنظام
```
المخزون: /backend/admin/inventory/
الموردين: /backend/admin/inventory/suppliers.php
التقارير: /backend/admin/inventory/reports.php
```

---

## 📝 أمثلة الاستخدام

### مثال 1: إضافة كمية للمخزون
```
1. افتح صفحة المخزون
2. اضغط "تحديث" على المنتج
3. اختر "إضافة للمخزون"
4. أدخل الكمية
5. أضف ملاحظة (اختياري)
6. احفظ
```

### مثال 2: صرف من المخزون
```
1. افتح صفحة المخزون
2. اضغط "تحديث" على المنتج
3. اختر "صرف من المخزون"
4. أدخل الكمية
5. أضف ملاحظة (مثال: "بيع للعميل #123")
6. احفظ
```

### مثال 3: إضافة مورد جديد
```
1. افتح صفحة الموردين
2. اضغط "مورد جديد"
3. أدخل البيانات
4. فعّل "مورد نشط"
5. احفظ
```

### مثال 4: عرض تقرير شهري
```
1. افتح صفحة التقارير
2. اختر "من تاريخ": 2025-11-01
3. اختر "إلى تاريخ": 2025-11-30
4. اضغط "تطبيق"
5. اطبع التقرير (اختياري)
```

---

## 🔐 الأمان

### الحماية المطبقة:
- ✅ التحقق من صلاحيات Admin
- ✅ استخدام Prepared Statements
- ✅ تسجيل جميع الحركات
- ✅ تتبع المستخدم المنفذ للحركة

### أفضل الممارسات:
- راجع التقارير بشكل دوري
- تحقق من التنبيهات يومياً
- احتفظ بنسخة احتياطية من البيانات
- راجع حركات المخزون الكبيرة

---

## 🚀 الميزات المستقبلية

### قريباً:
- [ ] نظام طلبات الشراء
- [ ] ربط تلقائي مع الطلبات
- [ ] تنبيهات بريد إلكتروني
- [ ] تصدير التقارير (Excel/PDF)
- [ ] باركود للمنتجات
- [ ] جرد دوري تلقائي
- [ ] تكامل مع الموردين

---

## 📞 الدعم

للمساعدة أو الاستفسارات:
- 📧 Email: support@rozskin.com
- 💬 الدعم الفني داخل النظام

---

## ✅ قائمة التحقق

### قبل الاستخدام:
- [x] إنشاء جداول قاعدة البيانات
- [x] التحقق من الصلاحيات
- [x] إضافة الموردين
- [ ] تحديد حد التنبيه لكل منتج
- [ ] إدخال الكميات الأولية

### الاستخدام اليومي:
- [ ] مراجعة التنبيهات
- [ ] تحديث المخزون عند البيع
- [ ] تسجيل الشحنات الواردة
- [ ] مراجعة التقارير الأسبوعية

---

**تم الإعداد بواسطة:** Kiro AI  
**التاريخ:** 15 نوفمبر 2025  
**الإصدار:** 1.0  
**الحالة:** ✅ جاهز للاستخدام

🎉 **نظام المخزون جاهز ومتكامل!**