# العروض والتخفيضات في السيستم — دليل خطوة بخطوة

## 1. إنشاء خصم خاص (التعريف)

**المسار:** القائمة الجانبية ← **التسعير** ← **الخصومات الخاصة**

أو مباشرة: `/pricing/special-discounts`

1. اضغط **"إنشاء خصم جديد"**
2. املأ البيانات:
   - **اسم الخصم** (مثال: "خصم أبناء شهداء")
   - **النوع**: نسبة مئوية / مبلغ ثابت / سنوات مجانية
   - **النسبة أو المبلغ**
   - **الشروط**: تاريخ بداية ونهاية، فرع معين، يحتاج مستند إثبات أم لا
   - **سنوات مجانية** (bonus): عدد السنوات التي يُعفى فيها العضو من الاشتراك السنوي
3. احفظ ← الخصم يظهر في القائمة ويمكن تفعيله/تعطيله

---

## 2. تطبيق الخصم على عضو

**المسار:** الأعضاء ← اختر العضو ← صفحة العضو

1. افتح صفحة العضو (`/members/{id}`)
2. ابحث عن قسم **"خصم خاص"** (يظهر فقط إذا كان العضو في حالة `accepted` أو `payment_pending`)
3. اختر الخصم من القائمة المنسدلة
4. إذا كان يحتاج مستند ← ارفع ملف الإثبات
5. اضغط **"تطبيق الخصم"**
6. يظهر ✅ باسم الخصم والمبلغ المخصوم — ويمكنك إزالته بزر ❌

---

## 3. عروض مجلس الإدارة (Board Offers)

**الملف:** `app/Modules/Members/Services/BoardOfferService.php`

هذه عروض تُطبق **تلقائياً** على جميع الأعضاء المستوفين خلال فترة العرض.

- تُخزن في جدول `board_offers`
- تحتوي على: رقم القرار، تاريخ القرار، نوع العرض (خصم نقدي / خصم اشتراك / تغيير أقساط)
- تُطبق تلقائياً أثناء الفوترة (عبر `BillingService`)

> ملاحظة: حالياً لا يوجد UI لإدارة عروض مجلس الإدارة — يتم إدخالها في الداتابيز مباشرة.

---

## 4. خصومات الاشتراكات السنوية (سنوية تلقائية)

**المسار:** القائمة الجانبية ← **التسعير** ← **لوحة التسعير** (`/pricing`)

- في لوحة التسعير، يمكنك ضبط **نسبة تعديل سنوية** لكل سنة مالية (مثلاً: خصم 50% لسنة 2023/2024)
- تُطبق تلقائياً عند توليد الاشتراكات السنوية عبر `SubscriptionGenerator`
- يتم تعريفها كـ Rule Engine key: `SUBSCRIPTION_YEAR_ADJUSTMENT_2024_2025`

---

## 5. خصومات الأنشطة الرياضية (الأكاديميات)

تُطبق تلقائياً عند التسجيل في الأكاديميات:

- **خصم الدفع المقدم**: دفع 3+ شهور مقدماً = 15%
- **خصم الأشقاء**: أخ/أخت مسجل في نفس النشاط = خصم محدد

هذه تُدار من جدول `sa_discount_rules` ولا تحتاج تدخل يدوي.

---

## 6. خصومات العضوية الموسمية

تُطبق تلقائياً عند إنشاء عضوية موسمية:

- **خصم عائلي** (أكثر من شخص في نفس العائلة)
- **خصم بدون مؤهل**: 10%
- **خصم عضو مؤهل**: 20%

---

## ملخص المسارات

| العملية                        | المسار في السيستم             |
| ------------------------------ | ----------------------------- |
| إدارة الخصومات الخاصة          | التسعير ← الخصومات الخاصة     |
| تطبيق خصم على عضو              | صفحة العضو ← قسم "خصم خاص"    |
| خصومات سنوية (rate adjustment) | التسعير ← لوحة التسعير        |
| عروض مجلس الإدارة              | (تلقائية — لا يوجد UI حالياً) |
| خصومات الأكاديميات             | (تلقائية عند التسجيل)         |
| خصومات الموسمي                 | (تلقائية عند الإنشاء)         |
