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

Dealix — Universal Deployment Guide

دليل نشر Dealix على أي منصة: Railway, Render, Fly.io, Heroku, DigitalOcean, AWS, Docker self-hosted.

---

🎯 TL;DR — نشر خلال 10 دقائق

1. أي منصة تدعم Docker → استخدم Dockerfile الموجود في root
2. عيّن env vars من .env.example (انسخه كبداية)
3. Health check: GET /health
4. التطبيق يستمع على ${PORT:-8000}
5. يتطلب PostgreSQL (اختياري — التطبيق يعمل بدونه في dev mode)

---

📦 المتغيرات المطلوبة (Minimum للإنتاج)

الإلزامية (بدونها الدفع ما يشتغل)

# Security
APP_SECRET_KEY=CHANGE_ME_64_byte_hex  # generate: python -c "import secrets; print(secrets.token_hex(32))"
ENVIRONMENT=production
LOG_LEVEL=INFO

# Database (Railway/Render/Heroku postgres auto-normalize لـ asyncpg)
DATABASE_URL=postgresql://user:pass@host:5432/dealix

# Moyasar Payments
MOYASAR_SECRET_KEY=sk_live_xxxxx
MOYASAR_WEBHOOK_SECRET=CHANGE_ME_shared_with_moyasar_dashboard

# PostHog Analytics (اختياري لكن موصى به)
POSTHOG_API_KEY=phc_xxxxx
POSTHOG_HOST=https://us.i.posthog.com

# Calendly
CALENDLY_URL=https://calendly.com/sami-assiri11/dealix-demo
CALENDLY_WEBHOOK_SECRET=xxxxx

# CORS (أضف domain الـ landing)
CORS_ORIGINS=https://dealix.sa,https://www.dealix.sa

الاختيارية

API_KEYS=key1,key2  # إذا بدك حماية admin endpoints
APP_URL=https://dealix.sa  # للـ checkout callback
SENTRY_DSN=https://...@sentry.io/...

---

🚀 نشر على المنصات المختلفة

1) Railway (الموصى به — مجاني تقريباً)

إعداد أولي:

1. افتح https://railway.com → New Project → Deploy from GitHub → اختر VoXc2/dealix
2. Railway يكتشف Dockerfile تلقائياً
3. أضف Postgres: + New → Database → PostgreSQL
4. اذهب لخدمة dealix → Variables → Raw Editor
5. الصق محتوى dealix_railway_vars.txt (يُرفق مع الحزمة)
6. Settings → Deploy → Start Command: اتركه فارغ (يستخدم Dockerfile)
7. احفظ → Railway ينشر تلقائياً

التحقق:

curl https://<your-app>.up.railway.app/health
# {"status":"ok"}

2) Render

1. https://render.com → New → Web Service → Connect GitHub → VoXc2/dealix
2. اختر Docker runtime
3. Add environment variables من .env.example
4. Health Check Path: /health
5. Add PostgreSQL من Render marketplace
6. Deploy

3) Fly.io

fly launch --dockerfile Dockerfile
fly secrets set APP_SECRET_KEY=... MOYASAR_SECRET_KEY=...
fly postgres create --name dealix-db
fly postgres attach dealix-db
fly deploy

4) Heroku

heroku create dealix-api
heroku stack:set container
heroku addons:create heroku-postgresql:mini
heroku config:set APP_SECRET_KEY=... MOYASAR_SECRET_KEY=...
git push heroku main

5) DigitalOcean App Platform

1. https://cloud.digitalocean.com/apps → Create App → GitHub → VoXc2/dealix
2. App Platform يكتشف Dockerfile
3. أضف managed PostgreSQL
4. أضف env vars
5. Deploy

6) Docker self-hosted (أي VPS)

# على السيرفر:
git clone https://github.com/VoXc2/dealix.git
cd dealix
cp .env.example .env
# عبّي المتغيرات في .env
docker build -t dealix .
docker run -d --name dealix -p 8000:8000 --env-file .env dealix

# مع PostgreSQL:
docker-compose up -d  # إذا استخدمت docker-compose.yml (راجع docker-compose.example.yml)

7) AWS (ECS Fargate)

1. ادفع صورة Docker لـ ECR: docker build -t dealix . && docker push <ecr-url>/dealix:latest
2. أنشئ ECS Cluster + Task Definition بالصورة
3. أضف RDS Postgres
4. عيّن env vars في Task Definition
5. أنشئ Service مع Application Load Balancer
6. Route 53 → ربط الدومين

