# 📘 دليل المستخدم — Bobex Communication Center

> دليل شامل بالعربي لاستخدام لوحة تحكم Bobex AI. مُخصَّص للموظفين والمدراء (وليس للمطورين).

---

## 🚪 1. الدخول إلى اللوحة

### الرابط
افتح المتصفح على:
**http://51.68.45.142:5000**

### تسجيل الدخول
- **البريد الإلكتروني**: مثلاً `admin@bobex.local` (تركه فارغاً يستخدم كلمة السر المشتركة)
- **كلمة السر**: ما زوّدك بها المدير
- اختر لغتك من الأزرار في الأسفل: **FR / NL / EN / AR**

> 🛡️ كل البيانات محمية. لا أحد يقدر يدخل بدون حساب وكلمة سر.

---

## 🗺️ 2. خريطة اللوحة

اللوحة فيها 9 أقسام رئيسية (تظهر في الـ sidebar على اليسار):

| الأيقونة | القسم | الفائدة |
|---|---|---|
| 📊 | **اللوحة الرئيسية** (Dashboard) | KPIs + رسوم بيانية مباشرة |
| 📞 | **المكالمات** (Calls) | جدول كل المكالمات + أزرار التحليل والتسجيل |
| 🧠 | **العملاء** (Customers) | CRM مصغّر + ذاكرة لكل رقم |
| 🔀 | **Extensions** | إدارة الأرقام الداخلية وأدوارها |
| 📈 | **تحليل AI** (Analytics) | تقارير دورية ذكية |
| 🚨 | **تنبيهات** (Alerts) | إشعارات حية (مشاعر سلبية، أخطاء...) |
| 📑 | **قاعدة المعرفة** (Knowledge Base) | FAQ يستخدمها الذكاء الاصطناعي للرد |
| 🔄 | **التحويلات** (Transfers) | إحصاءات تحويل المكالمات |
| ⚙️ | **الإعدادات** (Settings) | ساعات العمل + متاحية الوكلاء |
| 👥 | **المستخدمون** (Users) | إدارة حسابات اللوحة *(admin فقط)* |
| 📚 | **السجل** (History) | كل المحادثات الدائمة المحفوظة |

---

## 📞 3. كيف يعمل الاتصال

1. زبون يتصل بالرقم: **+322 886 0449**
2. النظام يردّ بالتحية الثنائية: *"Bonjour, goeiedag..."*
3. الذكاء الاصطناعي يستمع ويردّ بنفس لغة الزبون (FR/NL/EN/AR/...)
4. إذا الزبون طلب شخص محدد:
   - يقول مثلاً *"بدي أحكي مع المدير"*
   - النظام يقول *"أحوّلك حالاً"*
   - يحوّل المكالمة لـ **Extension 104** (هاتف المدير)
5. إذا المدير ردّ → اتصال مباشر بينهم
6. كل شيء (الصوت + النص + الإحصاءات) يُحفظ تلقائياً

---

## 🧠 4. قسم العملاء (Customers / CRM)

### عرض ملف عميل
1. ادخل قسم **العملاء**
2. اختر عميل من القائمة اليسرى → يفتح ملفه الكامل في الجانب الأيمن
3. ترى:
   - 📊 عدد المكالمات + الوقت الإجمالي + اللغة السائدة + المشاعر
   - 🧠 **حقائق محفوظة** (Memory Facts) — معلومات يتذكرها AI في كل مكالمة
   - 📞 جدول المكالمات السابقة مع أزرار:
     - **💬** = عرض نص المحادثة
     - **💿** = تشغيل التسجيل الصوتي
     - **📝** = إضافة ملاحظات يدوية / tags
     - **🤖 تحليل** = تقرير ذكي مفصّل

### إضافة Memory Fact (شيء يتذكره AI)
- في ملف العميل، تحت "حقائق محفوظة":
- اكتب المعلومة (مثلاً: *"يفضّل التحدث بالعربية"*)
- اختر فئة: ملاحظة / تفضيل / معلومة / شكوى
- اختر أهمية: ★ → ★★★★★
- اضغط **+**
- ✅ في المكالمة التالية، Gemini ستعرف هذه المعلومة وتستخدمها

### الاتصال بالعميل (Outbound)
- زر **📞 اتصل** بجانب اسم العميل
- يطلب رقم extension الخاص بك (مثلاً 104)
- النظام يرنّ هاتفك أولاً، عندما تردّ يطلب العميل ويربطكم

