mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2026-06-18 23:39:34 +00:00
4.5 KiB
4.5 KiB
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. ترتيب التنفيذ الموصى به
- نسخ
backend/.env.phase2.example→backend/.env. - تعبئة الأمان والقاعدة والذكاء والبريد.
- ربط Salesforce (Connected App + OAuth).
- تفعيل واتساب (رمز + تعطيل
WHATSAPP_MOCK_MODE+VERIFY_TOKENللويبهوك). - Stripe + سر الويبهوك.
- Twilio للصوت.
- DocuSign أو Adobe Sign.
- استدعاء:
GET /api/v1/autonomous-foundation/integrations/go-live-gate
حتىlaunch_allowed: true. - اختبار تشغيل:
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.