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

Dealix — Moyasar E2E Pilot Guide (G2 Gate)

الهدف: pilot 1 SAR test من البداية للنهاية، يفتح G2 + O3 بنفس الجلسة.

---

الخطوات (بالترتيب)

الخطوة 1 — SSH للسيرفر

ssh -i ~/.ssh/dealix_deploy root@188.245.55.180

الخطوة 2 — Deploy آخر PRs

cd /opt/dealix
git rev-parse HEAD > .last_good_sha
git pull origin main
.venv/bin/pip install -q -r requirements.txt
chmod +x scripts/ops/*.sh
systemctl restart dealix-api
sleep 5
curl -s http://127.0.0.1:8001/health/deep | python3 -m json.tool

الخطوة 3 — توليد Webhook secret محلياً

# ضف هذا في ذهنك فقط — راح تستخدمه في الخطوة 4 + Moyasar dashboard
WEBHOOK_SECRET=$(openssl rand -hex 32)
echo "Your webhook secret (save it, you'll register it in Moyasar too):"
echo "  $WEBHOOK_SECRET"

الخطوة 4 — تحديث .env

# backup first
cp /opt/dealix/.env /opt/dealix/.env.bak.$(date +%Y%m%dT%H%M%SZ)

# افتح nano
nano /opt/dealix/.env

أضف هذي السطور (أو حدّث لو موجودة):

# PostHog (US Cloud — project 394094)
POSTHOG_API_KEY=phc_YOUR_POSTHOG_KEY_HERE
POSTHOG_HOST=https://us.i.posthog.com

# Moyasar (Test mode — switch to sk_live_ only after pilot success)
MOYASAR_SECRET_KEY=sk_test_<NEW_FROM_DASHBOARD_AFTER_REGENERATE>
MOYASAR_WEBHOOK_SECRET=<WEBHOOK_SECRET_FROM_STEP_3>

# App URL (used in Moyasar callback_url)
APP_URL=https://dealix.me

احفظ (Ctrl+O, Enter, Ctrl+X).

الخطوة 5 — تسجيل Webhook في Moyasar Dashboard

1. ادخل https://dashboard.moyasar.com/webhooks
2. اضغط "إضافة webhook جديد" / "Add Webhook"
3. URL: https://dealix.me/api/v1/webhooks/moyasar
   • ⚠️ لو dealix.me DNS مو مضبوط، استخدم: http://188.245.55.180/api/v1/webhooks/moyasar مؤقتاً
4. Secret: ألصق نفس $WEBHOOK_SECRET من الخطوة 3
5. Events: اختر:
   • ☑️ payment_paid
   • ☑️ payment_failed
   • ☑️ invoice_paid
6. احفظ

الخطوة 6 — إعادة تشغيل API

systemctl restart dealix-api
sleep 5
systemctl status dealix-api | head -10

الخطوة 7 — Verify /pricing/plans public

curl -s http://127.0.0.1:8001/api/v1/pricing/plans | python3 -m json.tool

المتوقع: starter (999), growth (2999), scale (7999) — بدون pilot_1sar.

الخطوة 8 — تشغيل pilot E2E test

export API_KEY=$(grep '^API_KEYS=' /opt/dealix/.env | cut -d= -f2- | tr -d '"' | cut -d, -f1)
export API_BASE=http://127.0.0.1:8001
bash /opt/dealix/scripts/ops/moyasar_pilot_test.sh

السكريبت:

1. يتحقق من الـ .env
2. ينشئ invoice 1 SAR
3. يطبع payment URL → افتحه في المتصفح وادفع بـ test card
4. Test card: 4111 1111 1111 1111, expiry أي تاريخ مستقبلي, CVV أي 3 أرقام
5. يتحقق من وصول webhook + idempotency + PostHog event

---

التحقق بعد النجاح

في PostHog Dashboard

• ادخل https://us.posthog.com/project/394094/activity/explore
• فلتر: event = "checkout started" أو "payment succeeded"
• لازم تشوف event بـ distinct_id=pilot_<timestamp>

في Moyasar Dashboard

• ادخل https://dashboard.moyasar.com/payments
• ستشوف invoice الـ 1 SAR بحالة "paid"

Logs السيرفر

journalctl -u dealix-api --since "5 minutes ago" --no-pager | \
  grep -E "moyasar_webhook|posthog|payment"

---

لو شي فشل

المشكلة	الحل
/pricing/plans 401/500	PR #55 ما انتشر. ارجع للخطوة 2
moyasar_invoice_failed في logs	MOYASAR_SECRET_KEY غلط في .env
moyasar_webhook_bad_signature	MOYASAR_WEBHOOK_SECRET في .env مختلف عن المسجّل في Moyasar
webhook ما وصل	DNS مو مضبوط، أو port 443 مقفل، أو nginx ما يوجّه /api/v1/webhooks/moyasar
PostHog event ما ظهر	Check POSTHOG_HOST=https://us.i.posthog.com (مش eu)

Rollback لو شي كسر

sudo bash /opt/dealix/scripts/ops/rollback_drill.sh --dry-run  # check
sudo CONFIRM=YES bash /opt/dealix/scripts/ops/rollback_drill.sh --real

---

بعد النجاح — Gates Progression

قبل	بعد
18/30	22/30
G2 🚫 Blocked	G2 ✅
O3 🚫 Blocked	O3 ✅
T5 🟡 Partial	T5 ✅ (webhook E2E verified)
G1 🟡 Partial	G1 ✅ (pricing public verified in prod)

الخطوة التالية بعد Success: تكرار مع Calendly + HubSpot لـ G3 (يحتاج token صحيح من Private App)، أو البدء بجمع leads حقيقيين لـ G4.