system-prompts-and-models-of-ai-tools/dealix/docs/LAUNCH_MASTER_RUNBOOK_AR.md

Dealix — Launch Master Runbook (AR)

الهدف: إخراج Dealix من «جاهزية الكود» إلى «إطلاق تجاري حقيقي» بـ 10 خطوات واضحة. الجمهور: سامي (المؤسس) + أي عضو فريق onboarding مستقبلي. آخر تحديث: 2026-05-01

---

✅ ما تم بالفعل (مرفوع على GitHub ai-company)

• Backend: 28 router · 266 endpoint · 24 DB table
• Modules: revenue_memory · orchestrator · market_intelligence · copilot · revenue_science · compliance_os · vertical_os · revenue_graph · customer_success · ecosystem · personal_operator · v3 · business · innovation · ai
• Frontend: 33 صفحة landing (privacy, terms, signup, welcome, payment success/cancel, 404, 500 — كلها أُضيفت اليوم)
• Tests: 477 passed, 2 skipped على Python 3.10 venv
• CI: Dealix API CI خضراء على GitHub
• Compat: Python 3.10 + 3.11+ shim
• Legal: privacy.html + terms.html (PDPL-aligned)
• Security: SECURITY.md + LICENSE
• Sitemap + robots محدّث

---

🚦 ما يحتاج خطوات يدوية للإطلاق التجاري

1️⃣ النطاق و DNS

• شراء/تأكيد ملكية dealix.sa (الأولوية) أو dealix.me (مؤقت)
• DNS records:
  • A → IP الخادم Railway/Cloudflare
  • CNAME api → Railway public domain
  • CNAME www → root
  • MX → Google Workspace / Zoho Mail
  • TXT → SPF + DMARC + DKIM (لإيميلات outbound)
• SSL certificate (Railway/Cloudflare auto)
• Cloudflare proxy + WAF rules

2️⃣ Railway / Hosting

• إنشاء مشروع Railway باسم dealix-api
• ربط GitHub repo: VoXc2/system-prompts-and-models-of-ai-tools
• Root directory: dealix/
• Branch: ai-company (ثم نحول إلى main بعد الاستقرار)
• Build command: auto (Railway يلتقط Dockerfile)
• Start command: uvicorn api.main:app --host 0.0.0.0 --port $PORT
• إضافة Postgres add-on (Saudi-region لو متاح، أو EU/Bahrain)
• إضافة Redis add-on (للجلسات + rate limiting)

3️⃣ Environment Variables (Railway → Variables)

من dealix/.env.example، الحرجة للإطلاق:

# Core
APP_ENV=production
APP_NAME=Dealix
APP_HOST=0.0.0.0
APP_PORT=$PORT
DATABASE_URL=$RAILWAY_POSTGRES_URL
REDIS_URL=$RAILWAY_REDIS_URL

# Security
API_KEY_PRIMARY=<generate via openssl rand -hex 32>
JWT_SECRET=<generate via openssl rand -hex 32>
CORS_ORIGINS=https://dealix.sa,https://www.dealix.sa

# LLM (one provider minimum)
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...

# WhatsApp (one provider minimum)
GREEN_API_INSTANCE_ID=...
GREEN_API_TOKEN=...
# OR Meta WhatsApp Cloud:
META_WHATSAPP_PHONE_ID=...
META_WHATSAPP_TOKEN=...
META_WHATSAPP_VERIFY_TOKEN=<random>

# Gmail OAuth (per-customer flow)
GOOGLE_OAUTH_CLIENT_ID=...
GOOGLE_OAUTH_CLIENT_SECRET=...
GOOGLE_OAUTH_REDIRECT_URI=https://api.dealix.sa/auth/google/callback

# Moyasar (Saudi billing)
MOYASAR_PUBLIC_KEY=pk_live_...
MOYASAR_SECRET_KEY=sk_live_...
MOYASAR_WEBHOOK_SECRET=<set in Moyasar dashboard>

# Observability
SENTRY_DSN=https://...@sentry.io/...
LANGFUSE_PUBLIC_KEY=...
LANGFUSE_SECRET_KEY=...
POSTHOG_API_KEY=phc_...

# Supabase (project memory + pgvector)
SUPABASE_URL=https://....supabase.co
SUPABASE_SERVICE_ROLE_KEY=eyJ... (server only — never client)

4️⃣ Database Migrations

• تنفيذ alembic upgrade head على Railway Postgres
• تنفيذ supabase/migrations/202605010001_v3_project_memory.sql على Supabase
• تأكيد الفهارس على pgvector (HNSW) للمحادثات

5️⃣ Domain → API → Frontend

• api.dealix.sa → Railway service
• dealix.sa و www.dealix.sa → static hosting من landing/ (Cloudflare Pages أو Netlify)
• إعادة توجيه dealix.me → dealix.sa (لو الاثنين موجودان)
• تحديث CORS_ORIGINS ليشمل النطاق الفعلي

6️⃣ المدفوعات (Moyasar)

• حساب Moyasar مفعّل (يحتاج CR + IBAN سعودي)
• webhook URL: https://api.dealix.sa/api/v1/webhooks/moyasar
• اختبار الدفع بمبلغ رمزي (1 ريال) قبل الإطلاق
• تأكد من ZATCA invoice template (15% VAT تلقائي)

