تطوير موقع وربطه بالذكاء الاصطناعي

# متطلبات تطوير الذكاء الاصطناعي لمنصة تمام

## 1. الهدف من المشروع

نرغب في تطوير منصة **تمام لتعقيب المعاملات** وإضافة نظام ذكاء اصطناعي متكامل لخدمة العملاء والموظفين وإدارة المحادثات والمكالمات.

المطلوب ليس تدريب نموذج ذكاء اصطناعي من الصفر، بل استخدام نموذج جاهز مثل OpenAI API وربطه ببيانات وخدمات تمام.

الهدف:

* استقبال العميل وفهم طلبه.

* تحديد نوع المعاملة والقسم.

* إعطاء المعلومات والأوراق المطلوبة.

* قراءة الصور والمستندات.

* تلخيص المحادثات والمكالمات.

* تحليل الصوت والمكالمات.

* تحويل العميل للموظف المختص.

* مساعدة الموظفين في الرد.

* ربط WhatsApp والمكالمات بملف العميل.

* تقليل الأخطاء والنسيان.

* إنشاء قاعدة معرفة قابلة للتحديث.

---

# 2. Tamam AI Assistant

إنشاء مساعد ذكي داخل منصة تمام باسم **Tamam AI Assistant**.

يجب أن تكون بنية النظام قابلة لتغيير مزود الذكاء الاصطناعي مستقبلاً بدون إعادة بناء المنصة.

مثلاً:

* OpenAI.

* أو أي LLM آخر.

ويجب فصل AI Provider عن Business Logic.

---

# 3. قاعدة معرفة تمام

إنشاء Knowledge Base تشمل خدمات الشركة مثل:

### التجارة

* تأسيس شركة.

* تجديد ترخيص.

* تغيير عنوان أو نشاط.

* دخول وخروج شريك.

* تغيير مدير.

* مستخرج تجاري.

* مستفيد فعلي.

* ميزانيات.

* استيراد.

* علامات تجارية.

### القوى العاملة

* إذن عمل.

* تحويل عامل.

* تجديد وإلغاء.

* تصاريح.

* اعتماد توقيع.

* تقدير احتياج.

* بلاغات تغيب.

### الإقامات

* إصدار وتجديد إقامة.

* مادة 18.

* تحويل إقامة.

* نقل معلومات.

* التحاق بعائل.

* عمالة منزلية.

* بصمة وفحص طبي.

### البلدية والمطافي

* إصدار وتجديد.

* إعلان.

* كروت صحة.

* معاملات البلدية والمطافي.

### التأشيرات والزيارات

* زيارة عائلية.

* زيارة تجارية.

* كرت زيارة.

* فيز وتأشيرات.

ويجب أن نستطيع إضافة أي خدمة جديدة مستقبلاً.

---

# 4. إدارة قاعدة المعرفة

إنشاء لوحة تحكم تسمح للإدارة بإضافة وتعديل وحذف وإيقاف المعلومات بدون الرجوع للمبرمج.

لكل خدمة:

* اسم المعاملة.

* القسم.

* الوصف.

* المستندات المطلوبة.

* السعر.

* المدة التقريبية.

* الملاحظات.

* الأسئلة الشائعة.

* حالة الخدمة.

---

# 5. RAG ومنع اختراع المعلومات

استخدام نظام RAG بحيث يبحث AI داخل قاعدة معرفة تمام قبل الإجابة.

إذا لم يجد معلومة مؤكدة لا يخترع الجواب، بل يحول العميل للموظف المختص.

خصوصاً في:

* الأسعار.

* الأوراق.

* القوانين.

* الشروط.

* المدد.

* الإجراءات.

---

# 6. أسلوب الرد

أسلوب المساعد:

* عربي بسيط.

* يفهم اللهجة الكويتية.

* ودود ومحترم.

* مختصر.

* غير روبوتي.

مثال:

"وعليكم السلام، حياك الله في تمام 🌹 شنو المعاملة اللي تحتاجها؟"

---

# 7. فهم العميل وتصنيف الطلب

يجب أن يفهم عبارات مثل:

* أبي أجدد إقامة.

* أبي أحول عامل.

* شنو مطلوب؟

* كم تكلف؟

* أبي أفتح شركة.

* أبي أغير نشاط.

* رخصتي خلصت.

* أبي موظف.

ويحدد تلقائياً:

* Department.

* Service.

* Intent.

* Confidence Score.

* Priority.

* Human Handoff.

إذا كانت الثقة منخفضة يسأل العميل سؤالاً إضافياً.

---

# 8. جمع البيانات وسياق المحادثة

يجمع فقط البيانات المطلوبة حسب نوع المعاملة مثل:

* الاسم.

* رقم الهاتف.

* اسم الشركة.

* الرقم المدني.

