system-prompts-and-models-o.../dealix/docs/PAID_BETA_OPERATING_PLAYBOOK.md
Dealix Builder 342bcf8ea5 feat(paid-beta): operational layer for first 499 SAR — playbook + workflow + board + scorecard + landing CTA
Move from GO_PRIVATE_BETA (technical readiness) to PAID_BETA_READY
(first revenue) — operational, not architectural.

Deliverables:
- docs/PAID_BETA_OPERATING_PLAYBOOK.md
  10-section Arabic playbook: gate to Paid Beta, 7-day day-by-day
  plan (Staging → Outreach → Demos → Diagnostic → Pilot Sale →
  Pilot Day1/Day2 → Proof+Upsell), weekly targets (50-70 messages /
  5-10 replies / 3-5 demos / 1+ payment), 8 hard operational rules,
  daily cadence, what NOT to add, Public Launch criteria.

- docs/FIRST_PILOT_DELIVERY_WORKFLOW.md
  48-hour Arabic Pilot delivery: T+0 intake (15 fields) → T+24
  Free Diagnostic (3 opportunities + 1 Arabic message + 1 risk + 1
  service recommendation) → T+48 Pilot 499 (10 opportunities + 7-day
  follow-up plan + Proof Pack) → T+7 final Proof Pack + 30min review +
  3 upgrade paths. Pilot success criteria + 8-row metrics table.

- docs/PRIVATE_BETA_OPERATING_BOARD.md
  15-column Sheet template (company, person, segment, source, channel,
  message_sent, reply_status, demo_booked, diagnostic_sent,
  pilot_offered, price, paid, proof_pack_sent, next_step, notes) +
  status flow + ICP distribution + 3-wave follow-up templates +
  daily routine + PDPL privacy rules + CSV header.

- landing/private-beta.html
  Pilot 499 SAR offer prominent at top (badge + hero CTA), dedicated
  3-card pricing section (Pilot 499 / Free Diagnostic / Growth OS
  Monthly 2,999), 7-day refund/case-study guarantee, mailto CTAs
  with prefilled subject + body, removed duplicate pricing block.

- scripts/paid_beta_daily_scorecard.py (274 lines)
  argparse with --messages, --replies, --demos, --pilots, --payments,
  --proof-packs, --as-of, --json. Computes reply_rate / demo_rate /
  pilot_rate / payment_rate, daily verdict (ON_TRACK / BEHIND /
  OFF_TRACK), weekly verdict (BLOCKERS / STRETCH_PENDING /
  WEEKLY_TARGETS_HIT), and rule-based next_actions in Arabic.
  Targets: 50-70 messages / 5-15 replies / 3-7 demos / 2-3 pilots /
  1-2 paid / 1+ proof pack per week.

- tests/unit/test_paid_beta_scorecard.py
  12 tests: zero-input, on-track day, tone-action trigger, payment
  → proof-pack action, full-week target hit, conversion rates,
  Arabic text rendering, JSON validity, CLI text/json modes,
  --as-of today/explicit.

Hard rules (unchanged):
- No live WhatsApp / Gmail / Calendar send without env flag + approval.
- No Moyasar API charge — manual invoice/payment-link only.
- No LinkedIn scraping / auto-DM — Lead Gen Forms + manual outreach.
- No cold WhatsApp without opt-in (PDPL hard-block).
- Every message passes safety_eval + saudi_tone_eval.
- Every action recorded in Action Ledger.

Validation:
- python -m compileall api auto_client_acquisition: clean.
- pytest tests/unit (excl. tenacity-dep tests): 950 passed, 2 skipped.
- python scripts/smoke_inprocess.py: SMOKE_INPROCESS_OK (8/8 endpoints).
- python scripts/paid_beta_daily_scorecard.py text + --json: both render
  correctly with Arabic + verdict + next_actions.
- tests/unit/test_positioning_lock.py: 10 passed (no prohibited
  phrases introduced in updated landing/private-beta.html).

Test count: 949 → 962 (+12 new, 1 prior already counted).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 18:39:36 +03:00