### البحث في النصوص
- في قسم العملاء، فيه حقل بحث ثاني **🔎 بحث transcripts**
- اكتب أي كلمة → يفتح modal بكل المكالمات التي ذُكرت فيها هذه الكلمة (مع تظليل المكان)

---

## 📞 5. قسم المكالمات

جدول بكل المكالمات الأخيرة، لكل صف:
- UUID مختصر، رقم المتصل، الرقم المتصَل به، البداية، المدة، الحالة
- زر **🤖 تحليل** → تقرير AI مفصّل عن هذه المكالمة بنفس لغتك

### المكالمات الجارية (في الـ Dashboard)
- ترى المكالمات النشطة فوراً
- زر **🔄 تحويل** على أي مكالمة جارية → تحوّلها يدوياً لأي extension

---

## 🤖 6. تحليل AI (3 مستويات)

### مستوى 1 — تحليل مكالمة واحدة
- اضغط **🤖 تحليل** بجانب أي مكالمة
- التقرير يحتوي:
  - الملخص التنفيذي
  - تصنيف المكالمة (مبيعات/دعم/شكوى/استفسار...)
  - تحليل المشاعر (إيجابي/محايد/سلبي) + السبب
  - النقاط الرئيسية
  - الخطوات التالية
  - حالة الحل
  - ضمان الجودة (هل التزم AI بالترحيب؟ السرية؟ النبرة؟)

### مستوى 2 — رحلة عميل
- في ملف العميل، اضغط **📊 رحلة العميل**
- يحلل كل مكالمات هذا الرقم ويعطيك:
  - ملف العميل
  - المواضيع المتكررة
  - اتجاه الرضا (تحسّن/تدهور)
  - نقاط الإحباط
  - الفرص
  - إجراءات مقترحة

### مستوى 3 — تقرير لفترة (Bulk)
- ادخل قسم **تحليل AI**
- اختر فترة (24 ساعة / 7 أيام / 30 يوم / مخصص)
- اضغط **توليد**
- التقرير يعطيك:
  - عدد المكالمات
  - نسبة الحل بالـ AI بدون تحويل بشري
  - المواضيع الرائجة
  - مؤشر الرضا العام (CSAT)
  - المشاكل الشائعة
  - **توصيات لتحسين الـ prompt** ← مهمة جداً لتطوير النظام

### تصدير التقرير
- في الـ modal: زر **🖨 PDF** (يفتح حوار طباعة → "حفظ كـ PDF")
- زر **📋 JSON** للنسخ كنص

---

## 🚨 7. التنبيهات

النظام يولّد تنبيهات تلقائياً عند:
- ❗ مشاعر سلبية في مكالمة
- ❗ نفس العميل اتصل وحُوّل 3 مرات في 24 ساعة
- ❗ مكالمة طويلة (أكثر من 10 دقائق)
- ❗ مكالمة انتهت بخطأ تقني

في الـ sidebar فيه **🔴 badge أحمر** بعدد التنبيهات غير المؤكَّدة.
- اضغط على التنبيه → اضغط **✓** للتأكيد
- اضغط على checkbox "تضمين المؤكَّدة" لعرض الـ history

---

## 📑 8. قاعدة المعرفة (Knowledge Base)

هذا قسم مهم جداً للأعمال: تضيف فيه أسئلة + أجوبة، والنظام تلقائياً يحقنها في AI prompt.

### كيف تستخدمها
1. ادخل قسم **قاعدة المعرفة**
2. أدخل سؤال (مثلاً: *"ما هي ساعات العمل؟"*)
3. أدخل الإجابة (مثلاً: *"من الإثنين للجمعة 9-18، عطلة السبت والأحد"*)
4. اختر فئة + أهمية
5. اضغط **+**
6. ✅ في المكالمات التالية، إذا أي زبون سأل هذا السؤال، AI سيستخدم إجابتك بطريقة طبيعية

### تعطيل أو حذف
- **OFF/ON**: لإيقاف عنصر بدون حذفه
- **×**: لحذفه نهائياً

---

## ⏰ 9. الإعدادات (ساعات العمل + المتاحية)

### ساعات العمل
- لكل يوم من الأسبوع: حدد ساعة الفتح والإغلاق
- ✅ مفعّل / ❌ معطّل (للعطلات الأسبوعية)
- **خارج ساعات العمل**: AI يخبر الزبون أن المكتب مغلق ولا يحوّل لأحد