* رقم الترخيص.

* رقم الملف.

ولا يكرر سؤالاً سبق أن أجاب عنه العميل.

ويجب حفظ سياق المحادثة بالكامل.

مثال:

العميل: أبي أجدد إقامة العامل.

AI: مادة 18؟

العميل: إي.

يجب أن يفهم أن المعاملة هي تجديد إقامة مادة 18.

---

# 9. قراءة الصور والمستندات

يجب دعم قراءة:

* البطاقة المدنية.

* جواز السفر.

* إذن العمل.

* الرخصة التجارية.

* اعتماد التوقيع.

* Screenshots.

* المستندات الحكومية.

ويتم:

* تحديد نوع المستند.

* استخراج البيانات المهمة.

* عرضها للموظف للمراجعة.

* معرفة المستندات الناقصة.

مثلاً:

Civil ID / Passport / Work Permit / Commercial License.

---

# 10. ربط WhatsApp

يجب أن يعمل AI من خلال WhatsApp API.

المسار:

WhatsApp → Webhook → Tamam Backend → AI → Knowledge Base → Response.

جميع الرسائل يجب أن تمر عبر Backend منصة تمام ولا يتم ربط WhatsApp مباشرة بالـ AI.

---

# 11. أوضاع المحادثة

لكل محادثة 3 أوضاع:

### AI Mode

AI يرد تلقائياً.

### Human Mode

الموظف فقط يرد.

### Copilot Mode

AI يقترح الرد والموظف يعتمد أو يعدل.

عندما يستلم الموظف المحادثة يتوقف AI عن الرد تلقائياً.

---

# 12. تحويل المحادثة للموظف

يتم التحويل عندما:

* العميل يريد بدء معاملة.

* يريد الدفع.

* يطلب موظفاً.

* AI غير متأكد.

* العميل غاضب.

* توجد مستندات تحتاج مراجعة.

* السؤال غير موجود في قاعدة المعرفة.

ويتم التحويل تلقائياً حسب القسم.

ويفضل توزيع المحادثات حسب:

* القسم.

* Round Robin.

* عدد المحادثات المفتوحة.

* Online / Offline.

---

# 13. ملخص المحادثة

عند تحويل العميل للموظف يقوم AI بإنشاء ملخص يتضمن:

* اسم العميل.

* نوع المعاملة.

* الشركة.

* الطلب.

* المستندات المستلمة.

* المستندات الناقصة.

* ما تم الاتفاق عليه.

* آخر إجراء.

* الخطوة القادمة.

ويتم تحديث الملخص تلقائياً.

---

# 14. أدوات AI للموظف

داخل المحادثة نريد:

* اقتراح رد.

* تحسين الرد.

* اختصار الرد.

* إعادة توليد.

* رسمي / ودود / كويتي / مختصر.

ويكون هناك شات داخلي باسم:

**اسأل تمام AI**

بحيث يستطيع الموظف السؤال عن أي معاملة ويأخذ الإجابة من قاعدة المعرفة.

---

# 15. تحليل العميل والمبيعات

AI يصنف العميل:

* جاهز للبدء.

* مهتم.

* استفسار.

* شكوى.

ويحدد:

* High.

* Medium.

* Normal.

ويفضل دعم Sentiment Analysis لمعرفة رضا أو غضب العميل.

---

# 16. ملف العميل الموحد

إنشاء Customer Profile يحتوي على:

* الاسم.

* الهاتف.

* الشركات المرتبطة.

* المحادثات.

* المكالمات.

* المعاملات.

* الملاحظات.

* المرفقات.

* المدفوعات.

* الخدمات السابقة.

ويجب أن يظهر كل شيء في Timeline واحد.

مثال:

WhatsApp Message

Call

Internal Note

Transaction Update

Payment

WhatsApp Message

---

# 17. ربط المكالمات بالعميل

عند ورود أو إجراء أي مكالمة يجب أن يبحث النظام عن رقم الهاتف تلقائياً.

إذا كان العميل موجوداً:

* يظهر ملفه.

* آخر المحادثات.

* معاملاته.

* شركاته.

* الملاحظات.

* المكالمات السابقة.

إذا لم يكن موجوداً يمكن إنشاء عميل جديد.

كل مكالمة يجب أن ترتبط بملف العميل وبالمحادثة أو المعاملة المناسبة.

---

# 18. تسجيل وتحليل المكالمات

يجب دعم تسجيل المكالمات حسب القوانين والسياسات المعتمدة.

لكل مكالمة يتم حفظ:

* رقم العميل.

* الموظف.

* التاريخ والوقت.

* المدة.

* Incoming / Outgoing.

* التسجيل الصوتي.

* حالة المكالمة.

* المعاملة المرتبطة.

---

# 19. تحويل الصوت إلى نص

