# دليل إعداد المشرف — Dealix Admin Setup Guide

> **الجمهور**: مدير IT أو المسؤول التقني عند العميل  
> **المدة**: 30-60 دقيقة

---

## 1. إنشاء الحسابات

### حساب المشرف (أنت)
- ادخل على `https://[your-domain]/`
- سجّل باسمك وإيميلك
- الدور: `admin`
- اللغة: `ar` (عربي) أو `en`

### حسابات الفريق
لكل عضو في الفريق:
1. اذهب إلى **الإعدادات** → **المستخدمون**
2. أضف مستخدم جديد
3. حدد الدور:

| الدور | الصلاحيات |
|-------|----------|
| `admin` | كل شيء — الإعدادات والمستخدمين والتقارير |
| `manager` | الموافقات + التقارير + الإدارة |
| `sales` | إدارة الصفقات والعملاء + WhatsApp |
| `viewer` | عرض فقط — لا تعديل |

---

## 2. إعداد القنوات

### WhatsApp Business
1. اذهب إلى **الإعدادات** → **القنوات** → **WhatsApp**
2. أدخل:
   - WhatsApp API Token
   - Phone Number ID
   - Verify Token
3. اختبر بإرسال رسالة لرقمك

### البريد الإلكتروني
1. اذهب إلى **الإعدادات** → **القنوات** → **البريد**
2. أدخل إعدادات SMTP أو SendGrid API Key
3. اختبر بإرسال بريد تجريبي

---

## 3. إعداد الموافقات

### حدود SLA
| الإعداد | القيمة الافتراضية | التوصية |
|---------|------------------|---------|
| تحذير SLA | 8 ساعات | 4-8 ساعات |
| خرق SLA | 24 ساعة | 12-24 ساعة |
| التصعيد الحرج | 2× الخرق | الافتراضي |

### من يوافق؟
حدد لكل نوع قرار:
- **رسائل WhatsApp**: المدير المباشر
- **خصم >10%**: مدير المبيعات
- **خصم >25%**: VP
- **شراكة جديدة**: CEO

---

## 4. استيراد البيانات

### استيراد العملاء المحتملين
1. جهز ملف CSV بالأعمدة: `company_name, contact_phone, contact_email, source, status`
2. اذهب إلى **العملاء** → **استيراد**
3. ارفع الملف
4. تحقق من التطابق

### استيراد الصفقات
1. جهز ملف CSV: `title, value, stage, assigned_to`
2. المراحل المتاحة: `new`, `negotiation`, `proposal`, `closed_won`, `closed_lost`

---

## 5. إعداد الامتثال

### PDPL
- الموافقة **إلزامية** قبل أي رسالة صادرة
- النظام يتحقق تلقائياً — لا تحتاج إعداد
- الموافقة تنتهي تلقائياً بعد 12 شهر

### مراجعة الامتثال
1. اذهب إلى **الامتثال** → **المصفوفة**
2. اضغط "تشغيل الفحص"
3. راجع النتائج — أخضر (ممتثل) / أصفر (جزئي) / أحمر (غير ممتثل)

---

## 6. إعداد Executive Room

### للمدير التنفيذي
1. أنشئ حساب بدور `manager` أو `admin`
2. افتح **غرفة القيادة** من القائمة
3. سيرى:
   - الإيرادات الفعلية مقابل التوقعات
   - الموافقات المعلقة مع SLA
   - حالة الامتثال
   - حالة الموصلات

### للمراجعة الأسبوعية
استخدم `GET /api/v1/executive-room/weekly-pack` للحصول على تقرير أسبوعي مهيكل.

---

## 7. التحقق النهائي

- [ ] كل أعضاء الفريق سجلوا دخولهم
- [ ] WhatsApp يرسل ويستقبل
- [ ] البريد الإلكتروني يعمل
- [ ] SLA مُعدّ
- [ ] 5+ صفقات مُدخلة
- [ ] Executive Room تعرض بيانات
- [ ] فحص الامتثال نجح

**إذا كل شيء أخضر، النظام جاهز للاستخدام اليومي.**