system-prompts-and-models-o.../dealix/api/routers/launch_ops.py
Dealix Builder 84f1ad9620 feat(launch+revenue): Private Beta Launch Ops + Revenue Launch — 14 modules + 29 endpoints + 56 tests + scripts/landing/docs
Launch Ops (5 modules) — برج إطلاق الـ Private Beta
- private_beta: 499 SAR × 7-day offer + safety notes + 6-question Arabic FAQ
- demo_flow: 12-minute minute-by-minute Arabic demo + 5 discovery Qs + 6 objection responses + close script
- outreach_messages: 4 segments × 5 prospects = 20 + per-segment Arabic messages + 3-step follow-ups + 6 reply handlers
- go_no_go: 10-gate readiness + 3 critical gates (no_secrets/live_sends_disabled/staging_health) + verdict + next-actions
- launch_scorecard: 11 event types + daily/weekly aggregation + targets (20 outreach/5 replies/3 demos/1 pilot daily)

Revenue Launch (7 modules) — تحويل Dealix إلى دخل
- offer_builder: 4 offers (Private Beta, 499 Pilot, Growth OS Pilot 1.5-3K, Free Case Study) + segment-aware recommend
- pipeline_tracker: 8-stage deterministic pipeline + add/update/summarize + revenue tracking + win rate
- outreach_sequence: re-export single source of truth from launch_ops with revenue-tier wrappers
- demo_closer: re-export from launch_ops
- pilot_delivery: 12-field intake form + 5-phase 24h delivery plan + per-service templates (First 10 / List Intel / Free Diagnostic)
- proof_pack_template: 5-line Arabic client summary + ROI estimate (pipeline_x + closed_won_x) + next-step recommendation (upsell/iterate/extend)
- payment_manual_flow: Moyasar invoice step-by-step (halalas-correct) + Arabic payment-link message + confirmation checklist; NEVER charges via API

Service Tower extensions (2 modules)
- contract_templates: re-export targeting_os contracts + new SLA outline (legal_review_required, PDPL-aware)
- vertical_service_map: 6 verticals (B2B SaaS / agencies / training-consulting / real estate / healthcare-local / retail-ecommerce) with primary+supporting services + buyer roles + common pains + winning offer