بعد المكالمة يستخدم AI:

**Speech-to-Text**

لتحويل المكالمة إلى نص.

ويفضل فصل المتحدثين:

الموظف: ...

العميل: ...

ويتم حفظ النص داخل سجل العميل.

---

# 20. ملخص المكالمة

بعد كل مكالمة يقوم AI بإنشاء Summary يتضمن:

* سبب الاتصال.

* نوع المعاملة.

* طلب العميل.

* المعلومات المهمة.

* ما تم الاتفاق عليه.

* المستندات المطلوبة.

* الخطوة القادمة.

* هل يحتاج متابعة.

* هل توجد شكوى أو فرصة بيع.

---

# 21. استخراج المهام من المكالمة

AI يستخرج Action Items مثل:

* إرسال رابط دفع.

* طلب صورة جواز.

* متابعة موافقة.

* التواصل مع العميل.

* إنشاء معاملة.

* تحويل لموظف آخر.

ويستطيع الموظف تحويلها إلى Task أو Transaction.

---

# 22. تحليل المكالمات

يقوم AI بتصنيف المكالمة حسب:

* القسم.

* نوع الخدمة.

* استفسار.

* متابعة.

* شكوى.

* سعر.

* دفع.

* طلب معاملة.

ويحلل:

* Sentiment.

* رضا العميل.

* احتمالية الشراء.

* أولوية المتابعة.

---

# 23. AI أثناء المكالمة

مستقبلاً نريد AI Copilot أثناء المكالمة Live ليعرض للموظف:

* معلومات العميل.

* الخدمة المحتملة.

* الأوراق المطلوبة.

* إجابة مقترحة.

* تنبيه بالمعلومات المهمة.

بدون أن يتحدث AI مع العميل إلا عند تفعيل Voice AI مستقبلاً.

---

# 24. تحليل أداء المكالمات والموظفين

Dashboard خاص بالمكالمات يعرض:

* عدد المكالمات.

* المكالمات الواردة والصادرة.

* المكالمات الفائتة.

* متوسط مدة المكالمة.

* سرعة الرد.

* أكثر أسباب الاتصال.

* نسبة الشكاوى.

* عدد فرص البيع.

ويمكن لـ AI تقييم المكالمة وإعطاء Call Score حسب:

* الترحيب.

* فهم العميل.

* معرفة الخدمة.

* أسلوب التواصل.

* تحديد الخطوة القادمة.

* إغلاق البيع.

مع إعطاء ملاحظات لتحسين الموظف.

---

# 25. نظام المعاملات

يمكن تحويل المحادثة أو المكالمة إلى Transaction.

البيانات:

* العميل.

* الخدمة.

* الموظف.

* السعر.

* التاريخ.

* الحالة.

الحالات:

* جديدة.

* بانتظار المستندات.

* جاهزة للتقديم.

* تم التقديم.

* بانتظار الموافقة.

* بانتظار الدفع.

* قيد الإنجاز.

* منجزة.

* مرفوضة.

* ملغاة.

وعند تغير الحالة يمكن إرسال إشعار للعميل تلقائياً.

---

# 26. Dashboard وتقارير AI

لوحة الإدارة تعرض:

* محادثات اليوم.

* مكالمات اليوم.

* عدد ردود AI.

* التحويلات للموظفين.

* أكثر الخدمات طلباً.

* العملاء الجاهزين.

* الشكاوى.

* سرعة الرد.

* المعاملات الناتجة.

* نسبة AI مقابل Human.

---

# 27. الأسئلة غير المجاب عنها

إنشاء صفحة Unanswered Questions لتسجيل أي سؤال لم يعرف AI الإجابة عنه.

تستطيع الإدارة إضافة الإجابة إلى Knowledge Base لاحقاً.

---

# 28. AI Feedback & Logs

الموظف يستطيع تقييم الإجابة:

👍 صحيحة

👎 خاطئة

ويتم تسجيل:

* User Message.

* Retrieved Knowledge.

* AI Response.

* Model.

* Tokens.

* Latency.

* Confidence.

* Timestamp.

---

# 29. مراقبة التكلفة

لوحة تعرض:

* عدد AI Requests.

* Tokens.

* تكلفة اليوم.

* تكلفة الشهر.

* تكلفة كل محادثة أو مكالمة تقريباً.

---

# 30. Prompt Management

لا أريد Prompts مكتوبة Hard-coded فقط.

يجب أن نستطيع تعديل:

* Customer Service Prompt.

* Summary Prompt.

* Classification Prompt.

* Document Prompt.

* Call Analysis Prompt.

* Employee Copilot Prompt.

ويفضل حفظ Version History.

---

# 31. Security والصلاحيات

يجب حماية:

* المحادثات.

* التسجيلات الصوتية.

