# خطة تحسينات HalaVoice — يوليو 2026

> نتاج مراجعة كاملة للكود + بحث معمق في المنافسين (Vapi, Retell, Bland, Synthflow, ElevenLabs Agents، ومنصات عربية: Voysera, Dello, Nabrah, Maqsam, NEVOX) وGitHub وHuggingFace.

---

## أولاً: ما تم إصلاحه في هذه المراجعة (منجز ✅)

| # | المشكلة | الإصلاح |
|---|---------|---------|
| 1 | 3 إضافات تفشل عند الإقلاع (arabic-enhancement-kit, elevenlabs-fix, debt-collection-compliance) | إعادة كتابتها لتطابق عقد الـloader + تجميعها إلى `.js` للإنتاج |
| 2 | إضافة debt-collection-compliance ناقصة (بلا index.ts، استيرادات مفقودة، migration بأنواع أعمدة خاطئة) | إنشاء نقطة الدخول، إصلاح types.ts، إصلاح UUID mismatch، إنشاء الجداول السبعة |
| 3 | انحراف مخطط قاعدة البيانات: جداول `groq_credentials`, `habibi_credentials`, `habibi_voices` وأعمدة agents مفقودة | إنشاؤها لتطابق `shared/schema.ts` — كان يكسر resync المواعيد وأي select كامل على agents |
| 4 | 118 خطأ TypeScript، منها bugs فعلية وقت التشغيل | صفر أخطاء الآن. أهمها: استدعاء دوال غير موجودة في storage (مسارات admin webhooks)، `testApiKey` static تُستدعى كـinstance (Habibi)، تفكيك QueryResult خاطئ (onboarding يفشل بصمت)، حالة batch `running` لا تطابق ما تتوقعه الواجهة `in_progress` (شاشة تقدم الحملة)، Google Calendar sync يستدعي دالة غير موجودة |
| 5 | تحذيرات migrations مفقودة لإضافة messaging | تنظيف الـmanifest |

**ملاحظة تشغيلية:** عملية `jadwaai` في PM2 (تعمل بصلاحية root) تعيد التشغيل بلا توقف (395+ مرة) — تطبيق منفصل لكنه يستهلك موارد ويلوث السجلات. يُنصح بإيقافها أو إصلاحها.

---

## ثانياً: فجوات مقارنةً بالمنافسين (من البحث)

### ما يملكه المنافسون ولا تملكه المنصة حالياً
1. **اختبار ومحاكاة الوكلاء (Agent Testing/Simulation)** — Vapi وElevenLabs يقدمان Test Suites ومحادثات محاكاة مع تقييم تلقائي. ElevenLabs يوفر Simulate Conversations API جاهزة يمكن البناء عليها مباشرة.
2. **مراقبة المكالمات الحية (Live Call Monitoring)** — Retell يعرض المحادثات النشطة لحظياً مع إمكانية التدخل.
3. **A/B Testing للوكلاء** — مقارنة نسختين من prompt/صوت على عينات إحصائية.
4. **تحليلات متقدمة ولوحات مخصصة** — تتبع التحويل، ROI، أسباب إنهاء المكالمات، درجات الجودة لكل مكالمة (LLM-as-judge).
5. **Knowledge Base بمزامنة تلقائية** — Retell يسحب من موقع العميل تلقائياً ويحدّث.
6. **تحويل وكيل-إلى-وكيل (Agent-to-Agent Transfer)** — مدعوم الآن في ElevenLabs API (`visited_agents`) — إضافة سهلة نسبياً.
7. **قناة WhatsApp رسمية لوكلاء ElevenLabs** — ElevenLabs أطلقت ربط WhatsApp Business مباشرة بالوكيل؛ المنصة تعتمد على Evolution API (غير رسمي، مخاطر حظر).

### التميّز العربي (الفرصة الأكبر)
المنافسون العرب (NEVOX يدعم 15+ لهجة، KalaMena يسوّق نجدي/حجازي/خليجي) يتقدمون في اللهجات. أصول مفتوحة المصدر متاحة:
- **SILMA TTS v1** (150M، عربي/إنجليزي، استنساخ صوت فوري، زمن استجابة منخفض) — المنصة تملك تكامل SILMA بالفعل لكنه **معطّل** حالياً.
- **Lahgtna** — TTS لهجات (مصري، سعودي، مغربي، عراقي) مع تشكيل كامل.
- **F5-TTS-Arabic**، **VoxCPM2** (استنساخ صوت متعدد اللغات).
- LLMs عربية: **Jais-2 70B** (17 لهجة)، **ALLaM 34B** (سعودي رسمي)، **Fanar**، **SILMA**، **Falcon-H1-Arabic**.
- معيار قياس: silma-ai/opensource-arabic-tts-benchmark على HuggingFace.

---

## ثالثاً: خطة التحسينات المقترحة

