mancitrus/system-prompts-and-models-of-ai-tools
1
0
Fork 0
mirror of https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git synced 2026-06-18 23:39:34 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
b938969a7e
system-prompts-and-models-o.../salesflow-saas/frontend/public/strategy/INTEGRATION_MASTER_AR.md
Sami Assiri 378ea5f742 chore: snapshot Dealix salesflow phase2 for audit worktree 
Made-with: Cursor
2026-04-04 18:04:21 +03:00

4.5 KiB
Raw Blame History

Dealix — ملف الربط الشامل للتكاملات والإطلاق التجاري

الغرض: جدول مرجعي لكل متغيرات البيئة، الويبهوكات، وترتيب التفعيل للبيع والتشغيل الفعلي.
مرافق للـ API: GET /api/v1/autonomous-foundation/integrations/go-live-gate وGET .../live-readiness.

1. آلية بوابة الإطلاق (Go-Live Gate)

  • الوضع: launch_mode: full_commercial — فحوص إلزامية يجب أن تمر كلها حتى launch_allowed: true.
  • الجاهزية: readiness_percent = نسبة النجاح للفحوص الإلزامية فقط.
  • إضافية: readiness_percent_total تشمل فحوصاً اختيارية (HubSpot، Unifonic، إلخ).
  • التصنيف: حقل categories في JSON يقسم البنود حسب: الأمان، البيانات، الذكاء، القنوات، CRM، المدفوعات، الصوت، العقود، التشغيل، تكاملات إضافية.

2. جدول المتغيرات الإلزامية (للبيع والتشغيل الكامل)

المتغير الفئة ملاحظات
SECRET_KEY أمان ليس القيمة الافتراضية change-this...
DATABASE_URL بيانات PostgreSQL + asyncpg
GROQ_API_KEY أو OPENAI_API_KEY ذكاء واحد على الأقل
SENDGRID_API_KEY أو SMTP_USER + SMTP_PASSWORD بريد للإشعارات والعروض
SALESFORCE_CLIENT_ID CRM Connected App
SALESFORCE_CLIENT_SECRET CRM
SALESFORCE_REFRESH_TOKEN CRM OAuth
SALESFORCE_DOMAIN CRM مثل login.salesforce.com
WHATSAPP_API_TOKEN قنوات Meta Graph
WHATSAPP_PHONE_NUMBER_ID قنوات
WHATSAPP_VERIFY_TOKEN قنوات ويبهوك التحقق من Meta
WHATSAPP_MOCK_MODE=false قنوات إيقاف المحاكاة للإرسال الحقيقي
STRIPE_SECRET_KEY مدفوعات
STRIPE_WEBHOOK_SECRET مدفوعات للتحقق من توقيع Stripe
TWILIO_ACCOUNT_SID صوت
TWILIO_AUTH_TOKEN صوت
TWILIO_FROM_NUMBER صوت E.164
DOCUSIGN_ACCESS_TOKEN أو ADOBE_SIGN_ACCESS_TOKEN عقود أحد المزودين على الأقل

اختياري (لا يمنع الإطلاق): HUBSPOT_API_KEY, UNIFONIC_APP_SID, RAPIDAPI_KEY, ENVIRONMENT=production (يُنصح)، API_URL / FRONTEND_URL للإنتاج.

3. ويبهوكات (Webhooks)

المصدر الغرض نقطة الربط في Dealix
Stripe invoice.paid, customer.subscription.updated, إلخ مسارك العام + /api/v1/.../webhooks حسب التطبيق — ربط STRIPE_WEBHOOK_SECRET
Meta / WhatsApp رسائل واتساب الواردة URL عام HTTPS؛ نفس الخادم يستقبل التحقق باستخدام WHATSAPP_VERIFY_TOKEN
أنظمة أخرى POST /api/v1/autonomous-foundation/integrations/webhook-hub/{provider} هيكل عام للاستقبال

في الإنتاج: HTTPS إلزامي، ولا تعرّض مفاتيح الويبهوك في الواجهة الأمامية.

4. ترتيب التنفيذ الموصى به

  1. نسخ backend/.env.phase2.example → backend/.env.
  2. تعبئة الأمان والقاعدة والذكاء والبريد.
  3. ربط Salesforce (Connected App + OAuth).
  4. تفعيل واتساب (رمز + تعطيل WHATSAPP_MOCK_MODE + VERIFY_TOKEN للويبهوك).
  5. Stripe + سر الويبهوك.
  6. Twilio للصوت.
  7. DocuSign أو Adobe Sign.
  8. استدعاء:
    GET /api/v1/autonomous-foundation/integrations/go-live-gate
    حتى launch_allowed: true.
  9. اختبار تشغيل:
    POST /api/v1/autonomous-foundation/integrations/connectivity-test (بحذر في الإنتاج).

5. الواجهة الأمامية (Next.js)

  • انسخ frontend/.env.example إلى .env.local.
  • NEXT_PUBLIC_API_URL = نفس أساس الـ API الذي يصل إليه المتصفح (CORS مضبوط في main.py عبر FRONTEND_URL).

6. المراجع في المستودع

الملف
backend/.env.phase2.example
docs/LAUNCH_CHECKLIST.md
frontend/.env.example
openclaw/openclaw-config.yaml

آخر تحديث: يتبع مصفوفة app/services/go_live_matrix.py.