* أرقام العملاء.

* البطاقات المدنية.

* الجوازات.

* الملفات.

* بيانات الشركات.

Roles:

* Super Admin.

* Admin.

* Manager.

* Employee.

* AI Manager.

مع صلاحيات حسب القسم والحاجة.

ولا يتم وضع API Keys في Frontend.

---

# 32. Audit Log

تسجيل:

* من فتح العميل.

* من استمع للمكالمة.

* من حمل ملفاً.

* من عدل المعاملة.

* من غير السعر.

* من عدل معلومات AI.

* من حذف أو عدل خدمة.

---

# 33. البنية التقنية

يفضل دعم:

* Queue System.

* Redis إذا كان مناسباً.

* Rate Limiting.

* Webhook Idempotency.

* Database Indexing.

* Caching.

* Development / Staging / Production.

* Backup.

* Error Monitoring.

---

# 34. Database

الجداول الرئيسية المقترحة:

* Users.

* Roles.

* Customers.

* Companies.

* Conversations.

* Messages.

* Calls.

* Call Transcripts.

* Attachments.

* Transactions.

* Services.

* Knowledge Articles.

* AI Requests.

* AI Feedback.

* AI Summaries.

* Prompts.

* Payments.

* Tasks.

* Notifications.

* Audit Logs.

---

# 35. Function Calling

يفضل استخدام AI Tools / Function Calling مثل:

* get_service_information

* search_customer

* create_transaction

* get_transaction_status

* handoff_to_agent

* create_note

* create_task

* link_call_to_customer

مع Permission Check قبل التنفيذ.

---

# 36. العمليات الحساسة

AI لا يجب أن ينفذ تلقائياً:

* حذف عميل.

* حذف معاملة.

* تغيير سعر.

* تعديل بيانات حساسة.

* تنفيذ دفع.

* إجراء نهائي مهم.

بدون Human Approval.

---

# 37. ملكية المشروع والتوثيق

جميع:

* Source Code.

* Database.

* Prompts.

* API Integrations.

* Documentation.

* Git Repository.

تكون ملكاً لشركة تمام.

ويجب تسليم توثيق:

* Architecture.

* Database.

* APIs.

* Deployment.

* Environment Variables.

* AI Configuration.

* WhatsApp Integration.

* Call Center Integration.

* Backup.

---

# 38. مراحل التنفيذ

## المرحلة الأولى

* Knowledge Base.

* RAG.

* WhatsApp AI.

* Classification.

* Human Handoff.

* Summary.

* Suggested Replies.

## المرحلة الثانية

* Document AI.

* Customer Profile.

* Transactions.

* AI Analytics.

* Feedback.

## المرحلة الثالثة

* Call Center Integration.

* تسجيل وتحليل المكالمات.

* Speech-to-Text.

* ربط المكالمات بملف العميل.

* Call Summary.

* Call Scoring.

* Voice AI مستقبلاً.

---

# 39. المطلوب من المطور قبل البدء

أحتاج:

1. التقنية المستخدمة.

2. Architecture.

3. AI Provider.

4. طريقة RAG.

5. Vector Database.

6. WhatsApp Integration.

7. Call Center Integration.

8. طريقة تحليل الصوت.

9. حماية البيانات.

10. تصميم Database.

11. Backup Plan.

12. AI Logs.

13. تكلفة السيرفر.

14. تكلفة AI والصوت.

15. مراحل وتسليمات المشروع.

---

# 40. الاختبار

قبل الإطلاق يتم اختبار سيناريوهات حقيقية مثل:

* أبي أجدد رخصة.

* أبي أحول عامل.

* أبي أفتح شركة.

* شنو الأوراق؟

* كم السعر؟

* أبي موظف.

* إرسال جواز.

* مستند ناقص.

* اتصال عميل لمتابعة معاملة.

* شكوى عبر مكالمة.

* تحويل مكالمة إلى معاملة.

* ربط المكالمة بملف العميل.

ويجب التأكد أن AI لا يخترع المعلومات.

---

# الهدف النهائي

المطلوب ليس Chatbot فقط.

المطلوب بناء نظام ذكاء اصطناعي متكامل داخل تمام يربط:

**WhatsApp + Calls + AI + Customer Profile + Transactions + Documents + Employees**

في منصة واحدة.

بحيث أي موظف يفتح ملف العميل يعرف:

* ماذا كتب العميل.

* ماذا قال في المكالمات.

* ما معاملاته.

* ما المستندات الموجودة.

* ما تم الاتفاق عليه.

* ما الخطوة القادمة.

**مهم جداً:** أريد الخدمات والأسعار والأوراق والـ Prompts وإعدادات AI قابلة للتعديل من لوحة الإدارة بدون الحاجة للمبرمج في كل مرة.