### المرحلة 1 — استقرار وأمان (أسبوع–أسبوعان)
1. **أتمتة فحص انحراف المخطط**: خطوة CI/cron تقارن `shared/schema.ts` مع قاعدة البيانات وتنبّه (هذا سبب أعطال صامتة متكررة).
2. **إضافة `npm run check` إلى خطوة ما قبل النشر** — الآن صفر أخطاء؛ حافظ عليها.
3. **تقسيم حزمة الواجهة** (6.1MB JS!) عبر `manualChunks` وlazy routes — تحسين مباشر لسرعة التحميل خاصة على شبكات الجوال الخليجية.
4. **نقل كلمة مرور قاعدة البيانات خارج CLAUDE.md/التوثيق** إلى `.env` فقط، وتدوير كلمة المرور.
5. **إصلاح/إيقاف عملية jadwaai** المتعطلة في PM2.
6. **امتثال PDPL السعودي**: توثيق مكان تخزين التسجيلات، سياسة احتفاظ، وموافقة تسجيل المكالمات (إضافة debt-compliance التي فعّلناها أساس جيد — عمّمها كـ"وضع امتثال" عام غير مقصور على التحصيل). غرامات SDAIA تصل 5 ملايين ريال.

### المرحلة 2 — تكافؤ تنافسي (شهر–شهرين)
7. **اختبار الوكلاء والمحاكاة**: واجهة "Test Suite" لكل وكيل تستدعي ElevenLabs Simulate Conversations API (للوكلاء المبنية عليها) + محاكاة نصية عبر LLM لوكلاء OpenAI Realtime. تقييم تلقائي (نجح/فشل + سبب).
8. **مراقبة حية**: صفحة admin/user تعرض المكالمات النشطة (WebSocket موجود بالفعل) مع transcript لحظي وزر إنهاء/تدخل.
9. **تحويل وكيل-إلى-وكيل** لوكلاء ElevenLabs (استغلال `visited_agents` الجديدة) — يفتح سيناريو "استقبال → فرز → متخصص".
10. **تحليلات أعمق**: تصنيف نتيجة كل مكالمة تلقائياً (LLM-judge عبر Groq الرخيص)، لوحة تحويلات الحملة، أسباب الفشل، متوسط زمن الرد.
11. **Knowledge Base بمزامنة تلقائية**: كشط دوري لموقع العميل/ملفاته وإعادة رفعها لقاعدة معرفة الوكيل.
12. **قناة WhatsApp الرسمية**: دعم WhatsApp Business Cloud API (بجانب Evolution) — يقلل مخاطر الحظر ويتيح القوالب الرسمية وWhatsApp Flows (نماذج تفاعلية داخل المحادثة للحجز والدفع) — Meta Business Agent العالمي يثبت اتجاه السوق.

### المرحلة 3 — التميّز العربي (رهان استراتيجي)
13. **تفعيل SILMA TTS** (الإضافة موجودة ومعطلة!) واستضافة النموذج محلياً (150M خفيف) — يعطي ميزة تسعير (بلا رسوم لكل حرف) وسيادة بيانات داخل السعودية.
14. **دعم اللهجات**: دمج Lahgtna أو fine-tune على لهجة العميل + خيار "اللهجة" في إعدادات الوكيل (نجدي/حجازي/مصري/شامي) — NEVOX يسوّق هذا كميزة أولى.
15. **LLM عربي كخيار محرك**: إتاحة Jais-2 / ALLaM / SILMA عبر Groq/OpenRouter كبديل لـGPT في المحادثات العربية — جودة لهجات أفضل وتكلفة أقل.
16. **كشف اللهجة تلقائياً** في أول ثوانٍ من المكالمة والتبديل للوكيل/الصوت المناسب.
17. **بنية self-hosted اختيارية بالكامل** (Pipecat أو LiveKit Agents كمحرك بديل) لعملاء المؤسسات الذين يشترطون بقاء الصوت داخل المملكة (PDPL data residency) — لا أحد من المنافسين العالميين يقدمها بسهولة.

### المرحلة 4 — نمو المنتج
18. **A/B Testing للوكلاء** (prompt/صوت/رسالة افتتاحية) مع مقاييس نجاح لكل نسخة.
19. **Widget محادثة صوتية للويب قابل للتضمين** بتصميم أحدث + وضع chat نصي fallback.
20. **سوق قوالب وكلاء عربي** (عيادات، عقارات، مطاعم، تحصيل) — يوجد أساس templates بالفعل؛ حوّله لكتالوج جاهز بنقرة.
21. **تسعير لكل دقيقة شفاف** في صفحة الأسعار (السوق يقارن بـ$0.07–0.35/دقيقة) مع حاسبة تكلفة.

---

## مصادر البحث الرئيسية
- مقارنات المنصات: softcery.com/lab/choosing-the-right-voice-agent-platform-in-2026 ، retellai.com/blog/best-voice-ai-providers ، tested.media/retell-vs-vapi-vs-bland-vs-synthflow
- ElevenLabs: elevenlabs.io/docs (Agent Testing, Simulate Conversations, Agent Transfer, Batch Calling, WhatsApp)
- منافسون عرب: voysera.ai, dello.ai, nabrah.ai, maqsam.com, nevoxai.com, kalamena.ai
- نماذج عربية: silma.ai/open-source-arabic-tts-models ، huggingface.co/spaces/silma-ai/opensource-arabic-tts-benchmark ، github.com/OmarSalah26/Awesome-Arabic-AI
- أطر مفتوحة: github.com/pipecat-ai/pipecat ، github.com/livekit/agents ، TEN Framework
- امتثال: SDAIA AI Adoption Framework + PDPL (غرامات حتى 5M ريال)