### متاحية الوكلاء
لو موظف في إجازة:
1. ابحث عن extension تبعه (مثلاً 104)
2. أزل علامة "متاح"
3. اكتب السبب (مثلاً: *"إجازة"*)
4. حدد التاريخ والوقت اللي يرجع فيه
- ✅ AI لن يحوّل أي مكالمة لهذا الـ extension حتى ذلك الوقت

---

## 🔀 10. إدارة Extensions

في قسم Extensions:
- جدول بكل الـ extensions الموجودة (101, 102, 103, 104)
- **عدّل الاسم/الدور/الوصف مباشرة** → يُحفظ تلقائياً بعد 0.5 ثانية
- **ON/OFF**: لتعطيل extension مؤقتاً
- **+ Ajouter**: لإضافة extension جديد (يحتاج إعداد على لوحة Zadarma أيضاً)

⚠ مهم: عند تغيير اسم extension من هنا، AI يتعرف عليه فوراً في المكالمة التالية. مثلاً لو غيّرت 104 من "Manager" إلى "Patron"، الزبون لو قال "patron" سيتحوّل بشكل صحيح.

---

## 👥 11. إدارة المستخدمين (admin فقط)

هذا القسم يظهر فقط للمستخدمين بدور **admin**.

### الأدوار
| الدور | الصلاحيات |
|---|---|
| **admin** | كل شيء + إدارة المستخدمين + تعديل الإعدادات |
| **operator** | كل القراءة + الكتابة في CRM/notes + تنفيذ تحويلات |
| **viewer** | قراءة فقط |

### إضافة موظف
1. ادخل قسم **المستخدمون**
2. املأ الفورم: Email + الاسم + كلمة سر + الدور + اللغة
3. اضغط **+**
4. أعطِ الموظف عنوانه + كلمة السر

### تغيير كلمة سر مستخدم
- اضغط **🔑** بجانب اسمه
- أدخل الكلمة الجديدة

### حذف مستخدم
- اضغط **×** (لا يمكنك حذف نفسك)

---

## 📚 12. السجل (History)

كل المحادثات المحفوظة دائماً. تقدر:
- 🔎 البحث برقم أو نص
- 📅 الفلترة بتاريخ
- ⬇ تصدير JSON
- 🗑️ حذف مكالمة واحدة أو كل المكالمات
- اضغط **💬 Transcript** لرؤية المحادثة الكاملة
- اضغط **🤖 تحليل** لتحليل المكالمة بـ AI

---

## 💰 13. التكلفة

في الـ Dashboard، تحت "ملخص النظام":
- التكلفة الإجمالية (USD)
- الصوت vs التحليل (تفصيل)
- 24 ساعة / 7 أيام / 30 يوم
- مجموع دقائق الصوت

التكاليف بناءً على:
- **الصوت**: ~ $0.029 / دقيقة (Gemini Live audio)
- **التحليل**: ~ $0.003 / تقرير

---

## 🔐 14. الأمان

- ✅ كلمة سر إجبارية للدخول
- ✅ كل استدعاء API محمي بـ token مع انتهاء صلاحية بعد 24 ساعة من عدم النشاط
- ✅ التحويلات محصورة في 101-104 فقط (لا يمكن لـ AI تحويل لرقم آخر)
- ✅ معلومات كل عميل معزولة — AI لا يقدر يقرأ بيانات عميل آخر
- ✅ كلمات السر مُشفّرة بـ scrypt (لا تُخزّن plain text)

---

## 🆘 15. حل المشاكل الشائعة

| المشكلة | الحل |
|---|---|
| لا أستطيع الدخول | اطلب من admin يعمل reset لكلمة السر |
| التقرير بلغة خاطئة | غيّر اللغة من الـ topbar قبل توليد التقرير |
| الـ Dashboard لا يحدّث | اضغط `Ctrl+Shift+R` لتجاوز الـ cache |
| لا أرى الـ recording | تأكد المكالمة انتهت + التسجيل يحفظ بعد المكالمة |
| AI لا يتذكر الزبون | تأكد رقم الزبون ظاهر (ليس "unknown") |

---

## 📞 الدعم الفني

لأي مشكلة، تواصل مع المدير التقني:
- **WhatsApp**: +32 ...
- **Email**: tech@bobex.com
- **Slack**: #bobex-support

---

*آخر تحديث: 2026-05-26 — الإصدار 2.0 (Multi-user + Recordings + 13 features)*