system-prompts-and-models-o.../dealix/README.ar.md
2026-05-01 14:03:52 +03:00

6.4 KiB
Raw Blame History

🏢 شركة AI السعودية

منصة ذكاء اصطناعي متعددة الوكلاء، جاهزة للإنتاج، للسوق السعودي والخليجي

CI الرخصة: MIT Python 3.12

العربية · English


🌟 نظرة عامة

شركة AI السعودية منصة ذكاء اصطناعي متعددة الوكلاء جاهزة للإنتاج، تُؤتمت:

  • المرحلة 8 — اكتساب العملاء تلقائياً: استقبال العملاء، مطابقة ICP، استخلاص المشاكل، التأهيل BANT، الحجز، مزامنة HubSpot، توليد العروض، الوصول، ومتابعات متدرّجة.
  • المرحلة 9 — النمو المستقل: ذكاء القطاعات السعودية، توليد محتوى ثنائي اللغة، نشر متعدد القنوات، إثراء العملاء، مراقبة المنافسين، وبحث السوق.

مصمّمة للسوق السعودي والخليجي مع دعم عربي من الدرجة الأولى، أسعار بـ الريال السعودي، معرفة بـ توقيت آسيا/الرياض، ومتناغمة مع برامج رؤية 2030.

المزايا الرئيسية

  • 🧠 توجيه ذكي لنماذج LLM — يوزّع المهام بين Anthropic Claude (منطق)، Gemini (بحث)، Groq (تصنيف سريع)، DeepSeek (كود)، GLM (عربي). سلسلة احتياط تلقائية عند الفشل.
  • 🤖 أكثر من 15 وكيلاً إنتاجياً — كل وكيل بمدخلات/مخرجات مُعرَّفة، سجلات مهيكلة، تقهقر لطيف، واختبارات.
  • 🌍 ثنائي اللغة AR/EN — محتوى، سكربتات مبيعات، prompts، واجهات تدعم العربية أولاً.
  • 🔒 الأمن أولاً — الإعدادات من .env فقط، استخدام SecretStr لكل سر، فحوصات gitleaks + detect-secrets + bandit قبل كل commit، تكامل LinkedIn آمن من حيث الشروط.
  • 🐳 جاهز للسحابة — Dockerfile متعدد المراحل، حاوية بمستخدم غير جذري، stack كامل بـ Docker Compose (التطبيق + Postgres + Redis + MongoDB)، CI/CD عبر GitHub Actions.
  • 📊 قابل للمراقبة — سجلات مهيكلة بـ structlog، تتبع LLM اختياري عبر Langfuse، تتبع الاستخدام لكل مزود.
  • 🇸🇦 سعودي أصيل — ١٢ قطاعاً ببيانات منسّقة (عقار، صحة، تعليم، لوجستيات، فينتك…)، مرجع للمنظّمين السعوديين، أسعار بـ SAR/USD، أعياد سعودية.

🚀 البدء السريع

المتطلبات

  • Python 3.11 أو 3.12
  • Docker + Docker Compose (اختياري)
  • على الأقل مفتاح API واحد لـ LLM (يُنصح بـ Anthropic)

1. استنساخ المشروع وإعداد البيئة

git clone https://github.com/YOUR-ORG/ai-company-saudi.git
cd ai-company-saudi

# إعداد لمرة واحدة
make setup

2. إعداد الأسرار

عدّل .env وأضف مفاتيح الـ API. الحد الأدنى: ANTHROPIC_API_KEY.

⚠️ لا ترفع .env أبداً. المشروع يحميك بـ .gitignore و pre-commit hook عبر gitleaks.

3. التشغيل

# محلياً
make run
# → http://localhost:8000/docs

# أو الـ stack الكامل
make docker-up
make docker-logs

4. جرّب

# إرسال عميل محتمل عبر قمع اكتساب العملاء الكامل
curl -X POST http://localhost:8000/api/v1/leads \
  -H "Content-Type: application/json" \
  -d '{
    "company": "شركة التقنية المتقدمة",
    "name": "أحمد محمد",
    "email": "ahmed@example.sa",
    "phone": "+966501234567",
    "sector": "technology",
    "region": "Saudi Arabia",
    "budget": 50000,
    "message": "نحتاج نظام AI لإدارة المبيعات"
  }'

📊 وكلاء المرحلة 8 — الاكتساب

الوكيل الوظيفة
Intake التقاط العملاء من مصادر متعددة، توحيد، تكرار
ICP Matcher تقييم بـ ٥ أبعاد + تصنيف (A/B/C/D)
Pain Extractor استخلاص المشاكل ودرجة الاستعجال (عربي + إنجليزي)
Qualification أسئلة BANT وتحديث المرحلة
Booking Calendly → Google Calendar → يدوي
CRM مزامنة HubSpot (contact + deal)
Proposal عروض مُعدّة بـ Claude، أسعار حسب المنطقة
Outreach افتتاحيات وصول باردة ثنائية اللغة
Follow-up رسائل متابعة متدرّجة

📈 وكلاء المرحلة 9 — النمو

الوكيل الوظيفة
Sector Intel ١٢ قطاعاً سعودياً ببيانات منسّقة
Content Creator مقالات + LinkedIn + دراسات حالة ثنائية اللغة
Distribution جدولة متعددة القنوات (توقيت الرياض)
Enrichment إثراء العميل من النطاق + LLM
Competitor Monitor تحليل المنافسين واقتراح ردود
Market Research بحث سوقي عبر Gemini بمصادر

📚 التوثيق

الوثيقة الوصف
docs/architecture.md هيكل النظام
docs/agents.md كل وكيل مُوثّق
docs/api.md مرجع REST API
docs/deployment.md النشر الإنتاجي
docs/pricing.md الأسعار

🤝 المساهمة

راجع CONTRIBUTING.md.

📜 الرخصة

MIT — راجع LICENSE.