---

🔗 ربط Landing Page مع Backend

Landing في مجلد landing/ يقرأ عنوان API من window.DEALIX_API_BASE.

خيار A — نشر منفصل (Netlify / Vercel / Cloudflare Pages)

1. انشر مجلد landing/ كـ static site
2. قبل النشر، عدّل landing/index.html:

   <script>
     window.DEALIX_API_BASE = 'https://your-backend-url.com';
   </script>
   

3. أضف domain dealix.sa في CORS_ORIGINS في backend

خيار B — نشر مع الـ Backend على نفس المنصة

في Railway أو Render: أضف landing/ كـ static serving. أو استخدم nginx reverse proxy (راجع nginx.example.conf).

---

💳 إعداد Moyasar Webhook

مطلوب حتى الدفع يعمل نهاية إلى نهاية:

1. افتح https://dashboard.moyasar.com/webhooks
2. Add Webhook:
   • URL: https://<your-backend-url>/api/v1/webhooks/moyasar
   • Events: payment_paid, payment_failed, payment_refunded
   • Secret: القيمة اللي عيّنتها في MOYASAR_WEBHOOK_SECRET env var (نفس القيمة بالضبط)
3. Save
4. Moyasar يرسل ping اختباري → يجب أن يرجع 200

---

🧪 اختبار بعد النشر

BASE_URL=https://your-backend-url.com

# 1. Health
curl $BASE_URL/health
# {"status":"ok"}

# 2. Pricing
curl $BASE_URL/api/v1/pricing/plans

# 3. Demo request (landing form simulation)
curl -X POST $BASE_URL/api/v1/public/demo-request \
  -H "Content-Type: application/json" \
  -d '{"name":"تجربة","company":"Test Co","email":"test@example.com","phone":"+966500000000","consent":true}'

# 4. Checkout (1 SAR pilot — دفع حقيقي)
curl -X POST $BASE_URL/api/v1/checkout \
  -H "Content-Type: application/json" \
  -d '{"plan":"pilot_1sar","email":"you@example.com"}'
# returns payment_url — افتحه في المتصفح وادفع

---

🐛 المشاكل الشائعة

Railway: Invalid value for '--port': '${PORT:-8000}' is not a valid integer

السبب: Railway UI Start Command override يتجاوز shell expansion. الحل: في Settings → Deploy → Start Command: امسحه أو ضع /app/start.sh

Healthcheck فاشل بعد deploy

السبب: المتغيرات ناقصة أو app crash at startup. الحل: راجع logs — إذا email-validator is not installed فأعد النشر (PR #68 حلّها).

Moyasar webhook 401

السبب: MOYASAR_WEBHOOK_SECRET مختلف في Moyasar dashboard والـ env. الحل: تأكد من تطابقهما بالضبط.

DB connection refused

السبب: DATABASE_URL بصيغة خاطئة. الحل: التطبيق يحوّل postgres:// → postgresql+asyncpg:// تلقائياً. تأكد أن الـ URL صحيح.

---

📚 مسارات API الجاهزة

Route	Method	الوصف
/health	GET	Health check (public)
/api/v1/public/health	GET	Health للـ landing (public)
/api/v1/public/demo-request	POST	Landing form → Calendly (public)
/api/v1/pricing/plans	GET	قائمة الباقات (public)
/api/v1/checkout	POST	توليد Moyasar invoice
/api/v1/webhooks/moyasar	POST	استقبال أحداث Moyasar
/api/v1/webhooks/whatsapp	POST/GET	WhatsApp Meta webhook
/api/v1/webhooks/calendly	POST	Calendly lifecycle events
/api/v1/leads	POST	إنشاء lead (يتطلب API key)
/api/v1/sales/*	*	Sales ops (API key)
/api/v1/admin/*	*	Admin (API key)
/docs	GET	Swagger UI

---

🔐 الأمان — قواعد صارمة

• لا تدفع .env أو مفاتيح لـ Git (موجود .gitignore)
• Rotate APP_SECRET_KEY إذا أي شخص شافه
• MOYASAR_SECRET_KEY = sk_live_* للإنتاج فقط (استخدم sk_test_* للاختبار)
• API_KEYS للحماية — ابدأ بدونها لكن فعّلها قبل الإطلاق العام
• CORS_ORIGINS صارم — ما في wildcard * في الإنتاج

---

📞 الدعم

• Issues: https://github.com/VoXc2/dealix/issues
• Owner: sami.assiri11@gmail.com