# 🎁 دليل نظام العروض - Offers System Guide

## نظرة عامة
نظام متكامل لإدارة العروض والخصومات الخاصة في المتجر.

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

### ✨ أنواع الخصومات
- **خصم بالنسبة المئوية**: مثل 30% خصم
- **خصم بمبلغ ثابت**: مثل 50 ريال خصم

### 📅 إدارة الفترات الزمنية
- تحديد تاريخ بداية ونهاية للعرض
- عرض العروض النشطة فقط
- تنبيه للعروض التي توشك على الانتهاء

### 🎯 شروط العروض
- **الحد الأدنى للشراء**: تطبيق العرض عند الوصول لمبلغ معين
- **الحد الأقصى للخصم**: تحديد سقف للخصم في حالة النسبة المئوية
- **عدد مرات الاستخدام**: تحديد عدد مرات استخدام العرض (أو غير محدود)

### 🏆 نظام الأولويات
- ترتيب العروض حسب الأولوية
- عرض أفضل عرض متاح للعميل

## التثبيت

### 1. إنشاء جدول قاعدة البيانات
```bash
افتح المتصفح واذهب إلى:
http://localhost/backend/setup/create_offers_system.php
```

### 2. الوصول إلى لوحة التحكم
```
http://localhost/backend/admin/offers/index.php
```

### 3. عرض صفحة العروض للزوار
```
http://localhost/backend/public/offers.php
```

## استخدام لوحة التحكم

### إضافة عرض جديد
1. اذهب إلى: **المبيعات والطلبات > العروض الخاصة**
2. املأ البيانات:
   - **عنوان العرض**: مثل "خصم 30% على جميع المنتجات"
   - **وصف العرض**: تفاصيل العرض
   - **نوع الخصم**: نسبة مئوية أو مبلغ ثابت
   - **قيمة الخصم**: القيمة المطلوبة
   - **صورة العرض**: (اختياري)
   - **تاريخ البداية والنهاية**
   - **الحد الأدنى للشراء**: (اختياري)
   - **الحد الأقصى للخصم**: (اختياري)
   - **عدد مرات الاستخدام**: 0 = غير محدود
   - **الأولوية**: ترتيب العرض
3. اضغط **إضافة**

### تعديل عرض
- اضغط على أيقونة التعديل ✏️ بجانب العرض
- عدّل البيانات المطلوبة
- اضغط **تحديث**

### تفعيل/إيقاف عرض
- اضغط على أيقونة التبديل 🔄
- سيتم تفعيل أو إيقاف العرض فوراً

### حذف عرض
- اضغط على أيقونة الحذف 🗑️
- أكد الحذف

## API المتاحة

### 1. جلب العروض النشطة
```javascript
GET /backend/api/offers/get.php

Response:
{
  "success": true,
  "count": 3,
  "offers": [
    {
      "id": 1,
      "title": "خصم 30%",
      "discount_type": "percentage",
      "discount_value": 30,
      "days_left": 15,
      "is_ending_soon": false
    }
  ]
}
```

### 2. التحقق من العروض المتاحة
```javascript
GET /backend/api/offers/check.php?cart_total=200

Response:
{
  "success": true,
  "offers": [...],
  "best_offer": {
    "id": 1,
    "title": "خصم 50 ريال",
    "calculated_discount": 50
  }
}
```

## أمثلة على العروض

### مثال 1: خصم نسبة مئوية
```
العنوان: خصم 30% على جميع المنتجات
النوع: نسبة مئوية
القيمة: 30
الحد الأقصى: 100 ريال
```

### مثال 2: خصم مبلغ ثابت
```
العنوان: خصم 50 ريال على المشتريات فوق 200 ريال
النوع: مبلغ ثابت
القيمة: 50
الحد الأدنى: 200 ريال
```

### مثال 3: عرض محدود
```
العنوان: عرض نهاية الأسبوع
النوع: نسبة مئوية
القيمة: 25
عدد مرات الاستخدام: 100
```

## التكامل مع السلة

يمكن دمج نظام العروض مع صفحة السلة:

```php
// في صفحة السلة
$cart_total = 250; // مجموع السلة

// جلب أفضل عرض متاح
$response = file_get_contents("../api/offers/check.php?cart_total=$cart_total");
$data = json_decode($response, true);

if ($data['best_offer']) {
    $discount = $data['best_offer']['calculated_discount'];
    $final_total = $cart_total - $discount;
    
    echo "الخصم: $discount ريال";
    echo "المجموع النهائي: $final_total ريال";
}
```

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

### 📊 استراتيجيات العروض
1. **عروض موسمية**: رمضان، العيد، نهاية السنة
2. **عروض الولاء**: للعملاء المميزين
3. **عروض التخليص**: للمنتجات القديمة
4. **عروض الكمية**: عند الشراء بكميات كبيرة

### ⚡ أفضل الممارسات
- استخدم صور جذابة للعروض
- اجعل العناوين واضحة ومباشرة
- حدد فترات زمنية معقولة
- راقب استخدام العروض وعدّلها حسب الأداء
- استخدم الأولويات لعرض أفضل العروض أولاً

### 🎨 التصميم
- الصفحة تستخدم تصميم موحد مع باقي الموقع
- عرض بطاقات جذابة للعروض
- شارات للخصومات والوقت المتبقي
- تصميم متجاوب للموبايل

## الملفات المهمة

```
backend/
├── setup/
│   └── create_offers_system.php      # إنشاء النظام
├── admin/
│   └── offers/
│       └── index.php                  # لوحة التحكم
├── public/
│   └── offers.php                     # صفحة العروض للزوار
├── api/
│   └── offers/
│       ├── get.php                    # جلب العروض
│       └── check.php                  # التحقق من العروض
└── uploads/
    └── offers/                        # صور العروض
```

## الدعم والمساعدة

إذا واجهت أي مشكلة:
1. تأكد من تشغيل `create_offers_system.php` أولاً
2. تحقق من صلاحيات مجلد `uploads/offers`
3. راجع سجل الأخطاء في PHP

---

✨ **تم إنشاء النظام بنجاح!** استمتع بإدارة العروض بسهولة.