# ميزات 6–10 — دليل الاستخدام

توثيق كامل لكل ميزة: حالتها (جاهزة في Botble ولا مبنية)، وطريقة الاستخدام من A إلى Z.

| # | الميزة | الحالة |
|---|--------|--------|
| 6 | تتبع الطلب + إشعار لكل خطوة على ملف العميل | صفحة التتبع جاهزة + **مركز إشعارات مبني** |
| 7 | تقييم بعد الشراء (نجوم + وصف) | ✅ جاهز في Botble — تم تفعيله |
| 8 | مراجعة + رفع صورة في تفاصيل المنتج | ✅ جاهز في Botble — تم تفعيله |
| 9 | إشعار عند توفّر المنتج بعد نفاذه | 🆕 مبني بالكامل |
| 10 | أيقونة الموبايل (Add to Home Screen) | 🆕 مبني بالكامل (PWA) |

> بعد أي تعديل إعدادات: `‎/usr/local/opt/php@8.4/bin/php artisan optimize:clear‎`

---

## مركز إشعارات العميل (يخدم 6 و 9)

- **جرس إشعارات في الهيدر** (جنب السلة) يظهر **للعميل المسجّل فقط**، مع **عدّاد غير مقروء**.
- الجرس فيه **Dropdown** (نفس شكل وسلوك dropdown السلة تمامًا — مبني عبر `partials/header-dropdown.blade.php` اللي بيلفّ أي panel في `cart-dropdown-wrap`): بيفتح بالـhover على الديسكتوب وبالضغط على الموبايل، وبيقفل بالضغط برّه، وبيظبط موضعه تلقائيًا عشان مايخرجش برّه الشاشة.
- الـDropdown بيعرض **آخر 4 إشعارات + "View all notifications"**، وأي ضغطة تودّي **صفحة الإشعارات** `/notifications`.
- صفحة الإشعارات الكاملة: **حسابي → الإشعارات** (أو `/notifications`) وبتعلّم الكل مقروء.
- التخزين في جدول `nest_customer_notifications`. المحتوى في `partials/notification-panel.blade.php` (الداتا بس — الشكل من dropdown السلة).

---

## 6) تتبّع الطلب + الإشعارات

**الجاهز:** صفحة تتبّع الطلب في Botble (حسابي → تتبع الطلب).

**المبني (الإشعارات):** أول ما تغيّر **حالة الطلب** أو **حالة الشحن** من لوحة التحكم:
- Ecommerce → Orders → افتح الطلب → غيّر الحالة (Processing / Completed…) أو حالة الشحن.
- تلقائيًا بيتبعت **إشعار لملف العميل** بالحالة الجديدة + رابط لطلباته.

**الاستخدام:** مفيش إعداد — بيشتغل تلقائيًا. العميل يشوفه في صفحة الإشعارات مع عدّاد غير مقروء.

---

## 7) تقييم بعد الشراء

**جاهز في Botble.** التفعيل:
- Ecommerce → **Settings → Product Reviews** → فعّل **Enable review** (اتفعّل بالفعل).
- Botble بيبعت **إيميل طلب تقييم تلقائيًا بعد اكتمال الطلب** (order completed).
- خيار مهم: **"Only allow customers who purchased to review"** — لو فعّلته، بس اللي اشترى يقدر يقيّم.

**الاستخدام:** العميل يفتح صفحة المنتج → يكتب تقييم (نجوم 1–5 + وصف). الإدارة تراجع التقييمات من Ecommerce → Reviews.

---

## 8) مراجعة + رفع صورة في تفاصيل المنتج

**جاهز في Botble.** التفعيل:
- Ecommerce → **Settings → Product Reviews** → فعّل **Allow customer to upload image in review** (اتفعّل بالفعل).
- بعدها فورم التقييم في صفحة المنتج بيسمح برفع صور مع المراجعة، والصور بتظهر في قائمة المراجعات.

---

## 9) إشعار عند توفّر المنتج (Back in stock)

**مبني بالكامل.** إزاي بيشتغل:
1. لما يخلص مخزون منتج (Out of stock)، بيظهر في صفحة المنتج زر **"أعلمني عند التوفر"**:
   - العميل المسجّل: بضغطة واحدة (بإيميله).
   - الزائر: يكتب إيميله ويضغط.
   - بيتخزّن في `nest_stock_subscriptions`.
2. لما ترجع تضيف كمية للمنتج من لوحة التحكم (Ecommerce → Products → عدّل الكمية / stock status) → السيرفر تلقائيًا **يبعت إشعار لكل اللي طلبوا** (اللي مسجّلين يوصلهم على مركز الإشعارات) وبيمسح الاشتراكات المُبلَّغة.

**الاستخدام:** مفيش إعداد — بيشتغل تلقائيًا للمنتجات اللي عليها إدارة مخزون (with storehouse management).

---

## 10) أيقونة الموبايل — Add to Home Screen (PWA)

**مبني بالكامل.** الإعداد:
- Appearance → **Theme Options → Mobile App (Add to Home Screen):**
  - **Enable Add to Home Screen?** = Yes
  - **App short name** = الاسم اللي يظهر تحت الأيقونة (اختياري).
  - **App icon (512×512 PNG)** = ارفع أيقونة مربعة (مهم للشكل الاحترافي؛ لو فاضية بياخد اللوجو/الفافيكون).
  - **Show floating "Install app" button?** = Yes.

**إزاي بيشتغل للعميل:**
- **أندرويد/كروم:** بيظهر زر عائم **"تثبيت التطبيق"** — بضغطة واحدة الأيقونة تتحط على الشاشة الرئيسية.
- **آيفون/سفاري:** بيظهر تلميح: Share → "Add to Home Screen".
- بمجرد الضغط على الأيقونة، بتفتح المتجر مباشرة بشكل تطبيق (بدون شريط المتصفح).

**تقني:** `‎/manifest.webmanifest‎` (ديناميكي) + `‎/nest-sw.js‎` (service worker) + وسوم في الهيد.

---

## ملفات النظام (6, 9, 10)

```
database/migrations/2026_09_21_100000_create_nest_customer_notifications_table.php
platform/themes/nest/src/Services/NestNotificationService.php     # مركز الإشعارات + اشتراكات المخزون
platform/themes/nest/src/Http/Controllers/NotificationController.php
platform/themes/nest/src/Http/Controllers/PwaController.php       # manifest + service worker
platform/themes/nest/views/notifications.blade.php               # صفحة إشعارات العميل
platform/themes/nest/partials/pwa-install.blade.php              # زر التثبيت + تسجيل SW
platform/themes/nest/functions/functions.php                     # هوكات حالة الطلب/الشحن/المخزون
platform/themes/nest/functions/theme-options.php                 # إعدادات PWA
platform/themes/nest/partials/header.blade.php                   # رابط الإشعارات + العدّاد
platform/themes/nest/views/ecommerce/product.blade.php           # زر "أعلمني عند التوفر"
```