system-prompts-and-models-o.../dealix/docs/sales-kit/v5/MASTER_EXECUTIVE_ASSESSMENT.md
2026-05-01 14:03:52 +03:00

13 KiB
Raw Blame History

Dealix — Master Executive Assessment

Operating under the Master Executive Operator Constitution Date: 2026-04-23 | Phase: Primitive Launch Completion


1) Executive Summary

Where we are: Dealix هو code-complete تقنيًا لكنه ليس launch-ready تجاريًا بعد. البنية التحتية موجودة (FastAPI + Streamlit + Railway + CI + Sentry + PostHog + Moyasar client). لكن مسار الإيراد الفعلي (lead → booking → paid invoice) غير موصول end-to-end بعد، وصفحة المسوقين/الوكالات لم تُنشر على الموقع الأساسي بعد، وalerts حقيقية لم تُفعّل (Sentry مُعدّ لكن لا توجد قنوات تنبيه متصلة).

القرار التنفيذي الآن: نغلق Launch Gaps P0 أولاً (CI + alerts + payment E2E)، ثم ننشر marketers.html على الموقع، ثم نفعّل Partner Motion يدويًا (قبل أي أتمتة)، ثم نبدأ outreach حقيقي. لا نبني أي feature جديدة قبل إتمام هذه السلسلة.


2) Current Launch Assessment

A. Product

