13 KiB
قائمة التشغيل التجاري — آخر قفل قبل الإيراد (Dealix)
آخر تحديث مطلوب داخل الريبو لهذه المرحلة. الريبو مقفول كـ جاهزية تشغيل، وCOMMERCIAL_GO_LIVE_CHECKLIST.md هو المصدر التنفيذي الواحد — نفّذه حرفياً حتى تنتقل من GO_PRIVATE_BETA محلياً إلى Paid Beta حقيقية (PAID_BETA_READY على staging + أول دفع أو commitment + أول Proof Pack مُسلَّم).
لا كود منتج جديد الآن. ما بعد دمج هذا الملف تنفيذ خارج الريبو بالكامل: push، حماية الفرع، staging، دفع، outreach، pilot — إلا إذا فرض عميل مدفوع تغييراً تقنياً واضحاً بعد الـ pilots. أي إضافة داخل الريبو بدون ضغط عميل مدفوع ستكون تشتيتاً عن هذه المرحلة.
وثائق مرتبطة: BRANCH_PROTECTION_AND_CI.md، STAGING_DEPLOYMENT.md، ops/RAILWAY_AI_COMPANY_BIND.md، PAID_BETA_OPERATING_PLAYBOOK.md، FIRST_PILOT_DELIVERY_WORKFLOW.md، PRIVATE_BETA_OPERATING_BOARD.md.
الحالة التنفيذية (ملخّص)
| المحور | الحالة |
|---|---|
| الريبو محلياً | جاهز (GO_PRIVATE_BETA عبر launch_readiness_check) |
| CI | مقسّم: pytest، smoke_inprocess، launch_readiness |
| حماية الدمج | تُفعّل يدوياً في GitHub بعد أول CI أخضر |
| Staging workflow | جاهز؛ ينتظر STAGING_BASE_URL في Secrets |
| Private Beta | جاهزة تقنياً وتشغيلياً (قبل الثلاثي أدناه) |
| Paid Beta حقيقية | PAID_BETA_READY + دفع/commitment + Proof Pack مُسلَّم |
| Public Launch | مؤجل إلى ما بعد الـ pilots |
التسلسل الكامل (سطر تنفيذي)
push → CI → protection → Railway → secret → staging workflow → PAID_BETA_READY → Moyasar → outreach → demo → pilot → Proof Pack
التعريف النهائي
لا تعتبر أن Dealix دخلت Paid Beta حقيقية إلا بعد اكتمال الثلاثي:
PAID_BETA_READY
+ أول payment أو commitment
+ أول Proof Pack مُسلَّم
قبل هذا: Private Beta جاهزة تقنياً وتشغيلياً. بعد هذا: Paid Beta حقيقية.
0 — ادفع التغييرات وشغّل CI
من جذر المونوريبو (المجلد الذي فيه .github/ وdealix/) — ليس فقط داخل dealix/:
git status
git add dealix/docs/COMMERCIAL_GO_LIVE_CHECKLIST.md \
dealix/docs/BRANCH_PROTECTION_AND_CI.md
git commit -m "docs: finalize commercial go-live checklist"
git push
إذا عدّلت أيضاً ملفات أخرى (مثل PRIVATE_BETA_RUNBOOK.md أو workflows) في نفس الدمج، أضفها إلى git add قبل الـ commit.
ثم راقب GitHub → Actions حتى تنجح Dealix API CI والـ jobs:
pytest
smoke_inprocess
launch_readiness
مهم (GitHub): أسماء jobs يجب أن تكون فريدة عبر workflows حتى لا تصبح status checks مبهمة. الـ required status checks لا تظهر كخيارات عادةً إلا إذا نجحت داخل الريبو خلال آخر ~7 أيام. وإذا وُجد check وstatus بنفس الاسم، فاختيار ذلك الاسم كـ required قد يجعلهما مطلوبين معاً — راقب القائمة قبل الحفظ. مراجع: Troubleshooting required status checks، BRANCH_PROTECTION_AND_CI.md.
1 — تفعيل حماية الفرع (GitHub)
المسار: Settings → Branches → Branch protection rules → Add rule — على main (أو فرع الإطلاق المحمي).
فعّل (أسماء الخيارات في واجهة GitHub):
- Require pull request before merging
- Require status checks to pass
- Require branches to be up to date
- Require conversation resolution
- Block force pushes
- Block deletions
اختر required checks: pytest، smoke_inprocess، launch_readiness (أو Dealix API CI / … حسب ما يعرضه GitHub).
2 — رفع Staging (Railway)
railway login
railway link
railway up
- Start command:
uvicorn api.main:app --host 0.0.0.0 --port $PORT - Healthcheck path:
/health(يتوقع HTTP 200 ضمن المهلة)
Railway عملياً: يتطلّب أن التطبيق يستمع على 0.0.0.0:$PORT؛ المنصة تحقن PORT وتستخدمه في الـ healthchecks بحيث لا يصبح النشر active إلا بعد HTTP 200 ضمن المهلة؛ وعدم الاستماع على PORT قد يؤدي إلى service unavailable. التحقق قبل التفعيل وليس مراقبة مستمرة بعد الـ live — Healthchecks، Exposing your app.
بعد النشر — من جذر المونوريبو (نفس المجلد الذي فيه dealix/):
export STAGING_BASE_URL="https://YOUR-STAGING-URL"
python dealix/scripts/smoke_staging.py --base-url "$STAGING_BASE_URL"
python dealix/scripts/launch_readiness_check.py --base-url "$STAGING_BASE_URL"
بديل مكافئ: cd dealix ثم python scripts/smoke_staging.py … وpython scripts/launch_readiness_check.py ….
المطلوب: VERDICT: PAID_BETA_READY. إذا NO_GO — لا تبدأ Paid Beta على الرابط؛ عالج السبب ثم أعد الفحص.
3 — Secret لـ GitHub Actions
Settings → Secrets and variables → Actions → New repository secret
STAGING_BASE_URL=https://YOUR-STAGING-URL
ثم: Actions → Dealix staging smoke → Run workflow.
النتيجة المطلوبة: smoke_staging OK، ثم launch_readiness_check مع --base-url → PAID_BETA_READY (إثبات أن الاستضافة تطابق الجاهزية المحلية).
4 — Moyasar Invoice لأول Pilot (بدون live charge من API)
من Moyasar Dashboard أنشئ invoice يدوي (أو رابط دفع). Moyasar — Creating invoices — يمكن الإنشاء من لوحة التحكم أو API وإرسالها أو عرضها للعميل يدوياً أو آلياً. لا تبنِ billing API داخل المنتج الآن.
لوحة التحكم (مثال):
Amount: 499 SAR
Description: Dealix Private Beta Pilot — 7 days
Expiry: 7 days
إن استخدمت API لاحقاً: المبلغ بأصغر وحدة عملة — 1 SAR = 100 هللة → 499 SAR = 49900 (راجع وثائق Moyasar لنسختك).
نص الإغلاق (للعميل):
تمام، نبدأ Pilot لمدة 7 أيام بـ499 ريال.
يشمل:
- 10 فرص مناسبة
- رسائل عربية جاهزة
- فحص مخاطر القنوات
- خطة متابعة 7 أيام
- Proof Pack مختصر
بعد الدفع أحتاج منك: رابط موقعكم، القطاع المستهدف، المدينة، العرض الرئيسي، ومن هو العميل المثالي لكم.
خيار case study: بداية مجانية مقابل case study مختصر إذا كانت النتائج مفيدة — نفس التسليم (10 فرص + رسائل + متابعة + Proof Pack)، بدون نشر بيانات حساسة أو أسماء عملاء إلا بموافقة واضحة.
5 — موجة التشغيل اليوم (يدوي فقط)
ممنوع: scraping، auto-DM، cold WhatsApp جماعي، أتمتة LinkedIn غير أصيلة — PROHIBITED_CLAIMS.md.
هدف اليوم: 25 تواصل يدوي، 5 follow-ups، 1 منشور LinkedIn، 1 منشور X، 1 محادثة شريك، 1 محاولة ديمو.
التقسيم: 10 وكالات/مسوقين، 5 تدريب/استشارات، 5 B2B SaaS أو خدمات تقنية، 5 شركات خدمات محلية.
رسالة الوكالات
هلا [الاسم]، أطلقنا Beta محدودة لـ Dealix للوكالات.
Dealix يساعد الوكالة تطلع فرص لعملائها، تجهز رسائل عربية، تدير الموافقات، وتطلع Proof Pack باسم الوكالة والعميل.
أبحث عن وكالة واحدة نجرب معها Pilot مشترك على عميل حقيقي. يناسبك ديمو 15 دقيقة؟
رسالة الشركات
هلا [الاسم]، أطلقنا Beta محدودة لـ Dealix.
الفكرة: نطلع لك 10 فرص B2B مناسبة، نكتب الرسائل بالعربي، وأنت توافق أو ترفض قبل أي تواصل، وبعدها نعطيك Proof Pack يوضح النتائج والمخاطر التي تم منعها.
يناسبك أعطيك Free Growth Diagnostic لشركتكم؟
Follow-up
أقدر أرسل لك عينة صغيرة بدل ديمو كامل:
3 فرص مناسبة لشركتكم + رسالة عربية واحدة + ملاحظة عن أفضل قناة للتواصل.
إذا أعجبتك، نكمل Pilot كامل.
معيار يوم جيد: 25 رسالة، 3–5 ردود، 1–2 ديمو، عرض pilot واحد، 0 إجراءات غير آمنة.
6 — Scorecard نهاية اليوم
من جذر المونوريبو:
python dealix/scripts/paid_beta_daily_scorecard.py \
--messages 25 \
--replies 0 \
--demos 0 \
--pilots 0 \
--payments 0 \
--proof-packs 0
مع نتائج فعلية:
python dealix/scripts/paid_beta_daily_scorecard.py \
--messages 25 \
--replies 4 \
--demos 2 \
--pilots 1 \
--payments 1 \
--proof-packs 0 \
--json
بديل: cd dealix ثم python scripts/paid_beta_daily_scorecard.py …. تفاصيل الأعمدة: PRIVATE_BETA_OPERATING_BOARD.md.
معيار أسبوع مرجعي: 70–100 تواصل، 15+ رد، 7 ديمو، 3 pilots، 1–2 مدفوع، Proof Pack واحد على الأقل.
7 — أول Pilot خلال 48 ساعة
أول 30 دقيقة — intake
company_name، website، sector، city، offer، ideal_customer، average_deal_value، has_contact_list، preferred_channels، current_sales_process.
خلال 24 ساعة — Diagnostic
3 فرص، 1 رسالة عربية، 1 مخاطرة، 1 توصية خدمة.
خلال 48 ساعة — Pilot 499
10 فرص، why-now لكل فرصة، صاحب القرار المحتمل، القناة المقترحة، رسالة عربية، risk/contactability، خطة متابعة 7 أيام، Proof Pack مختصر.
Proof Pack مختصر
opportunities_created، drafts_created، approvals_needed، risks_blocked، recommended_next_action، upgrade_offer.
التفاصيل: FIRST_PILOT_DELIVERY_WORKFLOW.md.
8 — اليوم لا تبني
أجّل بالكامل:
Marketplace
White-label
Public Launch
Enterprise custom features
LinkedIn automation
Cold WhatsApp
Gmail live send
Moyasar API charge
ابدأ ذلك فقط بعد: 5–10 pilots، 2+ عملاء مدفوعين، weekly proof cadence، support flow ثابت، 0 unsafe actions.
لا تضف أي كود منتج جديد الآن. نفّذ الأقسام 0→7 حرفياً؛ وبعد أول عميل مدفوع فقط نقرر ماذا يُبنى بعد ذلك.
مراجع خارجية
- GitHub — Troubleshooting required status checks
- GitHub — About status checks
- Railway — Healthchecks
- Railway — Exposing your app / public networking
- Moyasar — Creating invoices
آخر تحديث: 2026-05-01