# نظام التسعير — Pricing System

**المبدأ:** الإدارة تتحكم في كل الأسعار — المستخدم يرى SDG فقط

---

## سعر الصرف (Exchange Rate)

```
جدول: exchange_rates
إعداد: platform_settings['usd_to_sdg_rate'] = 4100
التحديث: Admin → admin.php → tab=pricing_exchange
التطبيق: فوري — PricingEngine::flushCache()
```

### آلية التحديث
```
Admin يُغيِّر: 1 USD = 4,200 SDG
      ↓
exchange_rates table (سجل تاريخي)
platform_settings['usd_to_sdg_rate'] = 4200
      ↓
PricingEngine::flushCache() → يُفرِّغ /tmp/sudanna_pricing.json
      ↓
api/public/pricing.php يُعيد الأسعار الجديدة
      ↓
index.html + hub.html + corporate-solutions.php
تعرض الأسعار الجديدة تلقائياً
```

### سجل تاريخي + Rollback
```sql
-- عند تغيير السعر:
UPDATE exchange_rates SET is_active=0;
INSERT exchange_rates (rate=4200, previous_rate=4100, change_pct=+2.44, is_active=1);
-- Rollback: ضع is_active=1 للسجل السابق
```

---

## اشتراكات الأفراد

| الخطة | SDG/شهر | بالدولار | AI/يوم | حجوزات/يوم | رصيد وثائق/شهر |
|-------|---------|---------|--------|------------|----------------|
| مجاني | 0 | $0 | 20 | 2 | 0 SDG |
| Plus | 20,000 | ≈$4.88 | 60 | 5 | 15,000 SDG |
| Pro | 50,000 | ≈$12.20 | 200 | 20 | 50,000 SDG |

**ملاحظة:** Plus/Pro لهم override مُفعَّل — السعر مضبوط بالجنيه مباشرة  
(لا يتأثر بتغيير سعر الصرف)

```sql
-- platform_settings
sub_plus_override = 1  → استخدم sub_plus_price_sdg مباشرة
sub_pro_override  = 1  → استخدم sub_pro_price_sdg مباشرة
```

---

## أسعار إصدار الوثائق (SDG)

مستقلة عن سعر الصرف — Admin يضبطها مباشرة

| الوثيقة | مجاني | Plus | Pro |
|---------|-------|------|-----|
| AI Chat (فوق الحد) | 500 | 350 | 0 |
| شهادة إتمام | 1,000 | 700 | 500 |
| عقد تجاري | 5,000 | 3,500 | 2,000 |
| عرض تجاري | 5,000 | 3,500 | 2,000 |
| خطة أعمال | 10,000 | 7,500 | 5,000 |
| ملف شركة | 7,000 | 5,000 | 3,500 |
| دراسة جدوى | 15,000 | 11,000 | 8,000 |
| مذكرة قانونية | 8,000 | 6,000 | 4,000 |
| ترجمة وثيقة | 4,000 | 3,000 | 2,000 |
| تقرير تحليلي | 7,000 | 5,000 | 3,500 |

### مصدر الخصم (بالأولوية)
```
1. subscription_credits (رصيد Plus/Pro الشهري) — مجاني للمستخدم
2. wallet balance — إذا انتهى الرصيد
3. رفض إذا لا رصيد
```

---

## حلول الشركات (USD → SDG تلقائياً)

```
الباقة    USD/شهر   SDG/شهر (عند 4,100)   المستخدمون
Starter   $99        405,900 SDG            50
Business  $249     1,020,900 SDG           200
Scale     $599     2,455,900 SDG          1,000
Custom    تفاوض    من الإدارة             غير محدود
```

**عند تغيير سعر الصرف → SDG يتحدث تلقائياً:**
```
SDG = corp_starter_base_usd × usd_to_sdg_rate
    = 99 × 4,200 = 415,800 SDG (إذا الصرف أصبح 4,200)
```

---

## العمولة والسياسات المالية

```
عمولة المنصة:        10% من كل حجز
ضريبة القيمة:        0% (حالياً)
خصم سنوي:           20%
فترة الاسترداد:      7 أيام
حد الدفع (مجاني):   20,000 SDG/يوم
حد الدفع (Plus):    200,000 SDG/يوم
```

---

## Cache System

```php
// File-based cache (5 دقائق)
$cacheFile = '/tmp/sudanna_pricing.json';

PricingEngine::getAll():
  IF cache exists AND age < 300s → return cache
  ELSE → query DB → write cache → return

PricingEngine::flushCache():
  unlink($cacheFile)  // فوري
  self::$_cache = null
```

---

## API العام للأسعار

```
GET /api/public/pricing.php
→ لا auth مطلوب
→ Cache-Control: public, max-age=300
→ يُعيد كل الأسعار بالجنيه السوداني
```

---

## لوحة تحكم الإدارة

```
admin.php:
  tab=pricing_exchange  → سعر الصرف + سجل + rollback
  tab=pricing_plans     → أسعار Plus/Pro + رصيد الوثائق
  tab=pricing_documents → 10 أنواع × 3 خطط
  tab=pricing_corporate → Starter/Business/Scale بالدولار
  tab=pricing_policies  → عمولة + حدود + سياسات
```