Routers (2 new) — 29 endpoints
- /api/v1/launch/* — 11 endpoints (private-beta/offer, demo/flow, outreach/{first-20, message, followup}, go-no-go, readiness, scorecard/{event, daily, weekly, demo})
- /api/v1/revenue-launch/* — 18 endpoints (offers + offers/recommend, outreach/{first-20, followup}, demo-flow, pipeline/{schema, summarize}, pilot-delivery/{intake-form, 24h-plan, first-10, list-intelligence, free-diagnostic}, payment/{invoice-instructions, link-message, confirmation-checklist}, proof-pack/{template, client-summary, next-step})

Tests (2 new files, 56 tests)
- test_launch_ops.py: 25 tests (Private Beta offer essentials + Arabic FAQ; demo flow 12-min structure; first-20 segments × 5; outreach Arabic + drafts only; followup steps differ; reply handlers include unsubscribe; go/no-go critical gates block; scorecard aggregation + verdict)
- test_revenue_launch.py: 31 tests (offers correct prices, no_live_charge=True; segment-aware recommends; pipeline 8 stages + add/update/summarize + win rate; outreach v2 Arabic; intake fields; 24h plan 5 phases; invoice halalas correct; payment confirmation blocks premature delivery; proof pack 5 lines + 3 next-step paths)

Scripts (1 new)
- scripts/launch_readiness_check.py: runs 10 gates locally + optional --staging-url; pretty/JSON output; critical gates determine GO/NO-GO/FIX-THEN-GO verdict

Landing pages (2 new, RTL Arabic)
- list-intelligence.html — List Intelligence service detail (499–1,500 SAR)
- growth-os.html — Growth OS Monthly subscription page (2,999 SAR/month)

Docs (1 new + 1 updated)
- REVENUE_TODAY_PLAYBOOK.md (Arabic) — 12-section playbook: offers, segments, messages, demo, pipeline, 24h delivery, Moyasar manual flow, proof pack, daily targets, go/no-go, what-not-to-do, next-step
- DEALIX_100_PERCENT_LAUNCH_PLAN.md — added §40 Launch Ops + §41 Revenue Launch + §42 Service Tower extensions + §43 Scripts

Test results
- 56/56 new tests pass
- Full suite: 824 passed, 2 skipped (missing API keys, unrelated)
- 0 existing tests broken

Safety integration
- All offers: live_send_allowed=False, no_live_charge=True, approval_required=True
- 10-gate go/no-go BLOCKS launch if no_secrets/live_sends_disabled/staging_health fail
- Moyasar: invoice/payment-link manual only; NEVER calls live charge API
- Payment confirmation checklist blocks delivery before invoice paid status
- All outreach messages: drafts only, follow-ups capped at 3, opt-out honored immediately
- 6 verticals mapped to safe service stacks; LinkedIn always Lead Forms (never scraping)

Integration with previous layers
- Launch Ops uses platform_services tool_gateway, intelligence_layer command_feed, security_curator redaction
- Revenue Launch uses targeting_os contractability + service_tower offers + intelligence_layer simulator
- Pipeline tracker integrates with action_ledger for stage transitions
- Proof Pack template references intelligence_layer proof metrics + service_excellence ROI

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

136 lines
4.6 KiB
Python

"""Launch Ops router — Private Beta + Demo + Outreach + Go/No-Go + Scorecard."""
from __future__ import annotations
from typing import Any
from fastapi import APIRouter, Body
from auto_client_acquisition.launch_ops import (
build_12_min_demo_flow,
build_close_script,
build_daily_launch_scorecard,
build_discovery_questions,
build_first_20_segments,
build_followup_message,
build_launch_readiness,
build_objection_responses,
build_outreach_message,
build_private_beta_offer,
build_private_beta_safety_notes,
build_reply_handlers,
build_weekly_launch_scorecard,
decide_go_no_go,
private_beta_faq,
record_launch_event,
)
router = APIRouter(prefix="/api/v1/launch", tags=["launch-ops"])
# ── Private Beta ─────────────────────────────────────────────
@router.get("/private-beta/offer")
async def private_beta_offer() -> dict[str, Any]:
return {
"offer": build_private_beta_offer(),
"safety": build_private_beta_safety_notes(),
"faq": private_beta_faq(),
}
# ── Demo flow ────────────────────────────────────────────────
@router.get("/demo/flow")
async def demo_flow() -> dict[str, Any]:
return {
"flow": build_12_min_demo_flow(),
"discovery_questions": build_discovery_questions(),
"objections": build_objection_responses(),
"close": build_close_script(),
}
# ── Outreach ─────────────────────────────────────────────────
@router.get("/outreach/first-20")
async def outreach_first_20() -> dict[str, Any]:
segments = build_first_20_segments()
sample_messages = {
s["id"]: build_outreach_message(s["id"])
for s in segments["segments"]
}
return {
**segments,
"sample_messages": sample_messages,
"reply_handlers": build_reply_handlers(),
}
@router.post("/outreach/message")
async def outreach_message(payload: dict[str, Any] = Body(...)) -> dict[str, Any]:
return build_outreach_message(
segment_id=payload.get("segment_id", ""),
name=payload.get("name", "[الاسم]"),
)
@router.post("/outreach/followup")
async def outreach_followup(payload: dict[str, Any] = Body(...)) -> dict[str, Any]:
return build_followup_message(
segment_id=payload.get("segment_id", ""),
step=int(payload.get("step", 1)),
name=payload.get("name", "[الاسم]"),
)
# ── Go / No-Go ───────────────────────────────────────────────
@router.post("/go-no-go")
async def go_no_go(payload: dict[str, Any] = Body(default_factory=dict)) -> dict[str, Any]:
return decide_go_no_go(statuses=payload.get("statuses"))
@router.get("/readiness")
async def readiness() -> dict[str, Any]:
"""Readiness with all gates assumed False (use POST /go-no-go for real status)."""
return build_launch_readiness(statuses={})
# ── Scorecard ────────────────────────────────────────────────
@router.post("/scorecard/event")
async def scorecard_event(payload: dict[str, Any] = Body(...)) -> dict[str, Any]:
try:
return record_launch_event(
event_type=payload.get("event_type", ""),
customer_id=payload.get("customer_id"),
notes=payload.get("notes"),
)
except ValueError as exc:
return {"error": str(exc)}
@router.post("/scorecard/daily")
async def scorecard_daily(
events: list[dict[str, Any]] = Body(default_factory=list, embed=True),
) -> dict[str, Any]:
return build_daily_launch_scorecard(events=events)
@router.post("/scorecard/weekly")
async def scorecard_weekly(
events: list[dict[str, Any]] = Body(default_factory=list, embed=True),
) -> dict[str, Any]:
return build_weekly_launch_scorecard(events=events)
@router.get("/scorecard/demo")
async def scorecard_demo() -> dict[str, Any]:
"""Demo scorecard with synthetic events."""
demo_events = [
{"event_type": "outreach_sent"} for _ in range(15)
] + [
{"event_type": "reply_received"} for _ in range(4)
] + [
{"event_type": "demo_booked"} for _ in range(2)
] + [
{"event_type": "blocked_action"} for _ in range(6)
]
return build_daily_launch_scorecard(events=demo_events)