From 50129259129a6a6240ef4cc8481d8cdf62617ed9 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 12 Apr 2026 03:48:48 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20Production=20deployment=20guide=20?= =?UTF-8?q?=E2=80=94=20from=20code=20to=20live=20product?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Step-by-step guide to deploy Dealix to production: 1. Server setup (DigitalOcean/Hetzner, 30 min) 2. Environment configuration (15 min) 3. DNS setup with Cloudflare (10 min) 4. Docker build + launch (5 min) 5. WhatsApp Business API connection (20 min) 6. Stripe payment integration (15 min) 7. Sentry monitoring (5 min) 8. First client test (end-to-end verification) Monthly operating cost: ~283 SAR (covered by 1 client subscription) https://claude.ai/code/session_01LsnvBa7HwF5hs99VZbgLGj --- .../runbooks/production-deployment-guide.md | 247 ++++++++++++++++++ 1 file changed, 247 insertions(+) create mode 100644 salesflow-saas/memory/runbooks/production-deployment-guide.md diff --git a/salesflow-saas/memory/runbooks/production-deployment-guide.md b/salesflow-saas/memory/runbooks/production-deployment-guide.md new file mode 100644 index 00000000..39eeed39 --- /dev/null +++ b/salesflow-saas/memory/runbooks/production-deployment-guide.md @@ -0,0 +1,247 @@ +# Dealix Deployment Guide — من الكود للإنتاج +# دليل النشر الكامل + +**آخر تحديث**: 2026-04-12 + +--- + +## المتطلبات قبل البدء + +### حسابات مطلوبة (سجّل فيها أولاً) + +| الخدمة | الرابط | التكلفة | لماذا | +|--------|--------|---------|-------| +| **DigitalOcean/Hetzner** | digitalocean.com | ~200 ر.س/شهر | سيرفر | +| **Groq** | groq.com | مجاني | AI (primary) | +| **OpenAI** | platform.openai.com | ~$20/شهر | AI (fallback) | +| **Meta Business** | business.facebook.com | مجاني | واتساب | +| **Stripe** | stripe.com | 2.9% + 1 ر.س/معاملة | مدفوعات | +| **Sentry** | sentry.io | مجاني (10K events) | مراقبة أخطاء | +| **Cloudflare** | cloudflare.com | مجاني | DNS + SSL + CDN | +| **دومين .sa** | nic.sa | ~100 ر.س/سنة | dealix.sa | + +--- + +## الخطوة 1: إعداد السيرفر (30 دقيقة) + +```bash +# 1. سجّل VPS (Ubuntu 22.04, 4GB RAM, 2 CPU) +# DigitalOcean: $24/mo أو Hetzner: €8/mo + +# 2. اتصل بالسيرفر +ssh root@YOUR_SERVER_IP + +# 3. ثبّت Docker +curl -fsSL https://get.docker.com | sh +apt install docker-compose-plugin -y + +# 4. ثبّت Git +apt install git -y + +# 5. انسخ المشروع +git clone https://github.com/VoXc2/system-prompts-and-models-of-ai-tools.git +cd system-prompts-and-models-of-ai-tools +git checkout claude/complete-system-prompts-wqJCm +cd salesflow-saas +``` + +--- + +## الخطوة 2: إعداد Environment (.env) (15 دقيقة) + +```bash +cp .env.example .env +nano .env +``` + +**عدّل هذه القيم:** + +```env +# === Database === +DATABASE_URL=postgresql+asyncpg://dealix:YOUR_STRONG_PASSWORD@db:5432/dealix +REDIS_URL=redis://redis:6379/0 + +# === Security === +JWT_SECRET_KEY=GENERATE_64_CHAR_RANDOM_STRING_HERE +JWT_ALGORITHM=HS256 + +# === AI Providers === +GROQ_API_KEY=gsk_YOUR_GROQ_KEY +OPENAI_API_KEY=sk-YOUR_OPENAI_KEY + +# === WhatsApp (Meta Business API) === +WHATSAPP_TOKEN=YOUR_META_ACCESS_TOKEN +WHATSAPP_PHONE_ID=YOUR_PHONE_NUMBER_ID +WHATSAPP_VERIFY_TOKEN=dealix-whatsapp-verify-2026 + +# === Stripe (Payment) === +STRIPE_SECRET_KEY=sk_live_YOUR_KEY +STRIPE_WEBHOOK_SECRET=whsec_YOUR_SECRET + +# === Email === +SMTP_HOST=smtp.gmail.com +SMTP_PORT=587 +SMTP_USER=noreply@dealix.sa +SMTP_PASSWORD=YOUR_APP_PASSWORD + +# === Monitoring === +SENTRY_DSN=https://YOUR_KEY@sentry.io/YOUR_PROJECT + +# === App === +APP_NAME=Dealix +APP_URL=https://dealix.sa +API_URL=https://api.dealix.sa +DEBUG=false +``` + +**كيف تولّد JWT_SECRET_KEY:** +```bash +python3 -c "import secrets; print(secrets.token_hex(32))" +``` + +--- + +## الخطوة 3: DNS (10 دقائق) + +في Cloudflare: +``` +dealix.sa → A → YOUR_SERVER_IP (Proxied) +api.dealix.sa → A → YOUR_SERVER_IP (Proxied) +app.dealix.sa → A → YOUR_SERVER_IP (Proxied) +``` + +--- + +## الخطوة 4: إطلاق (5 دقائق) + +```bash +# 1. بناء وتشغيل كل الخدمات +docker compose build --no-cache +docker compose up -d + +# 2. تشغيل Migrations +docker compose exec backend alembic upgrade head + +# 3. تحميل البيانات الأولية +docker compose exec backend python -m app.seeds.run + +# 4. التحقق +curl -f https://api.dealix.sa/api/v1/health +curl -f https://dealix.sa +``` + +--- + +## الخطوة 5: ربط WhatsApp (20 دقيقة) + +### في Meta Business: +1. اذهب لـ developers.facebook.com +2. أنشئ App جديد → Business type +3. أضف WhatsApp product +4. أنشئ Business phone number +5. احصل على Access Token +6. اضبط Webhook URL: + ``` + URL: https://api.dealix.sa/api/v1/webhooks/whatsapp/incoming + Verify Token: dealix-whatsapp-verify-2026 + ``` +7. اشترك في messages events + +### في .env: +```env +WHATSAPP_TOKEN=YOUR_PERMANENT_TOKEN +WHATSAPP_PHONE_ID=YOUR_PHONE_ID +``` + +### اختبر: +```bash +# أرسل رسالة للرقم من جوالك +# يجب أن يرد تلقائياً: "أهلاً وسهلاً! أنا مساعد ديلكس الذكي..." +``` + +--- + +## الخطوة 6: ربط Stripe (15 دقيقة) + +### في Stripe Dashboard: +1. أنشئ Product: "Dealix All-in-One" +2. أضف Price: 1,499 SAR/month (recurring) +3. أضف Price: 14,999 SAR/year (recurring) +4. اضبط Webhook: + ``` + URL: https://api.dealix.sa/api/v1/webhooks/payment + Events: checkout.session.completed, customer.subscription.updated, invoice.paid + ``` +5. ضبط Tax: Saudi Arabia VAT 15% + +--- + +## الخطوة 7: مراقبة (5 دقائق) + +### Sentry: +1. أنشئ Project (Python/FastAPI) +2. انسخ DSN لـ .env +3. ارجع وشغّل: `docker compose restart backend` + +### التحقق اليومي: +```bash +# Health check +curl https://api.dealix.sa/api/v1/health + +# Logs +docker compose logs -f backend --since 1h + +# Celery +docker compose logs -f celery-worker --since 1h +``` + +--- + +## الخطوة 8: أول عميل (الاختبار النهائي) + +1. افتح https://dealix.sa +2. اضغط "جرّب ٧ أيام مجاناً" +3. سجّل بإيميلك +4. أكمل الـ Onboarding (اختر دور + صناعة) +5. أنشئ أول عميل محتمل +6. أنشئ أول صفقة +7. جرّب الواتساب (أرسل لرقم Dealix) +8. جرّب Pipeline (اسحب صفقة بين المراحل) +9. جرّب الإعدادات (غيّر الاسم، ادعُ عضو) +10. جرّب تبديل اللغة (عربي ↔ English) + +**إذا كل شي شغال = جاهز للتدشين الفعلي.** + +--- + +## الصيانة الدورية + +### يومياً (تلقائي): +- Celery Beat يشغل: follow-ups, sequences, reports, lead scoring + +### أسبوعياً: +- راجع Sentry errors +- راجع WhatsApp delivery rates +- راجع تكلفة AI (Groq/OpenAI) + +### شهرياً: +- حدّث dependencies: `pip install --upgrade -r requirements.txt` +- اختبر backup restore +- راجع PDPL compliance + +--- + +## تكلفة التشغيل الشهرية + +| البند | التكلفة | +|-------|---------| +| سيرفر (4GB RAM) | ~200 ر.س | +| دومين .sa | ~8 ر.س (سنوي/12) | +| Groq API | مجاني | +| OpenAI API | ~75 ر.س | +| WhatsApp Business | مجاني (أول 1000 محادثة/شهر) | +| Sentry | مجاني | +| Cloudflare | مجاني | +| **الإجمالي** | **~283 ر.س/شهر** | + +**مع أول عميل واحد (1,499 ر.س) = تغطي تكاليف التشغيل + ربح.**