البند الحالة الدليل
API (FastAPI) live جاهز api/main.py + Railway deployment
Dashboard (Streamlit) جاهز dashboard/pages/*.py — 6 pages
Landing (ar) جاهز landing/index.html
Marketers page 🟡 مبنية لكن غير منشورة sales_kit_v5/marketers.html — لم تُرفع إلى landing/
Pricing page access غير موجود مرئياً لا يوجد /pricing علني
Booking flow 🟡 جزئي Calendly link موجود، لا webhook
Self-service signup غير موجود كل شيء يدوي عبر demo

B. Operations

البند الحالة الدليل
CI green فاشل الآن Black formatting على 5 ملفات (مُصلَح في هذا PR)
Sentry SDK مُعدّ dealix/observability/sentry.py
Sentry alerts wired لا قنوات تنبيه DSN فقط، لا Slack/email routing
DLQ + retry موجود dealix/reliability/dlq.py, retry.py
DLQ drain/replay 🟡 موجود كود غير مختبر تحت حمل لا drill موثّق
Backups غير موثّق لا runbook
Restore drill لم يُجرَّب
Webhook signatures موجود api/security/webhook_signatures.py
Moyasar webhook secret rotated لم يُدار المستخدم يعرف، لم يُنفَّذ
Incident runbook 🟡 جزئي DEPLOYMENT.md فقط

C. Commercial / Revenue

البند الحالة الدليل
Moyasar Payments API integrated dealix/payments/moyasar.py
Moyasar Invoices API integrated create_invoice() موجودة
Payment webhook handler موجود api/routers/webhooks.py
Payment → CRM sync غير موصول webhook يستقبل لكن لا update لـ lead status
1 SAR test paid لم يُنفَّذ
First real invoice issued
ZATCA compliance plan 🟡 موجود كمخطط لم يُطبَّق
Pilot agreement signed template موجود فقط
First paying customer 0 leads, 0 paid

D. Measurement

البند الحالة الدليل
PostHog SDK مُعدّ dealix/analytics/posthog_client.py
Events fired server-side 🟡 بعض النقاط lead_created, webhook_received
Landing page events غير مفعّلة لا PostHog snippet في landing/index.html
Funnel dashboard لا dashboard منشور
Conversion tracking
Weekly KPI review

E. Governance

البند الحالة الدليل
Approval flows موجود dashboard/pages/3_Approvals.py
Audit log موجود dashboard/pages/6_Audit.py
Outbound rate limits 🟡 جزئي per-integration config
Partner permissions غير موجود لا نظام partners حالياً

3) What Must Be Closed First (P0 Launch Gates)

  1. CI أخضر — Black formatting (مُصلَح في هذا الـ PR الحالي)
  2. Alerts حقيقية — ربط Sentry بقناة Slack/Email واحدة على الأقل + health check + uptime monitor
  3. Payment E2E test — 1 SAR test كامل من الصفحة حتى webhook حتى CRM update
  4. Marketers page منشورةmarketers.html داخل landing/ مع رابط من index.html
  5. Pricing page علنية/pricing.html واضحة بالأسعار الأربعة
  6. Booking webhook — Calendly webhook يحدّث lead في CRM
  7. Moyasar secret rotated — (يدوي من المستخدم، مُوثَّق)

4) Priority Matrix

P0 (يجب إغلاقها خلال 24 ساعة)

  • CI green (Black fix) — done in this PR
  • Marketers page live on landing/marketers.html
  • Pricing page live landing/pricing.html
  • Sentry → Slack webhook (قناة تنبيه واحدة على الأقل)
  • UptimeRobot على /healthz
  • 1 SAR payment E2E test
  • Link marketers + pricing from main landing

P1 (7 أيام)

  • PostHog snippet in landing pages + funnel dashboard
  • Calendly webhook → CRM sync
  • Partner application form (Airtable/Notion)
  • 10 first outreach messages sent (SMEs + 2 agencies + 1 VC)
  • Moyasar Invoice generation tested (create_invoice E2E)
  • ZATCA readiness note (when & how to register)
  • Backup + restore drill documented

P2 (30 يوم)

  • Self-service signup flow
  • Automated onboarding emails
  • Agency dashboard (separate role)
  • Service catalog as landing sections
  • Case study template (even if empty)
  • Content: 4 articles

Backlog (لا نلمسها الآن)

  • AI-CRO autonomous features
  • Sovereign LLM / on-prem
  • Multi-tenant white-label
  • Mobile app
  • Full automation of partner commissions

5) Marketers Page Plan

Positioning: "نظام تشغيل مبيعات AI للمسوقين والوكالات — بيع خدماتك، نفّذ حملاتك، واربط عملاءك بمسار إيراد قابل للقياس."

Audience segments:

  • مسوّق فريلانسر (individual)
  • وكالة تسويق صغيرة (220 موظف)
  • وكالة أداء (performance agency)
  • فريق مبيعات داخلي (in-house growth team)

Page sections (موجودة فعلاً في marketers.html):

  1. Hero — عرض مباشر + CTA مزدوجة (احجز demo / سجّل كشريك)
  2. من نستهدف (4 شرائح)
  3. Use cases (6 سيناريوهات)
  4. How it works (3 خطوات)
  5. Partner tiers (3 مستويات)
  6. Service swap (تبادل خدمات)
  7. Proof / trust (شعارات + أرقام عند توفرها)
  8. Pricing teaser + رابط للـ pricing
  9. FAQ (8 أسئلة)
  10. CTA نهائي

Conversion goals:

  • Primary: Partner application submission
  • Secondary: Book demo
  • Tertiary: Pricing page view

6) Agency / Partner Motion

Three tiers

  • Tier 1 — Referral Partner: 10% commission, 30 يوم cookie, بدون حد أدنى
  • Tier 2 — Certified Partner: 15% + co-marketing + onboarding مشترك (يتطلب 3 عملاء مفعّلين)
  • Tier 3 — Strategic Partner: 20% + 5% revenue share + co-product input (3 slots فقط)

Service exchange model

الشريك يقدم: تنفيذ حملات، SEO، SEM، CRM setup، content ديلِكس يقدم: license + onboarding + تدريب + commission نظام التبادل: كل طرف يُسعّر خدماته ويتبادل value مقابل credits أو commission.

What we deliver to partners

  • Partner dashboard (Q2: manual, Q3: automated)
  • Collateral pack (AR/EN) — pitch deck, one-pager, demo script
  • Monthly office hours
  • White-label co-brand (Tier 3 only)

Direct vs partner-led

  • Direct: SMEs 50k500k SAR/month revenue, logistics-first, KSA
  • Partner-led: everything else (agencies handle), ROW markets

7) Revenue Readiness Plan

Pricing path

Pilot (7 days)   → 1 SAR
Starter          → 999 SAR/mo
Growth           → 2,999 SAR/mo
Scale            → 7,999 SAR/mo

ARPU target mix (40/30/10): 2,099 SAR/mo.

Invoice path (Moyasar Invoices API)

  1. Sales confirms deal (manual today)
  2. POST to /invoices via MoyasarClient.create_invoice(...)
  3. Invoice URL sent to customer (WhatsApp/email)
  4. Customer pays → webhook fires
  5. Webhook handler updates lead status → paid
  6. (Manual) ZATCA e-invoice if applicable

Payment path

  • Moyasar Payments API (hosted) — PCI offloaded
  • Webhook signature verified (api/security/webhook_signatures.py)
  • Retry on failure via existing DLQ

Booking path

CRM path

  • CRM = internal DB (api/routers/leads.py)
  • Stages: new → qualified → demo_booked → proposal → paid → onboarding → active
  • Sync to HubSpot (future, P2)

Proof path

  • First 3 pilots = case study targets
  • Video testimonial within 30 days of go-live
  • "trust bar" updated weekly

Follow-up path

  • Day 1: WhatsApp + email
  • Day 3: WhatsApp if no response
  • Day 7: final email
  • Day 14: archive (cold)

8) Business Operations Plan

Area Who Manual now Auto later
Onboarding Sami manual call + checklist self-serve signup (P2)
Support Sami WhatsApp + email ticketing (30d+)
Invoice handling Sami Moyasar manual create auto-invoice on signup (P1)
Payment reconciliation Sami via webhook log daily auto-reconcile
Proposal/Quote Sami template docx self-serve quote tool (backlog)
Partner comms Sami email partner portal (30d+)

9) Exact Next Actions (in execution order)

  1. Fix Black formatting → CI green (this PR)
  2. Copy marketers.html into landing/ directory
  3. Create landing/pricing.html
  4. Create landing/partners.html (partner application form)
  5. Add navigation links from landing/index.html to marketers + pricing
  6. Add PostHog snippet to all landing pages
  7. Configure Sentry → Slack webhook (manual, 1 env var)
  8. Add UptimeRobot monitor on /healthz (manual)
  9. Run 1 SAR test payment (user action)
  10. Send first 3 outreach messages
  11. Log first partner application in tracker

10) Definition of Done

Action DoD
CI green جميع jobs خضراء على main
Marketers live زيارة /marketers.html تعطي 200 + الصفحة تظهر RTL كاملة
Pricing live زيارة /pricing.html تظهر 4 خطط + CTA عاملة
Alerts wired إحداث خطأ متعمد يصل Slack خلال 60 ثانية
1 SAR test lead تم إنشاؤه + webhook استقبل + lead status = paid
Partner form submission تصل Airtable/sheet + email confirmation

11) Verification / Tests

  • curl -I https://<domain>/marketers.html → 200
  • curl -I https://<domain>/pricing.html → 200
  • curl -I https://<domain>/healthz → 200 + uptime monitor يراها
  • curl -X POST https://<domain>/api/webhooks/moyasar -d '{...}' → 200 مع توقيع صحيح، 401 بدونه
  • pytest tests/e2e/ -v → pass
  • black --check . && ruff check . && mypy dealix/ → all green

12) Risks

  1. Regulatory (ZATCA) — إذا وصل الإيراد للحد الخاضع للفوترة الإلكترونية قبل التسجيل، غرامات.
  2. Payment webhook silent failure — Moyasar يرسل webhook واحد، إذا فشل retry غير كافٍ → فقدان confirmation.
  3. Secret in git history — webhook secret القديم ما زال في history (rotation بعد اليوم لا يلغي تاريخياً).
  4. No paid customer yet — كل الادعاءات نظرية حتى يوجد أول دفع.
  5. Partner motion بدون legal framework — commission agreement غير موقّع.

13) Final Executive Decision

Launch phase is NOT complete. Do not claim otherwise.

Execute P0 list in next 24 hours. Do not start any P2 work until P0+P1 are closed and at least one real paying customer exists (even at 1 SAR pilot).

الشرط الصريح للانتقال للمرحلة التالية:

  • CI أخضر لمدة 7 أيام متواصلة
  • Marketers + Pricing + Partners live على الـ landing domain
  • 1 SAR test ناجح end-to-end
  • Sentry alerts واصلة لقناة حقيقية
  • PostHog تسجّل events من landing
  • على الأقل 10 رسائل outreach مُرسلة
  • على الأقل 1 partner application واصلة

فقط عند اكتمال كل هذا نقول: Launch closed, Phase 2 begins.


Top 5 actions now

  1. إصلاح CI (done)
  2. نشر marketers + pricing + partners على landing
  3. ربط Sentry بـ Slack
  4. تنفيذ 1 SAR test
  5. إرسال أول 3 رسائل outreach

Top 5 things NOT to touch now

  1. AI-CRO autonomous features
  2. Sovereign LLM
  3. Mobile app
  4. White-label UI
  5. Multi-tenant refactor

Top 3 risks

  1. ZATCA غير مُعالَج
  2. Moyasar secret في history
  3. لا يوجد customer دافع

Exact condition to move to next stage

CI أخضر × 7d + marketers/pricing/partners منشورة + 1 SAR test ناجح + Sentry→Slack يعمل + PostHog يسجّل + 10 outreach + 1 partner app.