207 lines
5.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Paid Beta Operating Playbook
> **القاعدة:** الجاهزية التقنية لا تعني دخل. هذا الـ playbook يحوّل GO_PRIVATE_BETA إلى أول 499 ريال خلال 7 أيام.
---
## 1. الحالة الحالية
```
✅ Tests: 949 passed, 2 skipped
✅ CI green
✅ Service Tower + Service Excellence + Targeting OS + Customer Ops جاهزة
✅ Positioning Lock مفعّل
✅ Landing pages متوافقة مع POSITIONING_LOCK
🟡 Staging: ينتظر النشر الفعلي
🟡 First payment: ينتظر أول عميل
```
**الحالة:** `GO_PRIVATE_BETA` محلياً. الانتقال لـ `PAID_BETA_READY` يحتاج Staging شغّال + أول Pilot مدفوع.
---
## 2. الانتقال من Private Beta إلى Paid Beta
### Gate الانتقال (لا تتجاوزه)
```text
✅ Staging /health = 200
✅ Service catalog يعرض 4+ خدمات
✅ landing/private-beta.html فيه 499 SAR + CTA
✅ no_secrets scan نظيف
✅ live_sends_disabled = true
✅ Moyasar invoice/payment-link manual flow جاهز
✅ أول 20 prospect معرّفون في Operating Board
```
### Smoke Commands
```bash
export STAGING_BASE_URL="https://YOUR-STAGING-URL"
python scripts/smoke_staging.py --base-url "$STAGING_BASE_URL"
python scripts/launch_readiness_check.py --staging-url "$STAGING_BASE_URL"
python scripts/paid_beta_daily_scorecard.py --as-of today
```
المطلوب: `PAID_BETA_READY`. لو NO-GO → أصلح السبب قبل أي بيع.
---
## 3. خطة 7 أيام للوصول للدخل الأول
### يوم 1 — Staging + Outreach
- نشر staging على Railway.
- تشغيل smoke + readiness checks.
- إرسال 10 رسائل (5 وكالات + 5 شركات).
- 1 منشور LinkedIn (founder voice).
**الهدف:** 2 ردود + 1 ديمو محجوز.
### يوم 2 — Demos
- إرسال 10 رسائل أخرى.
- إجراء أول 1-2 ديمو.
- بدء أول Free Diagnostic لأي عميل اهتم.
**الهدف:** 1 Free Diagnostic موعود.
### يوم 3 — Diagnostic Delivery
- تسليم أول Free Diagnostic خلال 24 ساعة.
- 5 follow-ups.
- إرسال 5 رسائل جديدة.
**الهدف:** 1 Pilot Offer.
### يوم 4 — First Pilot Sale
- محادثة Pilot 499 مع المهتم.
- إنشاء Moyasar invoice manual.
- إرسال payment-link-message.
**الهدف:** 1 invoice paid أو commitment مكتوب.
### يوم 5 — Pilot Delivery Day 1
- استلام intake من العميل.
- تشغيل First 10 Opportunities Sprint workflow.
- 10 opportunities + 10 رسائل عربية.
**الهدف:** Approval Pack مرسل للعميل.
### يوم 6 — Pilot Delivery Day 2
- متابعة الموافقات.
- تشغيل follow-up sequence.
- أول 1-2 رد إيجابي.
**الهدف:** اعتماد ≥3 رسائل + Proof Pack v1.
### يوم 7 — Proof + Upsell
- تسليم Proof Pack.
- جلسة مراجعة 30 دقيقة.
- اقتراح ترقية لـ Growth OS Pilot.
**الهدف:** Case study أو Pilot ثانٍ.
---
## 4. أهداف الأسبوع
| Metric | Target |
|--------|-------:|
| Messages sent | 5070 |
| Positive replies | 510 |
| Demos booked | 35 |
| Pilots offered | 23 |
| Payments requested | 12 |
| Payments received | 1+ |
| Proof packs delivered | 1+ |
---
## 5. القواعد التشغيلية اليومية (لا تتنازل عنها)
1. **لا live WhatsApp send** بدون env flag + اعتماد بشري.
2. **لا live Gmail send** بدون env flag + اعتماد بشري.
3. **لا Calendar insert** بدون اعتماد.
4. **لا Moyasar charge** من API — invoice/payment-link manual فقط.
5. **لا scraping LinkedIn** ولا auto-DM — Lead Gen Forms + manual فقط.
6. **لا cold WhatsApp** بدون opt-in — PDPL hard-block.
7. **كل رسالة** تمر `safety_eval` + `saudi_tone_eval` قبل الإرسال.
8. **كل فعل** يُسجّل في Action Ledger.
---
## 6. Daily Cadence
### الصباح (60 دقيقة)
- شغّل `paid_beta_daily_scorecard.py`.
- راجع الـ Operating Board.
- اعتمد drafts اليوم (1015 دقيقة).
- 5 follow-ups.
### الظهر (90 دقيقة)
- 12 ديمو.
- 10 رسائل جديدة (segments متنوعة).
### العصر (60 دقيقة)
- تسليم deliverable لعميل واحد.
- إجابة support tickets (إن وجد).
### آخر اليوم (30 دقيقة)
- تحديث Operating Board.
- تشغيل scorecard مرة أخرى.
- خطة الغد.
---
## 7. ما لا تضيفه هذا الأسبوع
- لا ميزات تقنية جديدة.
- لا layers معمارية.
- لا modules جديدة.
- لا بريق landing.
**التركيز كله:** عميل واحد يدفع 499 ريال.
---
## 8. شروط الانتقال إلى Public Launch
لا انتقال قبل:
```
510 pilots
2+ paid customers
0 unsafe sends
weekly proof packs delivered
support flow يعمل
funnel واضح من lead → demo → pilot → paid
14 يوم staging stable
billing live (Moyasar API webhook)
terms + privacy + DPA
```
---
## 9. Endpoints المهمة في Paid Beta
```
GET /api/v1/launch/private-beta/offer
POST /api/v1/launch/go-no-go
GET /api/v1/launch/scorecard/demo
GET /api/v1/operator/bundles
POST /api/v1/operator/chat/message
POST /api/v1/customer-ops/onboarding/checklist
POST /api/v1/customer-ops/connectors/summary
POST /api/v1/revenue-launch/payment/invoice-instructions
POST /api/v1/revenue-launch/proof-pack/template
GET /api/v1/service-excellence/review/all
```
---
## 10. القرار النهائي
```
لا تنتظر "كمال المنتج". المنتج كامل تقنياً.
أنت تنتظر "أول إيراد".
الإيراد يأتي من 50 رسالة يدوية + 5 ديمو + 1 invoice.
ابدأ.
```