# 🚀 راهنمای سریع - سیستم مدیریت صفحه اصلی

## ✅ نصب کامل شد!

همه چیز آماده و آزمایش شده است. می‌تونی الان شروع کنی.

---

## 📋 خلاصه قابلیت‌ها

### 1️⃣ ویژگی‌های صفحه اصلی
باکس‌های کوچک مثل "ارسال رایگان"، "پشتیبانی 24/7"

✅ ویرایش متن‌ها  
✅ تغییر آیکون‌ها  
✅ تغییر رنگ‌ها  
✅ حذف و فعال/غیرفعال  

### 2️⃣ ویترین محصولات
نمایش گروه‌های مختلف محصولات

✅ ویترین‌های دستی (انتخاب محصولات)  
✅ ویترین‌های خودکار (پرفروش، تخفیف‌دار، جدید، ویژه، پربازدید)  
✅ تنظیم نوع نمایش (grid/carousel/list)  
✅ تنظیم رنگ‌ها و عنوان‌ها  

---

## 🎯 API‌های عمومی (برای فرانت‌اند)

```bash
# ویژگی‌های صفحه اصلی
GET http://localhost:8000/api/home-features

# ویترین‌های محصولات
GET http://localhost:8000/api/product-showcases
```

---

## 🔐 API‌های مدیریتی (نیاز به توکن)

### ویژگی‌های صفحه اصلی

```javascript
// لیست ویژگی‌ها
GET /api/admin/home-features

// ایجاد ویژگی
POST /api/admin/home-features
{
  "title": "ارسال رایگان",
  "description": "برای سفارش‌های بالای 500 هزار تومان",
  "icon": "Truck",
  "bg_color": "#E3F2FD",
  "icon_color": "#1976D2",
  "text_color": "#0D47A1",
  "is_active": true
}

// ویرایش ویژگی
PUT /api/admin/home-features/{id}

// حذف ویژگی
DELETE /api/admin/home-features/{id}
```

### ویترین‌های خودکار

```javascript
// دریافت انواع ویترین
GET /api/admin/auto-showcases/types

// پیش‌نمایش محصولات یک نوع
POST /api/admin/auto-showcases/preview
{
  "type": "best_sellers",
  "limit": 10
}

// ساخت ویترین خودکار
POST /api/admin/auto-showcases/create
{
  "type": "best_sellers",
  "title": "پرفروش‌ترین‌ها",
  "display_type": "grid",
  "products_limit": 8,
  "is_active": true
}
```

**انواع ویترین‌های خودکار:**
- `best_sellers` - پرفروش‌ترین محصولات
- `discounted` - محصولات تخفیف‌دار
- `newest` - جدیدترین محصولات
- `featured` - محصولات ویژه
- `high_rated` - محصولات پربازدید

### ویترین‌های دستی

```javascript
// لیست ویترین‌ها
GET /api/admin/product-showcases

// جزئیات یک ویترین
GET /api/admin/product-showcases/{id}

// ایجاد ویترین دستی
POST /api/admin/product-showcases
{
  "title": "محصولات ویژه هفته",
  "subtitle": "بهترین انتخاب‌های ما",
  "display_type": "carousel",
  "products_limit": 10,
  "bg_color": "#F5F5F5",
  "title_color": "#1976D2",
  "product_ids": [1, 3, 5, 7, 9],
  "is_active": true
}

// ویرایش ویترین
PUT /api/admin/product-showcases/{id}

// حذف ویترین
DELETE /api/admin/product-showcases/{id}
```

---

## 🎨 آیکون‌های پیشنهادی

از [Lucide Icons](https://lucide.dev/) استفاده کن:

```
Truck        - کامیون (ارسال)
Headphones   - هدفون (پشتیبانی)
ShieldCheck  - سپر (ضمانت)
CreditCard   - کارت (پرداخت)
Gift         - هدیه
Award        - جایزه
Zap          - برق (سرعت)
Heart        - قلب
Star         - ستاره
RefreshCw    - بازگشت
Lock         - قفل (امنیت)
Phone        - تلفن
Package      - بسته
```

---

## 🎨 پالت‌های رنگی آماده

```javascript
// آبی (ارسال)
{ bg: "#E3F2FD", icon: "#1976D2", text: "#0D47A1" }

// بنفش (پشتیبانی)
{ bg: "#F3E5F5", icon: "#7B1FA2", text: "#4A148C" }

// سبز (ضمانت)
{ bg: "#E8F5E9", icon: "#388E3C", text: "#1B5E20" }

// نارنجی (پرداخت)
{ bg: "#FFF3E0", icon: "#F57C00", text: "#E65100" }

// قرمز (تخفیف)
{ bg: "#FFEBEE", icon: "#C62828", text: "#B71C1C" }
```

---

## 📱 نوع نمایش ویترین

```javascript
"display_type": "grid"      // شبکه‌ای (مناسب دسکتاپ)
"display_type": "carousel"  // اسلایدر (مناسب موبایل)
"display_type": "list"      // لیست عمودی (با جزئیات)
```

---

## 📚 مستندات کامل

برای جزئیات بیشتر:

1. **`HOMEPAGE_FEATURES_README.md`** - نمای کلی و راهنما
2. **`docs/HOME_PAGE_MANAGEMENT_API.md`** - مستندات کامل API
3. **`docs/HOMEPAGE_SETUP.md`** - راهنمای راه‌اندازی
4. **`docs/FRONTEND_EXAMPLES.md`** - نمونه کدهای React
5. **`CHANGES_SUMMARY.md`** - خلاصه تغییرات

---

## ✅ وضعیت راه‌اندازی

- ✅ مایگریشن‌ها اجرا شدند
- ✅ سیدرهای نمونه اجرا شدند
- ✅ API‌ها تست شدند و کار می‌کنند
- ✅ روت‌ها اضافه شدند
- ✅ کنترلرها آماده هستند
- ✅ مستندات کامل است

---

## 🎉 آماده استفاده!

همه چیز آماده است. می‌تونی:

1. از API‌های عمومی در صفحه اصلی فروشگاه استفاده کنی
2. پنل ادمین بسازی برای مدیریت ویژگی‌ها و ویترین‌ها
3. از ویترین‌های خودکار برای ساخت سریع استفاده کنی

**موفق باشی! 🚀**