7️⃣ WhatsApp Business Account

• WABA verified عبر Meta أو موزع معتمد (مثل Green API بحساب Saudi)
• رقم سعودي (+966) موثّق
• template messages معتمدة بالعربية:
  • welcome_v1 — تأكيد الاشتراك
  • daily_brief_v1 — التقرير اليومي
  • approval_pending_v1 — تنبيه drafts بحاجة موافقة
• webhook signature verified

8️⃣ Email Deliverability

• Google Workspace أو Zoho Mail لـ @dealix.sa
• SPF: v=spf1 include:_spf.google.com ~all
• DKIM: تفعيل من Google Workspace
• DMARC: v=DMARC1; p=quarantine; rua=mailto:dmarc@dealix.sa
• التسخين (warm-up) لمدة 14 يوم قبل الإرسال الكثيف

9️⃣ Observability live

• Sentry — إنشاء project + DSN
• Langfuse — حساب + public/secret keys
• PostHog — موقع
• Status page (statusapi.io أو internal /status.html يربط بـ /health/deep)
• Uptime monitor (Better Uptime / UptimeRobot) → /health

🔟 Beta Launch Day (T-Day)

• T-7 days: smoke test كامل على staging
• T-3 days: invite-only beta (5 شركات أصدقاء)
• T-1 day: dry run — 24h لتشغيل النظام بصمت
• T-Day morning:
  • post على LinkedIn (announcement)
  • WhatsApp blast لقائمة الـ 50 شركة
  • إرسال press release لـ TechCrunch Arabia / Wamda
• T+1: مراقبة active 24/7 لأول 72 ساعة
• T+7: retrospective + fix top-3 bugs

---

🧪 Smoke Test Manual (قبل الإطلاق)

# 1. Health
curl https://api.dealix.sa/health
# expected: {"status": "ok", ...}

# 2. Deep health
curl https://api.dealix.sa/health/deep -H "X-API-Key: $API_KEY_PRIMARY"
# expected: db, redis, llm checks all OK

# 3. Public landing pages
for page in / /pricing.html /privacy.html /terms.html /signup.html /command-center.html; do
  echo -n "$page: "
  curl -s -o /dev/null -w "%{http_code}\n" https://dealix.sa$page
done
# expected: all 200

# 4. Trigger a workflow (with API key)
curl -X POST https://api.dealix.sa/api/v1/revenue-os/workflows/run \
  -H "X-API-Key: $API_KEY_PRIMARY" -H "Content-Type: application/json" \
  -d '{"customer_id":"smoke","autonomy_mode":"draft_and_approve"}'
# expected: 8 tasks created, all awaiting_approval (since draft mode)

# 5. Copilot ask
curl -X POST https://api.dealix.sa/api/v1/revenue-os/copilot/ask \
  -H "X-API-Key: $API_KEY_PRIMARY" -H "Content-Type: application/json" \
  -d '{"question_ar":"وش أسوي اليوم؟","customer_id":"smoke","context":{}}'
# expected: intent=what_to_do_today + answer + 3 actions

# 6. Compliance risk gate
curl -X POST https://api.dealix.sa/api/v1/revenue-os/compliance/campaign-risk \
  -H "X-API-Key: $API_KEY_PRIMARY" -H "Content-Type: application/json" \
  -d '{"target_count":100,"contacts_with_consent":80,"contacts_opted_out":20,
       "contacts_no_lawful_basis":0,"template_body":"ضمان 100% رقم الهوية",
       "has_unsubscribe_link":false}'
# expected: risk_band="blocked" + 2 blockers

---

📊 KPIs لأول 30 يوم

المقياس	الهدف
Uptime	≥99.5%
API p95 latency	<200ms
Beta signups	10-20 شركة
First Daily Run completed	≥80% من الـ signups
First WhatsApp draft approved	≥50%
Errors / 1000 requests	<5
Stripe/Moyasar successful payment rate	≥95%
NPS من أول 5 عملاء	≥30

---

🆘 خطة الطوارئ (Rollback Plan)

لو حصلت مشكلة كارثية:

1. Database: استرجاع من Railway snapshot (آخر 24 ساعة)
2. API: إرجاع لآخر commit مستقر عبر Railway → Deployments → rollback
3. Frontend: rollback CDN إلى آخر deploy stable
4. WhatsApp: تعطيل الـ outbound حتى توضّح المشكلة (PDPL gate)
5. التواصل: post status update فوراً + إيميل لكل المتأثرين خلال ساعة

جهات الاتصال الطارئة:

• Railway support: support@railway.app
• Moyasar: support@moyasar.com (24/7)
• Sentry: support.sentry.io
• WhatsApp Cloud / Green API: حسب الموزع

---

🎯 الجملة الأخيرة قبل الإطلاق

"البرنامج جاهز. النظام جاهز. الباكد إند والفرونت إند جاهزون. الآن: ربط الحسابات + اختبار يدوي + إطلاق صامت 7 أيام، ثم إعلان كبير."

— Dealix · Saudi Autonomous Revenue Platform · 🇸🇦