mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2026-06-17 23:09:35 +00:00
Merge pull request #30 from VoXc2/merge/layer13-into-ai-company
merge: Layer 13 public launch + Layer 14 sales + Paid Beta runbook into ai-company
This commit is contained in:
VoXc2
GitHub
commit
c95179e50c
@ -46,6 +46,7 @@ from api.routers import (
|
||||
pricing,
|
||||
prospect,
|
||||
public,
|
||||
public_launch,
|
||||
revenue_launch,
|
||||
revenue,
|
||||
revenue_os,
|
||||
@ -176,6 +177,7 @@ def create_app() -> FastAPI:
|
||||
app.include_router(service_excellence.router)
|
||||
app.include_router(launch_ops.router)
|
||||
app.include_router(revenue_launch.router)
|
||||
app.include_router(public_launch.router)
|
||||
app.include_router(business.router)
|
||||
app.include_router(personal_operator.router)
|
||||
app.include_router(public.router)
|
||||
|
||||
171
dealix/api/routers/public_launch.py
Normal file
171
dealix/api/routers/public_launch.py
Normal file
@ -0,0 +1,171 @@
|
||||
"""Public Launch API — Layer 13 endpoints.
|
||||
|
||||
Endpoints:
|
||||
GET /api/v1/public-launch/criteria
|
||||
POST /api/v1/public-launch/gate-check
|
||||
POST /api/v1/public-launch/pilot-tracker
|
||||
POST /api/v1/public-launch/pdpl-compliance
|
||||
POST /api/v1/public-launch/brand-moat
|
||||
GET /api/v1/public-launch/demo
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any
|
||||
|
||||
from fastapi import APIRouter
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
from auto_client_acquisition.public_launch import (
|
||||
PUBLIC_LAUNCH_CRITERIA,
|
||||
evaluate_public_launch_gate,
|
||||
pilot_tracker_summary,
|
||||
compute_pdpl_compliance,
|
||||
compute_brand_moat_score,
|
||||
)
|
||||
|
||||
|
||||
router = APIRouter(prefix="/api/v1/public-launch", tags=["public-launch"])
|
||||
|
||||
|
||||
class GateCheckRequest(BaseModel):
|
||||
state: dict[str, Any] = Field(default_factory=dict)
|
||||
|
||||
|
||||
class PilotTrackerRequest(BaseModel):
|
||||
pilots: list[dict[str, Any]] = Field(default_factory=list)
|
||||
|
||||
|
||||
class PDPLRequest(BaseModel):
|
||||
state: dict[str, Any] = Field(default_factory=dict)
|
||||
|
||||
|
||||
class BrandMoatRequest(BaseModel):
|
||||
state: dict[str, Any] = Field(default_factory=dict)
|
||||
|
||||
|
||||
@router.get("/criteria")
|
||||
def list_criteria() -> dict[str, Any]:
|
||||
"""Return the 9 Public Launch criteria definitions."""
|
||||
return {
|
||||
"criteria": [
|
||||
{
|
||||
"key": c.key,
|
||||
"name_ar": c.name_ar,
|
||||
"threshold": c.threshold,
|
||||
"unit": c.unit,
|
||||
"description_ar": c.description_ar,
|
||||
}
|
||||
for c in PUBLIC_LAUNCH_CRITERIA
|
||||
],
|
||||
"count": len(PUBLIC_LAUNCH_CRITERIA),
|
||||
}
|
||||
|
||||
|
||||
@router.post("/gate-check")
|
||||
def gate_check(req: GateCheckRequest) -> dict[str, Any]:
|
||||
verdict = evaluate_public_launch_gate(req.state)
|
||||
return verdict.to_dict()
|
||||
|
||||
|
||||
@router.post("/pilot-tracker")
|
||||
def pilot_tracker(req: PilotTrackerRequest) -> dict[str, Any]:
|
||||
summary = pilot_tracker_summary(req.pilots)
|
||||
return summary.to_dict()
|
||||
|
||||
|
||||
@router.post("/pdpl-compliance")
|
||||
def pdpl_compliance(req: PDPLRequest) -> dict[str, Any]:
|
||||
report = compute_pdpl_compliance(req.state)
|
||||
return report.to_dict()
|
||||
|
||||
|
||||
@router.post("/brand-moat")
|
||||
def brand_moat(req: BrandMoatRequest) -> dict[str, Any]:
|
||||
score = compute_brand_moat_score(req.state)
|
||||
return score.to_dict()
|
||||
|
||||
|
||||
@router.get("/demo")
|
||||
def demo() -> dict[str, Any]:
|
||||
"""Combined demo response showing realistic Paid-Beta-stage data."""
|
||||
# State: company is at Paid Beta with 2 pilots, 1 paid, etc.
|
||||
gate_state = {
|
||||
"pilots_completed": 2,
|
||||
"paid_customers": 1,
|
||||
"unsafe_sends": 0,
|
||||
"proof_cadence_weeks": 1,
|
||||
"support_first_response_minutes_p1": 90,
|
||||
"funnel_visible": True,
|
||||
"staging_uptime_days": 3,
|
||||
"billing_webhook_verified": False,
|
||||
"legal_complete": False,
|
||||
}
|
||||
pilots = [
|
||||
{
|
||||
"pilot_id": "p1",
|
||||
"company": "وكالة النمو السعودي",
|
||||
"sector": "agency",
|
||||
"city": "الرياض",
|
||||
"started_at": "2026-04-25",
|
||||
"stage": "completed",
|
||||
"paid": True,
|
||||
"pilot_price_sar": 499,
|
||||
"proof_pack_sent": True,
|
||||
"proof_pack_sent_at": "2026-05-01",
|
||||
"upgrade_outcome": "growth_os_monthly",
|
||||
"upgrade_value_sar": 2999,
|
||||
},
|
||||
{
|
||||
"pilot_id": "p2",
|
||||
"company": "شركة تدريب الرياض",
|
||||
"sector": "training",
|
||||
"city": "الرياض",
|
||||
"started_at": "2026-04-28",
|
||||
"stage": "proof_pack_sent",
|
||||
"paid": False,
|
||||
"pilot_price_sar": 0,
|
||||
"proof_pack_sent": True,
|
||||
"proof_pack_sent_at": "2026-05-01",
|
||||
"upgrade_outcome": "case_study",
|
||||
"upgrade_value_sar": 0,
|
||||
},
|
||||
]
|
||||
pdpl_state = {
|
||||
"data_residency_saudi": True,
|
||||
"whatsapp_opt_in_audit": True,
|
||||
"email_opt_in_audit": True,
|
||||
"breach_notification_72h_ready": True,
|
||||
"dpa_template_published": True,
|
||||
"privacy_policy_bilingual": False,
|
||||
"data_retention_policy": True,
|
||||
"trace_redaction_active": True,
|
||||
"action_ledger_audit": True,
|
||||
"consent_revocation_path": False,
|
||||
}
|
||||
moat_state = {
|
||||
"events_logged_count": 50,
|
||||
"messages_per_sector_count": 10,
|
||||
"sectors_covered_count": 4,
|
||||
"linkedin_followers": 200,
|
||||
"newsletter_subscribers": 30,
|
||||
"monthly_branded_searches": 5,
|
||||
"case_studies_published": 1,
|
||||
"pdpl_compliance_pct": 80,
|
||||
"iso_27001_progress_pct": 0,
|
||||
"audit_count_last_year": 0,
|
||||
"dpa_signed_with_customers_pct": 50,
|
||||
"agency_partners_count": 1,
|
||||
"active_referring_agencies_count": 0,
|
||||
"agency_revenue_share_paid_sar": 0,
|
||||
"certified_operators_count": 0,
|
||||
"operators_active_last_30d": 0,
|
||||
"operator_revenue_share_paid_sar": 0,
|
||||
}
|
||||
|
||||
return {
|
||||
"gate": evaluate_public_launch_gate(gate_state).to_dict(),
|
||||
"pilots": pilot_tracker_summary(pilots).to_dict(),
|
||||
"pdpl": compute_pdpl_compliance(pdpl_state).to_dict(),
|
||||
"brand_moat": compute_brand_moat_score(moat_state).to_dict(),
|
||||
}
|
||||
50
dealix/auto_client_acquisition/public_launch/__init__.py
Normal file
50
dealix/auto_client_acquisition/public_launch/__init__.py
Normal file
@ -0,0 +1,50 @@
|
||||
"""Public Launch readiness gate — Layer 13.
|
||||
|
||||
Closes the loop from Paid Beta to Public Launch. All criteria are
|
||||
deterministic and gated by Hard Rules (no live send, no scraping,
|
||||
PDPL-first, approval-first).
|
||||
|
||||
Public surface:
|
||||
- evaluate_public_launch_gate(state) -> GateVerdict
|
||||
- pilot_tracker_summary(pilots) -> PilotSummary
|
||||
- compute_pdpl_compliance(state) -> PDPLReport
|
||||
- compute_brand_moat_score(state) -> BrandMoatScore
|
||||
"""
|
||||
|
||||
from .gate import (
|
||||
GateVerdict,
|
||||
GateCriterion,
|
||||
evaluate_public_launch_gate,
|
||||
PUBLIC_LAUNCH_CRITERIA,
|
||||
)
|
||||
from .pilot_tracker import (
|
||||
PilotRecord,
|
||||
PilotSummary,
|
||||
pilot_tracker_summary,
|
||||
)
|
||||
from .pdpl_compliance import (
|
||||
PDPLReport,
|
||||
PDPLCheck,
|
||||
compute_pdpl_compliance,
|
||||
)
|
||||
from .brand_moat import (
|
||||
BrandMoatScore,
|
||||
BrandMoatDimension,
|
||||
compute_brand_moat_score,
|
||||
)
|
||||
|
||||
__all__ = [
|
||||
"GateVerdict",
|
||||
"GateCriterion",
|
||||
"evaluate_public_launch_gate",
|
||||
"PUBLIC_LAUNCH_CRITERIA",
|
||||
"PilotRecord",
|
||||
"PilotSummary",
|
||||
"pilot_tracker_summary",
|
||||
"PDPLReport",
|
||||
"PDPLCheck",
|
||||
"compute_pdpl_compliance",
|
||||
"BrandMoatScore",
|
||||
"BrandMoatDimension",
|
||||
"compute_brand_moat_score",
|
||||
]
|
||||
209
dealix/auto_client_acquisition/public_launch/brand_moat.py
Normal file
209
dealix/auto_client_acquisition/public_launch/brand_moat.py
Normal file
@ -0,0 +1,209 @@
|
||||
"""Brand Moat Score — measure competitive defensibility.
|
||||
|
||||
Five moat dimensions per MASTER_STRATEGIC_PLAN §6:
|
||||
1. Data Moat (Saudi Revenue Graph)
|
||||
2. Brand Moat (Saudi-First presence)
|
||||
3. Compliance Moat (PDPL Native)
|
||||
4. Network Moat (Agency Channel)
|
||||
5. Distribution Moat (Operator Network)
|
||||
|
||||
Each dimension is scored 0–100. A weighted total is the overall
|
||||
moat strength. This is a forward-looking metric — it does not gate
|
||||
Public Launch (PDPL + GateVerdict do that), but it's used in
|
||||
weekly Founder briefs and investor decks.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from dataclasses import dataclass, asdict
|
||||
from typing import Any, Mapping
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class BrandMoatDimension:
|
||||
key: str
|
||||
name_ar: str
|
||||
weight: float # 0.0–1.0
|
||||
description_ar: str
|
||||
|
||||
|
||||
BRAND_MOAT_DIMENSIONS: tuple[BrandMoatDimension, ...] = (
|
||||
BrandMoatDimension(
|
||||
key="data_moat",
|
||||
name_ar="Data Moat (Saudi Revenue Graph)",
|
||||
weight=0.30,
|
||||
description_ar="عمق بيانات العلاقات والإشارات السعودية",
|
||||
),
|
||||
BrandMoatDimension(
|
||||
key="brand_moat",
|
||||
name_ar="Brand Moat (Saudi-First)",
|
||||
weight=0.20,
|
||||
description_ar="حضور الـ founder + المحتوى العربي + الـ brand awareness",
|
||||
),
|
||||
BrandMoatDimension(
|
||||
key="compliance_moat",
|
||||
name_ar="Compliance Moat (PDPL Native)",
|
||||
weight=0.20,
|
||||
description_ar="audit trail + DPA + opt-in + ISO 27001",
|
||||
),
|
||||
BrandMoatDimension(
|
||||
key="network_moat",
|
||||
name_ar="Network Moat (Agency Channel)",
|
||||
weight=0.20,
|
||||
description_ar="عدد + جودة الوكالات الشريكة + revenue share",
|
||||
),
|
||||
BrandMoatDimension(
|
||||
key="distribution_moat",
|
||||
name_ar="Distribution Moat (Operator Network)",
|
||||
weight=0.10,
|
||||
description_ar="Dealix Operators المعتمدون يبيعون كـ خدمة",
|
||||
),
|
||||
)
|
||||
|
||||
|
||||
# Sub-criteria scoring (each 0–100 → averaged within a dimension)
|
||||
DATA_MOAT_SUBSCORES = {
|
||||
"events_logged_count": (1_000, 100), # ≥1000 events = 100
|
||||
"messages_per_sector_count": (50, 100), # ≥50 messages per sector = 100
|
||||
"sectors_covered_count": (10, 100), # ≥10 sectors = 100
|
||||
}
|
||||
|
||||
BRAND_MOAT_SUBSCORES = {
|
||||
"linkedin_followers": (5_000, 100),
|
||||
"newsletter_subscribers": (1_000, 100),
|
||||
"monthly_branded_searches": (500, 100),
|
||||
"case_studies_published": (10, 100),
|
||||
}
|
||||
|
||||
COMPLIANCE_MOAT_SUBSCORES = {
|
||||
"pdpl_compliance_pct": (100, 100), # already 0–100
|
||||
"iso_27001_progress_pct": (100, 100),
|
||||
"audit_count_last_year": (4, 100),
|
||||
"dpa_signed_with_customers_pct": (100, 100),
|
||||
}
|
||||
|
||||
NETWORK_MOAT_SUBSCORES = {
|
||||
"agency_partners_count": (30, 100),
|
||||
"active_referring_agencies_count": (15, 100),
|
||||
"agency_revenue_share_paid_sar": (100_000, 100),
|
||||
}
|
||||
|
||||
DISTRIBUTION_MOAT_SUBSCORES = {
|
||||
"certified_operators_count": (100, 100),
|
||||
"operators_active_last_30d": (50, 100),
|
||||
"operator_revenue_share_paid_sar": (50_000, 100),
|
||||
}
|
||||
|
||||
ALL_SUBSCORES = {
|
||||
"data_moat": DATA_MOAT_SUBSCORES,
|
||||
"brand_moat": BRAND_MOAT_SUBSCORES,
|
||||
"compliance_moat": COMPLIANCE_MOAT_SUBSCORES,
|
||||
"network_moat": NETWORK_MOAT_SUBSCORES,
|
||||
"distribution_moat": DISTRIBUTION_MOAT_SUBSCORES,
|
||||
}
|
||||
|
||||
|
||||
@dataclass
|
||||
class BrandMoatScore:
|
||||
overall_score: float # 0–100
|
||||
tier: str # "fragile" | "emerging" | "defensible" | "dominant"
|
||||
dimensions: list[Mapping[str, Any]]
|
||||
weakest_dimension: str
|
||||
strongest_dimension: str
|
||||
next_actions_ar: list[str]
|
||||
summary_ar: str
|
||||
|
||||
def to_dict(self) -> dict[str, Any]:
|
||||
return asdict(self)
|
||||
|
||||
|
||||
def _score_dimension(dim_key: str, state: Mapping[str, Any]) -> float:
|
||||
subs = ALL_SUBSCORES.get(dim_key, {})
|
||||
if not subs:
|
||||
return 0.0
|
||||
scores: list[float] = []
|
||||
for metric, (target, max_score) in subs.items():
|
||||
raw = state.get(metric, 0) or 0
|
||||
try:
|
||||
v = float(raw)
|
||||
except (TypeError, ValueError):
|
||||
v = 0.0
|
||||
pct = min(v / target, 1.0) * max_score
|
||||
scores.append(pct)
|
||||
return round(sum(scores) / len(scores), 1)
|
||||
|
||||
|
||||
def _tier_for(score: float) -> str:
|
||||
if score >= 80:
|
||||
return "dominant"
|
||||
if score >= 60:
|
||||
return "defensible"
|
||||
if score >= 35:
|
||||
return "emerging"
|
||||
return "fragile"
|
||||
|
||||
|
||||
def _tier_summary(tier: str) -> str:
|
||||
return {
|
||||
"dominant": "🏆 موقع مهيمن — Dealix لا يُستبدل بسهولة من المنافسين العالميين",
|
||||
"defensible": "🛡️ موقع دفاعي — moat واضح لكن يحتاج تعميق",
|
||||
"emerging": "🌱 موقع ناشئ — البناء قائم؛ الـ moat لم يكتمل",
|
||||
"fragile": "⚠️ موقع هش — المنافسون يقدرون يدخلون السوق بسهولة",
|
||||
}[tier]
|
||||
|
||||
|
||||
def compute_brand_moat_score(state: Mapping[str, Any]) -> BrandMoatScore:
|
||||
"""Compute weighted brand moat score across 5 dimensions.
|
||||
|
||||
Args:
|
||||
state: dict with sub-metric keys (see *_SUBSCORES dicts above).
|
||||
|
||||
Returns:
|
||||
BrandMoatScore with overall, per-dimension, and recommendations.
|
||||
"""
|
||||
dimensions: list[dict[str, Any]] = []
|
||||
weighted_total = 0.0
|
||||
|
||||
for dim in BRAND_MOAT_DIMENSIONS:
|
||||
score = _score_dimension(dim.key, state)
|
||||
weighted_total += score * dim.weight
|
||||
dimensions.append({
|
||||
"key": dim.key,
|
||||
"name_ar": dim.name_ar,
|
||||
"score": score,
|
||||
"weight": dim.weight,
|
||||
"tier": _tier_for(score),
|
||||
})
|
||||
|
||||
overall = round(weighted_total, 1)
|
||||
tier = _tier_for(overall)
|
||||
|
||||
weakest = min(dimensions, key=lambda d: d["score"])
|
||||
strongest = max(dimensions, key=lambda d: d["score"])
|
||||
|
||||
actions: list[str] = []
|
||||
if weakest["score"] < 50:
|
||||
actions.append(
|
||||
f"ضاعف الجهد على {weakest['name_ar']} — هذه أضعف نقطة دفاعية الآن."
|
||||
)
|
||||
if overall < 60:
|
||||
actions.append("لا تنتقل لـ GCC expansion قبل أن يصبح overall ≥ 60.")
|
||||
if overall >= 80:
|
||||
actions.append("ابدأ Series-A pitch — عندك moat قابل للعرض.")
|
||||
|
||||
summary = (
|
||||
f"Brand Moat Score: {overall}/100 ({tier}). "
|
||||
f"الأقوى: {strongest['name_ar']}. "
|
||||
f"الأضعف: {weakest['name_ar']}. "
|
||||
f"{_tier_summary(tier)}."
|
||||
)
|
||||
|
||||
return BrandMoatScore(
|
||||
overall_score=overall,
|
||||
tier=tier,
|
||||
dimensions=dimensions,
|
||||
weakest_dimension=weakest["key"],
|
||||
strongest_dimension=strongest["key"],
|
||||
next_actions_ar=actions,
|
||||
summary_ar=summary,
|
||||
)
|
||||
246
dealix/auto_client_acquisition/public_launch/gate.py
Normal file
246
dealix/auto_client_acquisition/public_launch/gate.py
Normal file
@ -0,0 +1,246 @@
|
||||
"""Public Launch Gate — evaluates 9 deterministic criteria.
|
||||
|
||||
The gate is the formal transition from Paid Beta to Public Launch.
|
||||
All criteria must be deterministic (no LLM, no network) so that the
|
||||
verdict is reproducible in CI and in the dashboard.
|
||||
|
||||
Criteria (from PAID_BETA_OPERATING_PLAYBOOK §8):
|
||||
1. ≥5 pilots completed (delivered Proof Pack within 7 days)
|
||||
2. ≥2 paid customers (Moyasar invoice paid OR signed Growth OS)
|
||||
3. 0 unsafe sends (no live action without approval in audit ledger)
|
||||
4. Weekly Proof Pack cadence (≥3 weeks consecutive)
|
||||
5. Support flow operational (avg first response < SLA)
|
||||
6. Funnel visible (lead → demo → pilot → paid measurable)
|
||||
7. ≥14 days staging stable (uptime ≥ 99% over 14 days)
|
||||
8. Billing live (Moyasar webhook signed and verified)
|
||||
9. Legal complete (Terms + Privacy + DPA published)
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from dataclasses import dataclass, field, asdict
|
||||
from typing import Any, Mapping, Sequence
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class GateCriterion:
|
||||
"""Definition of a single Public Launch criterion."""
|
||||
key: str
|
||||
name_ar: str
|
||||
threshold: float | int | bool
|
||||
unit: str
|
||||
description_ar: str
|
||||
|
||||
|
||||
PUBLIC_LAUNCH_CRITERIA: tuple[GateCriterion, ...] = (
|
||||
GateCriterion(
|
||||
key="pilots_completed",
|
||||
name_ar="Pilots مكتملة",
|
||||
threshold=5,
|
||||
unit="count",
|
||||
description_ar="عدد Pilots التي سُلّم لها Proof Pack نهائي خلال 7 أيام",
|
||||
),
|
||||
GateCriterion(
|
||||
key="paid_customers",
|
||||
name_ar="عملاء مدفوعون",
|
||||
threshold=2,
|
||||
unit="count",
|
||||
description_ar="عملاء دفعوا فعلياً عبر Moyasar أو وقّعوا Growth OS",
|
||||
),
|
||||
GateCriterion(
|
||||
key="unsafe_sends",
|
||||
name_ar="إرسال غير آمن",
|
||||
threshold=0,
|
||||
unit="count",
|
||||
description_ar="عدد الأفعال الـ live بدون اعتماد بشري في Action Ledger (يجب = 0)",
|
||||
),
|
||||
GateCriterion(
|
||||
key="proof_cadence_weeks",
|
||||
name_ar="استمرارية Proof Pack",
|
||||
threshold=3,
|
||||
unit="weeks_consecutive",
|
||||
description_ar="عدد الأسابيع المتتالية التي صدر فيها Proof Pack",
|
||||
),
|
||||
GateCriterion(
|
||||
key="support_first_response_minutes_p1",
|
||||
name_ar="استجابة Support P1",
|
||||
threshold=120,
|
||||
unit="minutes",
|
||||
description_ar="متوسط استجابة P1 ≤ 120 دقيقة (هدف SLA)",
|
||||
),
|
||||
GateCriterion(
|
||||
key="funnel_visible",
|
||||
name_ar="Funnel مرئي",
|
||||
threshold=True,
|
||||
unit="bool",
|
||||
description_ar="lead→demo→pilot→paid قابل للقياس في Operating Board",
|
||||
),
|
||||
GateCriterion(
|
||||
key="staging_uptime_days",
|
||||
name_ar="استقرار Staging",
|
||||
threshold=14,
|
||||
unit="days_uptime_99",
|
||||
description_ar="عدد الأيام المتتالية بـ uptime ≥ 99% على staging",
|
||||
),
|
||||
GateCriterion(
|
||||
key="billing_webhook_verified",
|
||||
name_ar="Moyasar webhook موثّق",
|
||||
threshold=True,
|
||||
unit="bool",
|
||||
description_ar="Moyasar webhook signed وتم تحقق التوقيع",
|
||||
),
|
||||
GateCriterion(
|
||||
key="legal_complete",
|
||||
name_ar="القانوني مكتمل",
|
||||
threshold=True,
|
||||
unit="bool",
|
||||
description_ar="Terms of Service + Privacy Policy + DPA منشورة بالعربي والإنجليزي",
|
||||
),
|
||||
)
|
||||
|
||||
|
||||
@dataclass
|
||||
class GateVerdict:
|
||||
"""Result of evaluating Public Launch readiness."""
|
||||
decision: str # "GO_PUBLIC_LAUNCH" | "NO_GO" | "BLOCKED"
|
||||
score_passed: int
|
||||
score_total: int
|
||||
blockers: list[Mapping[str, Any]]
|
||||
next_actions_ar: list[str]
|
||||
criteria_results: list[Mapping[str, Any]]
|
||||
summary_ar: str
|
||||
|
||||
def to_dict(self) -> dict[str, Any]:
|
||||
return asdict(self)
|
||||
|
||||
|
||||
def _check_criterion(crit: GateCriterion, value: Any) -> tuple[bool, str]:
|
||||
"""Compare actual value against threshold. Return (passed, reason_ar)."""
|
||||
if crit.unit == "bool":
|
||||
passed = bool(value) is bool(crit.threshold)
|
||||
if passed:
|
||||
return True, "متحقّق"
|
||||
return False, f"يجب أن يكون {crit.threshold}"
|
||||
|
||||
if crit.key == "unsafe_sends":
|
||||
# Unique: lower is better. Threshold = 0 means must equal 0.
|
||||
try:
|
||||
v = int(value)
|
||||
except (TypeError, ValueError):
|
||||
return False, "قيمة غير صحيحة"
|
||||
return (v == 0, f"وُجد {v} (يجب = 0)" if v != 0 else "0 إرسال غير آمن")
|
||||
|
||||
if crit.key == "support_first_response_minutes_p1":
|
||||
# Lower is better. Threshold is the maximum.
|
||||
try:
|
||||
v = float(value)
|
||||
except (TypeError, ValueError):
|
||||
return False, "قيمة غير صحيحة"
|
||||
return (
|
||||
v <= crit.threshold,
|
||||
f"{v:.0f} دقيقة (الحد الأعلى {crit.threshold})",
|
||||
)
|
||||
|
||||
# Default: numeric, higher is better.
|
||||
try:
|
||||
v = float(value)
|
||||
except (TypeError, ValueError):
|
||||
return False, "قيمة غير صحيحة"
|
||||
return (
|
||||
v >= crit.threshold,
|
||||
f"{int(v) if v.is_integer() else v}/{crit.threshold} {crit.unit}",
|
||||
)
|
||||
|
||||
|
||||
def _next_action_for(crit: GateCriterion, value: Any) -> str | None:
|
||||
"""Generate Arabic next-action when a criterion fails."""
|
||||
if crit.key == "pilots_completed":
|
||||
return f"شغّل {int(crit.threshold) - int(value or 0)} Pilots إضافية مع Proof Pack مكتمل."
|
||||
if crit.key == "paid_customers":
|
||||
return f"اقفل {int(crit.threshold) - int(value or 0)} عميل مدفوع إضافي (Moyasar أو Growth OS)."
|
||||
if crit.key == "unsafe_sends":
|
||||
return "راجع Action Ledger، أوقف القناة المعنية، نفّذ post-mortem فوراً."
|
||||
if crit.key == "proof_cadence_weeks":
|
||||
return "أصدر Proof Pack أسبوعياً متتالياً حتى تصل 3 أسابيع متتالية."
|
||||
if crit.key == "support_first_response_minutes_p1":
|
||||
return "حسّن SLA — قلّل first-response P1 إلى ≤120 دقيقة."
|
||||
if crit.key == "funnel_visible":
|
||||
return "افتح Operating Board مع كل الأعمدة الـ15 وحدّثه يومياً."
|
||||
if crit.key == "staging_uptime_days":
|
||||
return f"حافظ على staging stable حتى تصل {int(crit.threshold)} يوم متتالي بـ uptime ≥99%."
|
||||
if crit.key == "billing_webhook_verified":
|
||||
return "فعّل Moyasar webhook signature verification + اختبر بـ test payload."
|
||||
if crit.key == "legal_complete":
|
||||
return "انشر Terms + Privacy + DPA باللغتين العربية والإنجليزية على الموقع."
|
||||
return None
|
||||
|
||||
|
||||
def evaluate_public_launch_gate(
|
||||
state: Mapping[str, Any],
|
||||
criteria: Sequence[GateCriterion] | None = None,
|
||||
) -> GateVerdict:
|
||||
"""Evaluate Public Launch readiness.
|
||||
|
||||
Args:
|
||||
state: dict mapping criterion key → measured value.
|
||||
criteria: optional override (defaults to PUBLIC_LAUNCH_CRITERIA).
|
||||
|
||||
Returns:
|
||||
GateVerdict with decision, score, blockers, and Arabic next actions.
|
||||
"""
|
||||
crits = criteria or PUBLIC_LAUNCH_CRITERIA
|
||||
results: list[dict[str, Any]] = []
|
||||
blockers: list[dict[str, Any]] = []
|
||||
actions: list[str] = []
|
||||
passed_count = 0
|
||||
|
||||
for c in crits:
|
||||
value = state.get(c.key)
|
||||
ok, reason = _check_criterion(c, value)
|
||||
result = {
|
||||
"key": c.key,
|
||||
"name_ar": c.name_ar,
|
||||
"passed": ok,
|
||||
"value": value,
|
||||
"threshold": c.threshold,
|
||||
"unit": c.unit,
|
||||
"reason_ar": reason,
|
||||
}
|
||||
results.append(result)
|
||||
if ok:
|
||||
passed_count += 1
|
||||
else:
|
||||
blockers.append(result)
|
||||
action = _next_action_for(c, value)
|
||||
if action:
|
||||
actions.append(action)
|
||||
|
||||
total = len(crits)
|
||||
if passed_count == total:
|
||||
decision = "GO_PUBLIC_LAUNCH"
|
||||
summary = (
|
||||
f"✅ جاهز للإطلاق العام — كل المعايير الـ{total} متحققة. "
|
||||
"ابدأ خطة Public Launch من MASTER_STRATEGIC_PLAN §3 Phase 3."
|
||||
)
|
||||
elif any(b["key"] == "unsafe_sends" for b in blockers):
|
||||
decision = "BLOCKED"
|
||||
summary = (
|
||||
"🛑 Hard block — إرسال غير آمن مكتشف. "
|
||||
"أوقف كل live actions الآن. شغّل incident_router SEV1."
|
||||
)
|
||||
else:
|
||||
decision = "NO_GO"
|
||||
summary = (
|
||||
f"⏳ NO_GO — {passed_count}/{total} متحقق. "
|
||||
f"المتبقي: {', '.join(b['name_ar'] for b in blockers)}."
|
||||
)
|
||||
|
||||
return GateVerdict(
|
||||
decision=decision,
|
||||
score_passed=passed_count,
|
||||
score_total=total,
|
||||
blockers=blockers,
|
||||
next_actions_ar=actions,
|
||||
criteria_results=results,
|
||||
summary_ar=summary,
|
||||
)
|
||||
176
dealix/auto_client_acquisition/public_launch/pdpl_compliance.py
Normal file
176
dealix/auto_client_acquisition/public_launch/pdpl_compliance.py
Normal file
@ -0,0 +1,176 @@
|
||||
"""PDPL Compliance — final readiness check before Public Launch.
|
||||
|
||||
Saudi Personal Data Protection Law (PDPL) compliance check covering:
|
||||
- Data residency
|
||||
- Opt-in audit per channel
|
||||
- Breach notification readiness (72-hour rule)
|
||||
- DPA template availability
|
||||
- Privacy policy bilingual publication
|
||||
- SDAIA registration status (if applicable)
|
||||
- Data retention policy enforcement
|
||||
|
||||
Deterministic — no I/O, no LLM. State is passed in as dict.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from dataclasses import dataclass, asdict
|
||||
from typing import Any, Mapping
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class PDPLCheck:
|
||||
key: str
|
||||
name_ar: str
|
||||
description_ar: str
|
||||
severity: str # "critical" | "high" | "medium"
|
||||
|
||||
|
||||
PDPL_CHECKS: tuple[PDPLCheck, ...] = (
|
||||
PDPLCheck(
|
||||
key="data_residency_saudi",
|
||||
name_ar="إقامة البيانات في السعودية",
|
||||
description_ar="بيانات العملاء مخزنة في region سعودي أو لدى شريك سعودي معتمد",
|
||||
severity="critical",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="whatsapp_opt_in_audit",
|
||||
name_ar="تدقيق opt-in لـ WhatsApp",
|
||||
description_ar="كل رقم واتساب فيه opt-in موثّق قبل الإرسال",
|
||||
severity="critical",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="email_opt_in_audit",
|
||||
name_ar="تدقيق opt-in لـ Email",
|
||||
description_ar="كل بريد إلكتروني فيه opt-in موثّق أو جاء عبر website form",
|
||||
severity="high",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="breach_notification_72h_ready",
|
||||
name_ar="جاهزية إبلاغ التسريب خلال 72 ساعة",
|
||||
description_ar="عند تسريب بيانات: إبلاغ SDAIA + العملاء المتأثرين خلال 72 ساعة",
|
||||
severity="critical",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="dpa_template_published",
|
||||
name_ar="نشر نموذج DPA",
|
||||
description_ar="نموذج Data Processing Agreement عربي/إنجليزي متاح للعملاء",
|
||||
severity="high",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="privacy_policy_bilingual",
|
||||
name_ar="سياسة الخصوصية ثنائية اللغة",
|
||||
description_ar="Privacy Policy منشورة بالعربية والإنجليزية على dealix.me",
|
||||
severity="critical",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="data_retention_policy",
|
||||
name_ar="سياسة احتفاظ البيانات",
|
||||
description_ar="بيانات الـ leads غير المتفاعلين تُحذف بعد 90 يوم",
|
||||
severity="high",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="trace_redaction_active",
|
||||
name_ar="إخفاء PII من traces",
|
||||
description_ar="Trace Redactor مفعّل ويغطي email/phone/national_id/passport",
|
||||
severity="critical",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="action_ledger_audit",
|
||||
name_ar="سجل الأفعال (Action Ledger)",
|
||||
description_ar="كل external action مسجّل مع who/what/when/approval_id",
|
||||
severity="high",
|
||||
),
|
||||
PDPLCheck(
|
||||
key="consent_revocation_path",
|
||||
name_ar="مسار إلغاء الموافقة",
|
||||
description_ar="العميل يقدر يلغي opt-in عبر link/email/WhatsApp بدون احتكاك",
|
||||
severity="medium",
|
||||
),
|
||||
)
|
||||
|
||||
|
||||
@dataclass
|
||||
class PDPLReport:
|
||||
overall_status: str # "compliant" | "needs_fixes" | "non_compliant"
|
||||
score_passed: int
|
||||
score_total: int
|
||||
critical_failures: list[Mapping[str, Any]]
|
||||
high_failures: list[Mapping[str, Any]]
|
||||
medium_failures: list[Mapping[str, Any]]
|
||||
check_results: list[Mapping[str, Any]]
|
||||
summary_ar: str
|
||||
next_actions_ar: list[str]
|
||||
|
||||
def to_dict(self) -> dict[str, Any]:
|
||||
return asdict(self)
|
||||
|
||||
|
||||
def compute_pdpl_compliance(state: Mapping[str, Any]) -> PDPLReport:
|
||||
"""Evaluate PDPL compliance.
|
||||
|
||||
Args:
|
||||
state: dict mapping check key → bool (True = compliant).
|
||||
Keys not in state default to False (non-compliant).
|
||||
|
||||
Returns:
|
||||
PDPLReport with overall status, failures by severity, next actions.
|
||||
"""
|
||||
results: list[dict[str, Any]] = []
|
||||
critical_failures: list[dict[str, Any]] = []
|
||||
high_failures: list[dict[str, Any]] = []
|
||||
medium_failures: list[dict[str, Any]] = []
|
||||
actions: list[str] = []
|
||||
passed = 0
|
||||
|
||||
for check in PDPL_CHECKS:
|
||||
ok = bool(state.get(check.key, False))
|
||||
result = {
|
||||
"key": check.key,
|
||||
"name_ar": check.name_ar,
|
||||
"passed": ok,
|
||||
"severity": check.severity,
|
||||
"description_ar": check.description_ar,
|
||||
}
|
||||
results.append(result)
|
||||
if ok:
|
||||
passed += 1
|
||||
else:
|
||||
if check.severity == "critical":
|
||||
critical_failures.append(result)
|
||||
actions.append(f"🛑 [CRITICAL] {check.name_ar} — {check.description_ar}")
|
||||
elif check.severity == "high":
|
||||
high_failures.append(result)
|
||||
actions.append(f"⚠️ [HIGH] {check.name_ar}")
|
||||
else:
|
||||
medium_failures.append(result)
|
||||
|
||||
total = len(PDPL_CHECKS)
|
||||
|
||||
if critical_failures:
|
||||
status = "non_compliant"
|
||||
summary = (
|
||||
f"🛑 NON-COMPLIANT — {len(critical_failures)} مشاكل critical. "
|
||||
"لا تنتقل لـ Public Launch قبل إصلاحها."
|
||||
)
|
||||
elif high_failures:
|
||||
status = "needs_fixes"
|
||||
summary = (
|
||||
f"⚠️ NEEDS FIXES — {len(high_failures)} مشاكل high. "
|
||||
f"PDPL compliance score: {passed}/{total}."
|
||||
)
|
||||
else:
|
||||
status = "compliant"
|
||||
summary = f"✅ COMPLIANT — كل {total} فحوصات PDPL متحققة."
|
||||
|
||||
return PDPLReport(
|
||||
overall_status=status,
|
||||
score_passed=passed,
|
||||
score_total=total,
|
||||
critical_failures=critical_failures,
|
||||
high_failures=high_failures,
|
||||
medium_failures=medium_failures,
|
||||
check_results=results,
|
||||
summary_ar=summary,
|
||||
next_actions_ar=actions,
|
||||
)
|
||||
176
dealix/auto_client_acquisition/public_launch/pilot_tracker.py
Normal file
176
dealix/auto_client_acquisition/public_launch/pilot_tracker.py
Normal file
@ -0,0 +1,176 @@
|
||||
"""Pilot Tracker — track 5–10 active pilots toward Public Launch gate.
|
||||
|
||||
Tracks each Pilot's lifecycle:
|
||||
intake → diagnostic_24h → pilot_48h → proof_pack_7d → upgrade_decision
|
||||
|
||||
Used by the Public Launch Gate to count `pilots_completed` and
|
||||
`paid_customers`. Deterministic — no I/O, no LLM.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from dataclasses import dataclass, asdict, field
|
||||
from datetime import datetime, timezone
|
||||
from typing import Any, Mapping, Sequence
|
||||
|
||||
|
||||
PILOT_STAGES = (
|
||||
"intake", # T+0
|
||||
"diagnostic_sent", # T+24h
|
||||
"pilot_delivered", # T+48h
|
||||
"proof_pack_sent", # T+7d
|
||||
"upgrade_decided", # T+14d
|
||||
"completed", # marked done
|
||||
"stalled", # SLA breach
|
||||
"lost", # no upgrade, no case study
|
||||
)
|
||||
|
||||
UPGRADE_OUTCOMES = (
|
||||
"growth_os_monthly", # 2,999/mo subscription
|
||||
"partnership_growth", # 3,000–7,500 SAR
|
||||
"case_study", # free in exchange for case study
|
||||
"second_pilot", # paid 499 again, different angle
|
||||
"no_upgrade", # explicit decline
|
||||
"ghost", # no response
|
||||
)
|
||||
|
||||
|
||||
@dataclass
|
||||
class PilotRecord:
|
||||
"""A single Pilot's data."""
|
||||
pilot_id: str
|
||||
company: str
|
||||
sector: str
|
||||
city: str
|
||||
started_at: str # ISO date
|
||||
stage: str
|
||||
paid: bool # True if 499 SAR received OR signed Growth OS
|
||||
pilot_price_sar: int
|
||||
proof_pack_sent: bool
|
||||
proof_pack_sent_at: str | None
|
||||
upgrade_outcome: str | None
|
||||
upgrade_value_sar: int = 0
|
||||
notes: str = ""
|
||||
|
||||
def to_dict(self) -> dict[str, Any]:
|
||||
return asdict(self)
|
||||
|
||||
|
||||
@dataclass
|
||||
class PilotSummary:
|
||||
"""Aggregate view across all pilots."""
|
||||
total_pilots: int
|
||||
completed_pilots: int # reached upgrade_decided or completed
|
||||
proof_packs_delivered: int
|
||||
paid_pilots: int
|
||||
paid_revenue_sar: int # sum of pilot prices that were paid
|
||||
upgrade_revenue_sar: int # sum of upgrade_value_sar
|
||||
case_studies: int # upgrade_outcome == "case_study"
|
||||
growth_os_subscribers: int # upgrade_outcome == "growth_os_monthly"
|
||||
stalled_pilots: int
|
||||
lost_pilots: int
|
||||
completion_rate: float # completed / total
|
||||
paid_conversion_rate: float # paid / total
|
||||
upgrade_conversion_rate: float # any upgrade / completed
|
||||
by_sector: dict[str, int]
|
||||
by_city: dict[str, int]
|
||||
average_proof_pack_days: float
|
||||
summary_ar: str
|
||||
|
||||
def to_dict(self) -> dict[str, Any]:
|
||||
return asdict(self)
|
||||
|
||||
|
||||
def _parse_iso(s: str) -> datetime | None:
|
||||
if not s:
|
||||
return None
|
||||
try:
|
||||
return datetime.fromisoformat(s.replace("Z", "+00:00"))
|
||||
except ValueError:
|
||||
return None
|
||||
|
||||
|
||||
def pilot_tracker_summary(pilots: Sequence[PilotRecord | Mapping[str, Any]]) -> PilotSummary:
|
||||
"""Compute aggregate summary across all pilots.
|
||||
|
||||
Accepts either PilotRecord instances or plain dicts (for API ingestion).
|
||||
"""
|
||||
records: list[PilotRecord] = []
|
||||
for p in pilots:
|
||||
if isinstance(p, PilotRecord):
|
||||
records.append(p)
|
||||
else:
|
||||
records.append(PilotRecord(
|
||||
pilot_id=str(p.get("pilot_id", "")),
|
||||
company=str(p.get("company", "")),
|
||||
sector=str(p.get("sector", "unknown")),
|
||||
city=str(p.get("city", "unknown")),
|
||||
started_at=str(p.get("started_at", "")),
|
||||
stage=str(p.get("stage", "intake")),
|
||||
paid=bool(p.get("paid", False)),
|
||||
pilot_price_sar=int(p.get("pilot_price_sar", 499)),
|
||||
proof_pack_sent=bool(p.get("proof_pack_sent", False)),
|
||||
proof_pack_sent_at=p.get("proof_pack_sent_at"),
|
||||
upgrade_outcome=p.get("upgrade_outcome"),
|
||||
upgrade_value_sar=int(p.get("upgrade_value_sar", 0)),
|
||||
notes=str(p.get("notes", "")),
|
||||
))
|
||||
|
||||
total = len(records)
|
||||
completed_stages = {"upgrade_decided", "completed"}
|
||||
completed = sum(1 for r in records if r.stage in completed_stages)
|
||||
proof_count = sum(1 for r in records if r.proof_pack_sent)
|
||||
paid_count = sum(1 for r in records if r.paid)
|
||||
paid_revenue = sum(r.pilot_price_sar for r in records if r.paid)
|
||||
upgrade_revenue = sum(r.upgrade_value_sar for r in records)
|
||||
case_studies = sum(1 for r in records if r.upgrade_outcome == "case_study")
|
||||
gros_subs = sum(1 for r in records if r.upgrade_outcome == "growth_os_monthly")
|
||||
stalled = sum(1 for r in records if r.stage == "stalled")
|
||||
lost = sum(1 for r in records if r.stage == "lost")
|
||||
|
||||
by_sector: dict[str, int] = {}
|
||||
by_city: dict[str, int] = {}
|
||||
for r in records:
|
||||
by_sector[r.sector] = by_sector.get(r.sector, 0) + 1
|
||||
by_city[r.city] = by_city.get(r.city, 0) + 1
|
||||
|
||||
proof_durations: list[float] = []
|
||||
for r in records:
|
||||
if r.proof_pack_sent and r.proof_pack_sent_at and r.started_at:
|
||||
start = _parse_iso(r.started_at)
|
||||
done = _parse_iso(r.proof_pack_sent_at)
|
||||
if start and done:
|
||||
proof_durations.append((done - start).total_seconds() / 86400)
|
||||
avg_proof_days = (
|
||||
round(sum(proof_durations) / len(proof_durations), 2)
|
||||
if proof_durations else 0.0
|
||||
)
|
||||
|
||||
summary_ar = (
|
||||
f"{total} Pilots إجمالاً، {completed} مكتمل، "
|
||||
f"{paid_count} مدفوع، {proof_count} Proof Packs، "
|
||||
f"{gros_subs} Growth OS، {case_studies} case studies."
|
||||
)
|
||||
|
||||
return PilotSummary(
|
||||
total_pilots=total,
|
||||
completed_pilots=completed,
|
||||
proof_packs_delivered=proof_count,
|
||||
paid_pilots=paid_count,
|
||||
paid_revenue_sar=paid_revenue,
|
||||
upgrade_revenue_sar=upgrade_revenue,
|
||||
case_studies=case_studies,
|
||||
growth_os_subscribers=gros_subs,
|
||||
stalled_pilots=stalled,
|
||||
lost_pilots=lost,
|
||||
completion_rate=round(completed / total, 3) if total else 0.0,
|
||||
paid_conversion_rate=round(paid_count / total, 3) if total else 0.0,
|
||||
upgrade_conversion_rate=(
|
||||
round((gros_subs + case_studies) / completed, 3)
|
||||
if completed else 0.0
|
||||
),
|
||||
by_sector=by_sector,
|
||||
by_city=by_city,
|
||||
average_proof_pack_days=avg_proof_days,
|
||||
summary_ar=summary_ar,
|
||||
)
|
||||
653
dealix/docs/MASTER_STRATEGIC_PLAN.md
Normal file
653
dealix/docs/MASTER_STRATEGIC_PLAN.md
Normal file
@ -0,0 +1,653 @@
|
||||
# Dealix — Master Strategic Plan
|
||||
## من الى — من Pilot 499 إلى Saudi Revenue Execution OS الفئة المهيمنة
|
||||
|
||||
> **القاعدة الذهبية:** Dealix لا يبيع features. يبيع **نتائج إيرادية موثّقة**.
|
||||
> كل قرار في هذه الوثيقة مبني على هذا المبدأ.
|
||||
|
||||
---
|
||||
|
||||
## 0. التشخيص الاستراتيجي (Where We Stand — May 2026)
|
||||
|
||||
### نقاط القوة الحقيقية
|
||||
1. **Tech foundation عميقة**: 12 طبقة معمارية، 200+ endpoint، 791 اختبار، CI أخضر، approval-first من البنية لا من الـ wrapper.
|
||||
2. **Positioning محكم**: Saudi Revenue Execution OS — ليس CRM، ليس bot، ليس scraper. القوة في الوضوح.
|
||||
3. **Compliance built-in**: PDPL، WhatsApp opt-in، Safety Eval، Saudi Tone Eval، Trace Redactor، Patch Firewall — ميزة لا يعطيها HubSpot ولا Gong محلياً.
|
||||
4. **Service Tower productized**: 13+ خدمة، كل واحدة فيها workflow + proof + pricing + upsell.
|
||||
5. **6 service bundles** بـ pricing واضح من 499 ر.س إلى Custom.
|
||||
6. **Founder-Led Growth جاهز**: المؤسس عربي، يفهم السوق السعودي، يبيع بنفسه.
|
||||
|
||||
### الفجوات التي لازم تُسد قبل التوسع
|
||||
1. **0 paid customers**: المنتج جاهز، السوق غير مُختبَر بعد.
|
||||
2. **0 case studies**: لا proof خارجي للمشترين.
|
||||
3. **No pricing validation**: 499/2,999/etc. أرقام منطقية لكن غير مُختبَرة بـ A/B.
|
||||
4. **No retention data**: Growth OS Monthly = اشتراك، لكن لا churn data بعد.
|
||||
5. **No partner channel**: الوكالات هي الـ wedge الأقوى لكن لا اتفاقيات.
|
||||
6. **No content moat**: لا blog، لا newsletter، لا SEO/AEO رصيد.
|
||||
7. **No data moat**: قاعدة بيانات الفرص لم تتراكم بعد — كل عميل جديد يبدأ من صفر.
|
||||
|
||||
### الفرضية الاستراتيجية الكبرى
|
||||
> **الفائز في السوق السعودي للـ Revenue Execution هو من يبني أعمق Saudi Revenue Graph + أوسع شبكة وكالات قبل أن تقرر HubSpot/Salesforce/Gong الترجمة الفعلية للعربية.**
|
||||
>
|
||||
> النافذة الزمنية: **18–24 شهر**. بعدها، إما Dealix هو الـ default للـ B2B السعودي، أو يصبح niche tool.
|
||||
|
||||
---
|
||||
|
||||
## 1. النية النهائية (North Star — 36 شهراً)
|
||||
|
||||
```
|
||||
Year 1 (2026): Saudi Private Beta + Paid Beta + 50 paying customers + $300K ARR
|
||||
Year 2 (2027): Saudi GA + 500 paying customers + Agency Network 30 partners + $3M ARR
|
||||
Year 3 (2028): GCC expansion (UAE, Kuwait, Bahrain) + 2,000 customers + $15M ARR
|
||||
Year 4 (2029): Series A + MENA + Arabic LLM moat + $50M ARR target
|
||||
```
|
||||
|
||||
### Vision Statement (داخلي)
|
||||
> "أن يصبح Dealix الـ Operating System الذي تُدار به مبيعات وشراكات أي شركة سعودية تطمح للنمو، بحيث لا تستطيع HubSpot أو Salesforce المنافسة لأن Dealix يفهم السياق المحلي بعمق لا يستطيعون مجاراته."
|
||||
|
||||
### Mission Statement (خارجي)
|
||||
> "نحوّل بيانات وقنوات الشركات السعودية إلى فرص مدفوعة وشراكات موثّقة، بدون scraping، بدون رسائل عشوائية، بأمان PDPL تام، وبموافقتك على كل تواصل."
|
||||
|
||||
### الـ Anti-Mission (ما لا نفعله أبداً)
|
||||
- ❌ نضمن مبيعات.
|
||||
- ❌ نسحب بيانات LinkedIn.
|
||||
- ❌ نرسل WhatsApp بدون opt-in.
|
||||
- ❌ نخزّن credentials.
|
||||
- ❌ نسوّق على شاشات بناءً على casino-like dark patterns.
|
||||
- ❌ نشتغل بدون موافقة العميل على كل action خارجي.
|
||||
|
||||
---
|
||||
|
||||
## 2. Positioning Architecture (4 طبقات)
|
||||
|
||||
### الطبقة 1 — Category Positioning
|
||||
**Category:** Saudi Revenue Execution OS
|
||||
|
||||
**Definition:** "نظام تشغيل النمو والإيرادات للشركات السعودية، يدير الـ pipeline من اكتشاف الفرصة إلى Proof Pack، بأمان PDPL وبصوت سعودي."
|
||||
|
||||
**ما هو ليس:**
|
||||
- CRM (HubSpot, Salesforce, Zoho) — هؤلاء قاعدة بيانات.
|
||||
- WhatsApp tool (Wati, Twilio) — هؤلاء قنوات إرسال.
|
||||
- Lead scraper (Apollo, ZoomInfo) — هؤلاء scraping.
|
||||
- AI chatbot عام (ChatGPT, Claude) — هؤلاء يولّدون نص.
|
||||
- Agency تقليدية — هؤلاء عمل يدوي.
|
||||
|
||||
### الطبقة 2 — Audience Positioning (مَن نخدم)
|
||||
|
||||
| Segment | الحجم | الـ pain | الميزة لـ Dealix |
|
||||
|---------|------|---------|------------------|
|
||||
| **B2B SMBs السعودية** | 50K+ شركة | لا فريق مبيعات، لا CRM، إيرادات متذبذبة | يحلّ كل ذلك بـ 2,999 ر.س/شهر |
|
||||
| **Marketing Agencies** | 2K+ وكالة | يفقدون عملاء، Proof ضعيف، Manual | Dealix = Growth OS تبيعه باسم الوكالة |
|
||||
| **Training/Consulting Firms** | 3K+ شركة | بيع طويل، فرص نادرة | First 10 Opportunities Sprint = حل سريع |
|
||||
| **B2B SaaS سعودي** | 200+ شركة | sales velocity بطيء | Growth OS Monthly = velocity engine |
|
||||
| **Logistics/Construction/F&B** | 10K+ شركة | علاقات بشركات، لا outbound | Partnership Sprint = شبكة شراكات |
|
||||
|
||||
**ICP الحالي (Beta):** Marketing Agencies في الرياض/جدة (10–50 موظف). لماذا؟ لأنهم قناة توزيع، يفهمون قيمة Pilot، وعندهم عملاء جاهزون.
|
||||
|
||||
### الطبقة 3 — Problem Positioning (المشكلة كما يرونها هم)
|
||||
|
||||
**ليس:** "نحن نحتاج CRM"
|
||||
**بل:** "كل شهر نخسر فرص لأنه ما عندنا فريق نمو، والوكالة عندها claims غير مُثبتة، والـ AI tools تكتب رسائل لا تشبه السعودية، والـ WhatsApp tools تخاطر بـ ban، وما عندنا proof نريه للقيادة."
|
||||
|
||||
**Dealix كحل واحد لـ 6 مشاكل في وقت واحد**:
|
||||
1. لا فريق نمو ✅ → Autonomous Service Operator
|
||||
2. لا proof ✅ → Proof Pack أسبوعي
|
||||
3. رسائل غير سعودية ✅ → Saudi Tone Eval
|
||||
4. WhatsApp risk ✅ → opt-in audit + draft only
|
||||
5. لا ROI mapping ✅ → Revenue Work Units
|
||||
6. لا multi-channel ✅ → 11 connectors تحت سقف واحد
|
||||
|
||||
### الطبقة 4 — Pricing Positioning (Anchor Strategy)
|
||||
|
||||
```
|
||||
0 ر.س — Free Diagnostic (24h tease)
|
||||
499 — First 10 Opportunities Sprint (one-time wedge)
|
||||
1,500 — Data to Revenue (data-rich SMB)
|
||||
2,999/mo— Executive Growth OS (anchor — most-sold)
|
||||
3,000-7,500 — Partnership Growth (agency upsell)
|
||||
Custom — Full Growth Control Tower (enterprise)
|
||||
```
|
||||
|
||||
**القاعدة:** السعر الأساسي = **2,999 ر.س/شهر**. كل شيء آخر يُسوَّق كـ "بداية رخيصة" أو "حالة خاصة". هذا anchoring يجعل 499 يبدو هدية و2,999 يبدو معقول.
|
||||
|
||||
---
|
||||
|
||||
## 3. Go-To-Market Strategy (12 شهر)
|
||||
|
||||
### Phase 1 — Paid Beta Sprint (Months 1–3)
|
||||
**الهدف:** أول 10 paying customers + 3 case studies + 3 agency partners.
|
||||
|
||||
**القنوات (مرتبة حسب الأولوية):**
|
||||
|
||||
#### Channel 1 — Founder-Led Outbound (60% من الجهد)
|
||||
- 25 رسالة manual يومياً (LinkedIn DM يدوي + Email + WhatsApp opt-in).
|
||||
- Founder voice: المؤسس يبيع بنفسه. لا SDR. لا automation.
|
||||
- Cadence: 3 messages/prospect over 7 days (initial → value-add → final).
|
||||
- ICP: Agencies (10/day), Training (5/day), B2B SaaS (5/day), Local services (5/day).
|
||||
- KPI: 25 messages → 5 replies → 2 demos → 1 pilot → 1 paid (الأسبوع الأول هدف Realistic).
|
||||
|
||||
#### Channel 2 — Agency Partnership Program (25% من الجهد)
|
||||
- Pilot 1 لكل وكالة → case study → revenue share 20% on referrals.
|
||||
- Co-branded Proof Pack (الوكالة + Dealix logos).
|
||||
- Monthly partner scorecard.
|
||||
- KPI: 3 وكالات في 90 يوم → 9 sub-clients → 27% conversion to paid.
|
||||
|
||||
#### Channel 3 — Founder Content (10% من الجهد)
|
||||
- 1 LinkedIn post/day (founder voice، باللغة العربية).
|
||||
- 1 X (Twitter) post/day (نصائح تشغيلية، arabic).
|
||||
- Weekly newsletter (10 توصية لكل وكالة سعودية، arabic).
|
||||
- Long-form: 1 article/week (arabic) عن "كيف تشغّل النمو بدون فريق".
|
||||
- KPI: 500 followers → 10 inbound leads/شهر بنهاية Phase 1.
|
||||
|
||||
#### Channel 4 — Strategic PR (5% من الجهد)
|
||||
- Aim for: Asharq Business، Saudi Gazette، Wamda، Magnitt.
|
||||
- Story: "أول Saudi Revenue Execution OS — مؤسس سعودي يبني فئة جديدة".
|
||||
- Pitch بعد أول 5 paying customers (proof matters).
|
||||
|
||||
### Phase 2 — Pilot Expansion (Months 4–6)
|
||||
**الهدف:** 30 paying customers + Agency network 10 partners + $50K MRR.
|
||||
|
||||
- توسيع الـ outbound من 25/يوم إلى 50/يوم (مع SDR واحد part-time).
|
||||
- إطلاق Public landing pages بالعربية + الإنجليزية.
|
||||
- إطلاق "Dealix Academy" (محتوى تدريبي مجاني → leads).
|
||||
- بدء AEO/SEO استثمار جاد (Arabic-first).
|
||||
- إطلاق "Dealix Marketplace" (الوكالات تنشر عروضها).
|
||||
|
||||
### Phase 3 — GA + Series-A Prep (Months 7–12)
|
||||
**الهدف:** 200 paying customers + $300K ARR + Series A pitch ready.
|
||||
|
||||
- Self-serve onboarding (لا يحتاج demo).
|
||||
- API documentation pública.
|
||||
- Affiliate program (الوكالات تربح 30% recurring).
|
||||
- إطلاق Mobile app (PWA على الأقل).
|
||||
- Series A pitch deck + 18-month plan.
|
||||
|
||||
---
|
||||
|
||||
## 4. Sales Playbook (5 مراحل)
|
||||
|
||||
### Stage 1 — Prospecting
|
||||
**القناة الأساسية:** LinkedIn Sales Navigator (يدوي) + Apollo (lookup فقط، لا scraping) + Personal Network.
|
||||
|
||||
**ICP filters:**
|
||||
- Industry: Marketing Agency / B2B SaaS / Training / Consulting.
|
||||
- Size: 10–50 employees.
|
||||
- Location: SA (Riyadh/Jeddah/Dammam priority).
|
||||
- Title: Founder, CEO, Head of Growth, Head of Marketing, Head of Sales.
|
||||
- Signals: Hiring (growth/sales role), Series A funded, Recent product launch, LinkedIn activity.
|
||||
|
||||
**Output:** 100 prospects/أسبوع → Operating Board.
|
||||
|
||||
### Stage 2 — Qualification (BANT-Saudi)
|
||||
**B**udget: 499 SAR قادر؟ Pilot accessible. 2,999/mo قادر؟ Growth OS.
|
||||
**A**uthority: Founder/CEO أو Head of Growth/Sales/Marketing.
|
||||
**N**eed: محتاج فرص جديدة، أو عنده قائمة، أو يبحث عن شراكات.
|
||||
**T**iming: يدفع هذا الشهر؟ → MQL. هذا الربع؟ → Nurture.
|
||||
|
||||
**Output:** 25% من prospects → MQL.
|
||||
|
||||
### Stage 3 — Demo (12 دقيقة, Saudi-pace)
|
||||
**Structure (12 minutes total):**
|
||||
- 0–2: تعرّف (الاسم، الشركة، الـ pain).
|
||||
- 2–6: Show — 3 features حقيقية:
|
||||
1. Live Free Diagnostic (يأخذ 30 ثانية).
|
||||
2. Saudi Tone Eval على رسالة سيئة (يلوّن المشاكل).
|
||||
3. Approval flow على رسالة WhatsApp (يُظهر approval modal).
|
||||
- 6–9: Pricing — 5 bundles → 499 anchor → 2,999 anchor.
|
||||
- 9–12: قرار — "نبدأ Pilot 499 يوم الأحد؟" أو "أرسل لك Free Diagnostic أولاً؟"
|
||||
|
||||
**القاعدة:** لا تستخدم slides. استخدم المنتج الحي.
|
||||
|
||||
**Output:** 50% من demos → Pilot أو Free Diagnostic.
|
||||
|
||||
### Stage 4 — Pilot (7 أيام, $499)
|
||||
**Day 0 (T+0):** intake (15 دقيقة) → سجّل في Operating Board.
|
||||
**Day 1 (T+24):** Free Diagnostic سُلِّم (3 فرص + رسالة + مخاطرة + توصية).
|
||||
**Day 2 (T+48):** Pilot كامل (10 فرص + 10 رسائل + خطة متابعة).
|
||||
**Day 7:** Proof Pack نهائي + جلسة مراجعة 30 دقيقة + 3 upgrade paths.
|
||||
|
||||
**Output:** 70% من Pilots → Growth OS Monthly OR Case Study.
|
||||
|
||||
### Stage 5 — Expansion (Recurring)
|
||||
**Month 2:** Quarterly Business Review (QBR).
|
||||
**Month 3:** Cross-sell Partnership Sprint (3,000–7,500 ر.س).
|
||||
**Month 6:** Annual upgrade (Growth OS Pro, custom price).
|
||||
**Month 12:** Renewal + 15% expansion (more channels, more agents).
|
||||
|
||||
**KPIs:**
|
||||
- Net Revenue Retention (NRR) target: 130%.
|
||||
- Logo Retention target: 90%.
|
||||
- Time to First Proof Pack: ≤ 48h.
|
||||
|
||||
---
|
||||
|
||||
## 5. Customer Journey Map (8 مراحل)
|
||||
|
||||
```
|
||||
1. UNAWARE → 2. PROBLEM-AWARE → 3. SOLUTION-AWARE
|
||||
4. PRODUCT-AWARE → 5. ACTIVATED → 6. RETAINED
|
||||
7. EXPANDED → 8. ADVOCATE
|
||||
```
|
||||
|
||||
| Stage | Trigger | Channel | Asset | Conversion Goal |
|
||||
|-------|---------|---------|-------|-----------------|
|
||||
| 1. Unaware | LinkedIn impression | Founder content | Arabic post about pain | Click profile → 2 |
|
||||
| 2. Problem-aware | "أحتاج فرص" | Newsletter signup | Free Diagnostic CTA | Subscribe → 3 |
|
||||
| 3. Solution-aware | Visits dealix.sa | landing/companies.html | Demo video 12min | Book demo → 4 |
|
||||
| 4. Product-aware | Demo done | Live demo + landing | Pilot 499 offer | Pay 499 → 5 |
|
||||
| 5. Activated | Pilot paid | Onboarding flow | First Proof Pack | Approval rate ≥30% → 6 |
|
||||
| 6. Retained | Month 2 | QBR call | Growth OS subscription | Upgrade to 2,999/mo → 7 |
|
||||
| 7. Expanded | Month 3+ | CSM relationship | Partnership Sprint | +3,000 ر.س → 8 |
|
||||
| 8. Advocate | Month 6+ | Case study + referrals | Co-branded content | 1+ referral/quarter |
|
||||
|
||||
---
|
||||
|
||||
## 6. Competitive Moat Strategy (5 طبقات)
|
||||
|
||||
### Moat 1 — Data Moat (Saudi Revenue Graph)
|
||||
**كيف يبني:**
|
||||
- كل event من كل عميل (مع الموافقة) → Revenue Graph عام.
|
||||
- بعد 100 عميل، Dealix يعرف:
|
||||
- أي رسالة عربية تُحوِّل في قطاع X؟
|
||||
- أي قناة الأفضل لشركة Y بحجم Z؟
|
||||
- متى أفضل وقت للتواصل في رمضان؟
|
||||
- HubSpot/Salesforce لا يستطيعون بناء هذا — بياناتهم عالمية.
|
||||
|
||||
**Time to build:** 12 شهر.
|
||||
|
||||
### Moat 2 — Brand Moat (Saudi-First)
|
||||
**كيف يبني:**
|
||||
- Founder presence على LinkedIn/X بالعربية يومياً.
|
||||
- Saudi-only events (دورة "نمو السعودية" شهرية).
|
||||
- Saudi-only Customer Advisory Board.
|
||||
- اللغة، الـ examples، الـ tone — كله سعودي.
|
||||
- HubSpot/Salesforce محتواهم مترجم — Dealix محتواه مولود سعودي.
|
||||
|
||||
**Time to build:** 6 شهر.
|
||||
|
||||
### Moat 3 — Compliance Moat (PDPL Native)
|
||||
**كيف يبني:**
|
||||
- PDPL audit شهري.
|
||||
- DPA template جاهز لكل عميل.
|
||||
- Penetration test ربع سنوي.
|
||||
- ISO 27001 certification (Year 2).
|
||||
- HubSpot/Salesforce يجاهدون لـ GDPR — Dealix بُني لـ PDPL من اليوم الأول.
|
||||
|
||||
**Time to build:** 9 شهر.
|
||||
|
||||
### Moat 4 — Network Moat (Agency Channel)
|
||||
**كيف يبني:**
|
||||
- 30 وكالة شريكة بنهاية Year 2.
|
||||
- كل وكالة عندها 10–50 عميل.
|
||||
- Lock-in: الوكالة تربح 20% recurring → revenue share switching cost عالي.
|
||||
- HubSpot/Salesforce ليس عندهم agency program عربي.
|
||||
|
||||
**Time to build:** 18 شهر.
|
||||
|
||||
### Moat 5 — Distribution Moat (Operator Network)
|
||||
**كيف يبني:**
|
||||
- 1,000 "Dealix Operator" certified بنهاية Year 3.
|
||||
- Operators يبيعون Dealix كـ خدمة لعملائهم.
|
||||
- كل Operator يربح 30% recurring لمدة 2 سنوات.
|
||||
- يصبح Dealix "AWS لـ Saudi Sales".
|
||||
|
||||
**Time to build:** 30 شهر.
|
||||
|
||||
---
|
||||
|
||||
## 7. Pricing Strategy & Unit Economics
|
||||
|
||||
### Pricing Ladder (Final Form)
|
||||
|
||||
| Tier | Price | Target | Conversion | LTV/CAC |
|
||||
|------|-------|--------|------------|---------|
|
||||
| Free Diagnostic | 0 | Lead magnet | 100% (free) | — |
|
||||
| First 10 Sprint | 499 | Wedge | 60% from leads | LTV=499, CAC=200 → 2.5x |
|
||||
| Data to Revenue | 1,500 | Data-rich SMB | 30% from Pilots | LTV=1500, CAC=300 → 5x |
|
||||
| Growth OS Monthly | 2,999/mo | Anchor | 40% from Pilots | LTV=36K (12mo), CAC=600 → 60x |
|
||||
| Partnership Growth | 3,000–7,500 | Cross-sell | 20% from Growth OS | LTV=15K avg, CAC=300 → 50x |
|
||||
| Full Control Tower | Custom (15K+) | Enterprise | 5% from cohort | LTV=180K, CAC=2K → 90x |
|
||||
|
||||
### Unit Economics (Year 1 target)
|
||||
|
||||
```
|
||||
ARPU (blended): 1,800 ر.س/شهر
|
||||
Gross Margin: 82% (مع compute optimized)
|
||||
CAC (paid + organic): 600 ر.س
|
||||
CAC Payback: 4 months
|
||||
LTV (12-month avg): 21,600 ر.س
|
||||
LTV/CAC: 36x (HubSpot benchmark: 5-7x)
|
||||
Churn (logo): 8%/month → 30%/year (Year 1)
|
||||
→ target 15%/year (Year 2)
|
||||
NRR: 130% (with cross-sell)
|
||||
```
|
||||
|
||||
### Pricing Experimentation Plan
|
||||
- Month 1–3: Lock pricing. Measure conversion.
|
||||
- Month 4: A/B test 2,999 vs 2,499 vs 3,499 (cohort 30 each).
|
||||
- Month 7: Add annual plan (10× monthly = 16% discount → cash-flow boost).
|
||||
- Month 10: Add usage-based add-ons (extra connectors, extra agents).
|
||||
- Year 2: Move 60% to annual contracts.
|
||||
|
||||
---
|
||||
|
||||
## 8. Tech Roadmap (18 شهر)
|
||||
|
||||
### Q2 2026 (Now)
|
||||
✅ Tech foundation (12 layers, 791 tests, CI green)
|
||||
✅ Paid Beta operational layer
|
||||
⏳ Staging deployment + first 5 paying customers
|
||||
⏳ First 3 case studies
|
||||
|
||||
### Q3 2026
|
||||
- **Staging → Production**: Railway → AWS (PDPL-compliant region)
|
||||
- **Public Launch Gate module**: criteria check + automated graduation
|
||||
- **Pilot Tracker dashboard**: real-time view of all 5–10 pilots
|
||||
- **Saudi Arabic LLM tuning**: fine-tune on 1K Saudi business messages
|
||||
- **Email sequences engine**: 7-day drip per ICP
|
||||
|
||||
### Q4 2026
|
||||
- **Self-serve onboarding**: no-demo signup flow
|
||||
- **Mobile PWA**: iOS-installable
|
||||
- **Public API**: REST + webhooks
|
||||
- **Marketplace MVP**: agencies list services
|
||||
- **Stripe + Moyasar dual billing**
|
||||
|
||||
### Q1 2027
|
||||
- **Saudi Revenue Graph v1**: aggregated insights across all customers
|
||||
- **AI agents marketplace**: 3rd-party agents publish to Dealix
|
||||
- **GCC localization**: UAE, Kuwait, Bahrain
|
||||
- **Enterprise SSO**: Okta, Microsoft, Google
|
||||
|
||||
### Q2-Q4 2027
|
||||
- **Series A fundraise**: $5M target
|
||||
- **Hire VP Engineering, VP Sales, VP CS**
|
||||
- **Move to multi-region**: SA + UAE
|
||||
- **ISO 27001 certification**
|
||||
|
||||
---
|
||||
|
||||
## 9. Hiring Plan (Year 1 → Year 2)
|
||||
|
||||
### Month 1–6 (Founder-Led, 0 hires)
|
||||
- Founder = CEO + Sales + Engineering + Customer Success.
|
||||
- Outsource: Saudi Arabic copy editor (freelance, 1K/شهر).
|
||||
|
||||
### Month 7–12 (First 5 hires)
|
||||
1. **SDR (Saudi)**: outbound + qualification — 8K/شهر.
|
||||
2. **Customer Success Manager**: onboarding + retention — 12K/شهر.
|
||||
3. **Senior Backend Engineer**: scale APIs — 18K/شهر.
|
||||
4. **Senior Frontend/PWA Engineer**: web app — 15K/شهر.
|
||||
5. **Content Marketer (Arabic)**: SEO/AEO — 10K/شهر.
|
||||
|
||||
**Year 1 burn:** 250K SAR/شهر بنهاية Q4 → cash runway 18 months from $1M seed.
|
||||
|
||||
### Year 2 (Scale to 15 hires)
|
||||
6–8: Account Executives (3) — 12K/شهر/each.
|
||||
9–10: Engineers (2) — 16K/شهر/each.
|
||||
11: VP Engineering — 30K/شهر.
|
||||
12: VP Sales — 30K/شهر.
|
||||
13: Designer — 14K/شهر.
|
||||
14: Data Analyst — 12K/شهر.
|
||||
15: Recruiter (HR) — 10K/شهر.
|
||||
|
||||
---
|
||||
|
||||
## 10. Compliance & Risk Roadmap
|
||||
|
||||
### PDPL Compliance Timeline
|
||||
- Month 1: DPA template ✅
|
||||
- Month 3: Privacy policy v2 (Arabic + English)
|
||||
- Month 6: Annual PDPL audit (external)
|
||||
- Month 9: SDAIA registration (if data-sharing required)
|
||||
- Year 2: ISO 27001 certification
|
||||
- Year 3: SOC 2 Type II
|
||||
|
||||
### Risk Matrix (Top 5)
|
||||
|
||||
| Risk | Likelihood | Impact | Mitigation |
|
||||
|------|-----------|--------|-----------|
|
||||
| Data breach (PDPL fines up to 5M SAR) | Medium | Critical | Trace redaction + encrypted at rest + quarterly pen test |
|
||||
| WhatsApp account ban | Medium | High | opt-in audit + complaint rate < 0.3% + Meta Business verified |
|
||||
| Major customer churn (logo concentration) | Medium | High | No customer > 10% of revenue; sign 12-month contracts |
|
||||
| Founder burnout | High | Critical | Hire CSM by month 7, SDR by month 9 |
|
||||
| HubSpot/Salesforce launches Saudi-tuned product | Low | Critical | Build Saudi Revenue Graph + Agency Network = irreplaceable |
|
||||
|
||||
---
|
||||
|
||||
## 11. Marketing & Content Engine
|
||||
|
||||
### Content Pillars (4)
|
||||
1. **Saudi B2B Growth Tactics** (40% من المحتوى) — practical playbooks.
|
||||
2. **PDPL/Compliance Education** (20%) — كيف تتواصل آمناً.
|
||||
3. **Customer Stories / Case Studies** (20%) — proof.
|
||||
4. **Founder Journey** (20%) — building in public.
|
||||
|
||||
### Content Cadence
|
||||
- **Daily:** 1 LinkedIn post + 1 X post (Founder voice, Arabic).
|
||||
- **Weekly:** 1 long-form article (1,500 words, Arabic) + 1 newsletter.
|
||||
- **Bi-weekly:** 1 video (12-min demo or interview, Arabic).
|
||||
- **Monthly:** 1 case study + 1 webinar.
|
||||
- **Quarterly:** "State of Saudi Revenue" report (downloadable, lead magnet).
|
||||
|
||||
### SEO/AEO Strategy (Arabic-First)
|
||||
- **Primary keywords:** "زيادة المبيعات السعودية"، "نمو B2B سعودي"، "أداة CRM سعودية"، "تواصل واتساب أعمال".
|
||||
- **Long-tail:** "كيف أحصل على عملاء B2B في الرياض"، "أفضل أداة Pilot للوكالات السعودية".
|
||||
- **AEO (AI Engine Optimization):** Optimize for ChatGPT/Claude/Perplexity answers — structured Q&A with attribution.
|
||||
- **Goal Year 1:** Page 1 for top 20 Arabic B2B keywords.
|
||||
|
||||
---
|
||||
|
||||
## 12. Brand Identity Architecture
|
||||
|
||||
### Brand Voice
|
||||
- **Direct, not flowery.** "نطلع لك 10 فرص" not "نسعى جاهدين لتقديم".
|
||||
- **Confident, not arrogant.** "هذا ما يفعله Dealix" not "نحن الأفضل".
|
||||
- **Saudi, not Egyptian/Levantine.** "شلونك"، "تمام"، "ما يصلح".
|
||||
- **Data-led, not vague.** "499 ر.س = 10 فرص + 10 رسائل" not "حلول مخصصة".
|
||||
|
||||
### Brand Pillars
|
||||
1. **Local Mastery** — نفهم السعودية أعمق من أي أحد.
|
||||
2. **Approval-First** — كرامة العميل قبل الـ scale.
|
||||
3. **Proof Over Promise** — Proof Pack أسبوعي، لا claims.
|
||||
4. **Open by Design** — لا lock-in، API مفتوح.
|
||||
|
||||
### Visual Identity Direction
|
||||
- **Color:** Saudi Gold (#ffd166) + Deep Black (#0f1115) — حداثة + احترافية.
|
||||
- **Typography:** Tajawal for Arabic, Inter for English — readable + professional.
|
||||
- **Iconography:** Minimal line icons (Lucide) — لا cliché business clip-art.
|
||||
|
||||
---
|
||||
|
||||
## 13. Funding Strategy
|
||||
|
||||
### Seed Round ($1M target — Q4 2026)
|
||||
**Use of funds:**
|
||||
- Hires: 60% (5 hires × 6 months)
|
||||
- Infrastructure: 15%
|
||||
- Marketing/Content: 15%
|
||||
- Compliance/Audits: 5%
|
||||
- Buffer: 5%
|
||||
|
||||
**Investors to target:**
|
||||
- STV (Saudi Technology Ventures)
|
||||
- Wa'ed Ventures (Aramco)
|
||||
- Sanabil Investments (PIF subsidiary)
|
||||
- 500 Global MENA
|
||||
- Wamda Capital
|
||||
- Plus: angels من الـ Saudi B2B founder community.
|
||||
|
||||
**Pitch deck core slides (12):**
|
||||
1. Title — "The Saudi Revenue Execution OS"
|
||||
2. Problem — "Saudi B2B is 10 years behind in sales tech"
|
||||
3. Why now — "$50B Saudi Vision 2030 + AI moment"
|
||||
4. Solution — Live demo (no slides for this)
|
||||
5. Product — 12 layers + 200 endpoints + 791 tests
|
||||
6. Traction — first 10 paying customers + 3 case studies
|
||||
7. Market — TAM 50K SMBs × 36K SAR/year = $480M
|
||||
8. Business model — 6 bundles + Year 1 unit economics
|
||||
9. Competition — moat analysis (Section 6)
|
||||
10. Team — Founder bio + advisors
|
||||
11. Financials — 18-month projection
|
||||
12. Ask — $1M for 18 months runway
|
||||
|
||||
### Series A ($5M — Q4 2027)
|
||||
- Trigger: $1M ARR + 200 paying customers + 30 agency partners.
|
||||
- Use: GCC expansion + 10 more hires + Saudi Revenue Graph data infrastructure.
|
||||
|
||||
---
|
||||
|
||||
## 14. الـ 7-Day Sprint (الآن — اليوم 1 إلى اليوم 7)
|
||||
|
||||
### اليوم 1 (Today — May 1, 2026)
|
||||
- **AM:** Push 4 pending files (POST_MERGE_VERIFICATION + scorecard + tests + conftest).
|
||||
- **AM:** Deploy Railway staging.
|
||||
- **AM:** Add `STAGING_BASE_URL` secret to GitHub Actions.
|
||||
- **PM:** Run `launch_readiness_check.py --staging-url $STAGING_BASE_URL` → expect `PAID_BETA_READY`.
|
||||
- **PM:** Send 25 manual outreach (10 agencies + 5 training + 5 SaaS + 5 local).
|
||||
- **EOD:** Operating Board updated with all 25 prospects.
|
||||
|
||||
### اليوم 2
|
||||
- **AM:** Follow-up wave 1 (any replies from Day 1).
|
||||
- **AM:** Send 25 more outreach (different segments).
|
||||
- **PM:** First 1–2 demos.
|
||||
- **PM:** Send Free Diagnostic to first 1 interested prospect.
|
||||
- **EOD:** scorecard.py — expect 2+ replies, 1+ demo.
|
||||
|
||||
### اليوم 3
|
||||
- **AM:** Deliver first Free Diagnostic (T+24h SLA).
|
||||
- **AM:** 5 follow-ups + 5 new outreach.
|
||||
- **PM:** First Pilot 499 offer to most-engaged prospect.
|
||||
|
||||
### اليوم 4
|
||||
- **AM:** Pilot 499 sales call.
|
||||
- **AM:** Send Moyasar invoice manual.
|
||||
- **PM:** Send payment reminder + start Pilot delivery prep.
|
||||
- **EOD:** Target — 1 invoice paid OR 1 written commitment.
|
||||
|
||||
### اليوم 5 (Pilot Day 1)
|
||||
- **AM:** Receive intake from paid customer.
|
||||
- **AM:** Run First 10 Opportunities Sprint workflow.
|
||||
- **PM:** Generate 10 opportunities + 10 Arabic messages.
|
||||
- **EOD:** Send Approval Pack to customer.
|
||||
|
||||
### اليوم 6 (Pilot Day 2)
|
||||
- **AM:** Process customer approvals.
|
||||
- **AM:** Run follow-up sequence.
|
||||
- **PM:** First 1–2 positive replies.
|
||||
- **EOD:** ≥3 messages approved + Proof Pack v1 generated.
|
||||
|
||||
### اليوم 7 (Proof + Upsell)
|
||||
- **AM:** Deliver final Proof Pack.
|
||||
- **AM:** 30-minute review session call.
|
||||
- **PM:** Pitch Growth OS Monthly upgrade (2,999 ر.س/شهر).
|
||||
- **EOD:** Case study OR second Pilot OR Growth OS subscription.
|
||||
|
||||
**Week 1 Target:** 70 outreach / 15 replies / 7 demos / 3 pilots / 1–2 paid / 1 Proof Pack.
|
||||
|
||||
---
|
||||
|
||||
## 15. القرار النهائي — Three Numbers That Matter
|
||||
|
||||
```
|
||||
1. أول 499 ر.س — هذا الأسبوع (T+7 days max)
|
||||
2. أول 10 paid customers — هذا الربع (T+90 days max)
|
||||
3. أول $1M ARR — هذا العام (T+12 months max)
|
||||
```
|
||||
|
||||
كل قرار في Dealix يُقاس بهل يقرّب من هذه الأرقام أم لا.
|
||||
|
||||
أي شيء غير ذلك = تشتيت.
|
||||
|
||||
---
|
||||
|
||||
## ملحق A — قواعد لا تتنازل عنها (Hard Rules)
|
||||
|
||||
1. **لا live send بدون env flag + اعتماد بشري.**
|
||||
2. **لا scraping. لا auto-DM. لا cold WhatsApp.**
|
||||
3. **لا Moyasar API charge — invoice manual فقط حتى Year 2.**
|
||||
4. **لا claims مضمونة. كل promise معه qualifier ("ضمان استرداد 7 أيام").**
|
||||
5. **لا تشارك Operating Board مع أحد — يحتوي PII.**
|
||||
6. **لا تخفّض السعر بدون موافقة المؤسس.**
|
||||
7. **لا تتجاوز SLA — اعتذر بدل أن تتأخر.**
|
||||
8. **لا تضف feature بدون validation من 3 عملاء على الأقل.**
|
||||
9. **لا توظّف قبل أن يكون عندك CSM-load > 8 ساعات/يوم.**
|
||||
10. **لا تقبل investment بدون 18-month plan واضح.**
|
||||
|
||||
---
|
||||
|
||||
## ملحق B — 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
|
||||
|
||||
Public Launch (after this Master Plan):
|
||||
GET /api/v1/public-launch/gate-check
|
||||
GET /api/v1/public-launch/pilot-tracker
|
||||
POST /api/v1/public-launch/graduate-pilot
|
||||
GET /api/v1/public-launch/case-studies
|
||||
GET /api/v1/public-launch/agency-network
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ملحق C — Decision Trees
|
||||
|
||||
### "هل نقبل هذا العميل؟"
|
||||
```
|
||||
هل ICP match؟ (agency / B2B SMB / training / SaaS)
|
||||
├─ Yes
|
||||
│ ├─ هل authority? (Founder/Head)
|
||||
│ │ ├─ Yes → Pilot 499 offer
|
||||
│ │ └─ No → ask for intro to authority
|
||||
│ └─ هل budget? (499+)
|
||||
│ ├─ Yes → Pilot 499 offer
|
||||
│ └─ No → Free Diagnostic + nurture
|
||||
└─ No → polite decline + refer to network
|
||||
```
|
||||
|
||||
### "هل نطلق feature جديد؟"
|
||||
```
|
||||
هل عندنا 3 paying customers طلبوه؟
|
||||
├─ Yes
|
||||
│ ├─ هل service_score يرتفع به ≥80؟
|
||||
│ │ ├─ Yes → ابني (1-week sprint)
|
||||
│ │ └─ No → adjust scope حتى ≥80
|
||||
│ └─ هل يخالف Hard Rules؟
|
||||
│ ├─ Yes → reject
|
||||
│ └─ No → ابني
|
||||
└─ No → log في feature-backlog، لا تبني
|
||||
```
|
||||
|
||||
### "هل نوظّف هذا الشخص؟"
|
||||
```
|
||||
هل عندنا CSM-load > 8 ساعات/يوم؟
|
||||
├─ Yes
|
||||
│ ├─ هل cash > 6 months runway بعد التوظيف؟
|
||||
│ │ ├─ Yes → وظّف
|
||||
│ │ └─ No → وظّف part-time أو contractor
|
||||
│ └─ هل يأخذ من المؤسس مهمة عمرها > 4h/يوم؟
|
||||
│ ├─ Yes → وظّف
|
||||
│ └─ No → أجّل
|
||||
└─ No → أجّل
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## الخاتمة
|
||||
|
||||
**Dealix لا يفوز بأنه أكثر features.**
|
||||
**Dealix يفوز بأنه أعمق فهماً للسعودية + أوضح Proof + أصدق Approval-first + أعرف agency channel.**
|
||||
|
||||
**كل شيء في هذه الوثيقة يخدم هذا.**
|
||||
|
||||
**ابدأ الآن: ادفع 4 الملفات → نشر staging → 25 رسالة → أول 499 ر.س.**
|
||||
352
dealix/docs/PAID_BETA_FULL_RUNBOOK_AR.md
Normal file
352
dealix/docs/PAID_BETA_FULL_RUNBOOK_AR.md
Normal file
@ -0,0 +1,352 @@
|
||||
# Runbook واحد — من Private Beta جاهزة إلى أول Proof Pack
|
||||
|
||||
**الهدف ليس «نبني أكثر». الهدف:**
|
||||
|
||||
```text
|
||||
Private Beta جاهزة → Staging شغال → PAID_BETA_READY → أول عميل/التزام → Proof Pack → بعدها نقرر ماذا نبني
|
||||
```
|
||||
|
||||
**مواد جاهزة للتنفيذ اليومي:**
|
||||
Layer 13 (بوابة عامة) → [`PUBLIC_LAUNCH_READINESS.md`](PUBLIC_LAUNCH_READINESS.md)
|
||||
Layer 14 (بريد + battlecards + ديمو ١٢ دقيقة) → [`sales-kit/START_HERE.md`](sales-kit/START_HERE.md) (قسم Layer 14)
|
||||
|
||||
**مراجع تقنية:** [`POST_MERGE_VERIFICATION.md`](POST_MERGE_VERIFICATION.md) · [`BRANCH_PROTECTION_AND_CI.md`](BRANCH_PROTECTION_AND_CI.md) · [`STAGING_DEPLOYMENT.md`](STAGING_DEPLOYMENT.md) · [`ops/RAILWAY_AI_COMPANY_BIND.md`](ops/RAILWAY_AI_COMPANY_BIND.md)
|
||||
|
||||
---
|
||||
|
||||
## المرحلة A — إغلاق GitHub (حماية الفرع)
|
||||
|
||||
| الخطوة | ماذا تفعل |
|
||||
|--------|-----------|
|
||||
| A1 | على الريبو: **Settings → Branches → Add rule** للفرع المحمي (مثلاً `ai-company` أو `main` حسب سياسة شركتك). |
|
||||
| A2 | فعّل: **Require a pull request before merging**، **Require status checks to pass**، **Require branches to be up to date before merging**، **Require conversation resolution** (إن كان الفريق يستخدمها)، **Block force pushes**، **Block deletions**. |
|
||||
|
||||
**Checks المطلوبة (Dealix API CI):** اختر الأسماء **كما تظهر في واجهة GitHub** بعد أول تشغيل ناجح للـ workflow — عادة:
|
||||
|
||||
- `pytest`
|
||||
- `smoke_inprocess`
|
||||
- `launch_readiness`
|
||||
|
||||
إن ظهرت مُسبوقة باسم الـ workflow (مثل `Dealix API CI / pytest`)، اختر نفس الصيغة. إذا كان عندك check باسم `test` فقط من workflow آخر، **طابق ما يظهر عندك فعلاً** — لا تضف اسماً لا يُشغَّل على الـ PR. انظر أيضاً قسم «تفرّد أسماء الـ jobs» في [`BRANCH_PROTECTION_AND_CI.md`](BRANCH_PROTECTION_AND_CI.md).
|
||||
|
||||
**علامة نجاح A:**
|
||||
|
||||
```text
|
||||
الفرع المحمي لا يقبل merge بدون PR + checks خضراء
|
||||
لا force push ولا حذف للفرع المحمي
|
||||
```
|
||||
|
||||
مرجع GitHub: [Troubleshooting required status checks](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/troubleshooting-required-status-checks)
|
||||
|
||||
---
|
||||
|
||||
## المرحلة B — Railway Staging (رابط حقيقي)
|
||||
|
||||
| الخطوة | ماذا تفعل |
|
||||
|--------|-----------|
|
||||
| B1 | Railway: **New Project → Deploy from GitHub** → الريبو `VoXc2/system-prompts-and-models-of-ai-tools` → الفرع **`ai-company`** (أو فرع النشر المعتمد). |
|
||||
| B2 | **Service Root / Root Directory:** `dealix` (حزمة التطبيق). |
|
||||
| B3 | **Variables (ابدأ بآمنة، بدون live keys):** `APP_ENV=staging`، `WHATSAPP_ALLOW_LIVE_SEND=false`، `MOYASAR_MODE=sandbox`، `PYTHONUNBUFFERED=1` — وأي مفاتيح LLM/DB حسب [`go-to-market/railway_vars_template.txt`](go-to-market/railway_vars_template.txt) أو [`STAGING_DEPLOYMENT.md`](STAGING_DEPLOYMENT.md). |
|
||||
| B4 | **Start Command:** `uvicorn api.main:app --host 0.0.0.0 --port $PORT` |
|
||||
| B5 | **Healthcheck Path:** `/health` |
|
||||
|
||||
**علامة نجاح B:**
|
||||
|
||||
```text
|
||||
Deployment = Active
|
||||
GET /health → 200
|
||||
```
|
||||
|
||||
التطبيق يجب أن يستمع على `0.0.0.0` والمنفذ الذي يحقنه المضيف (مثل `$PORT` على Railway). مرجع: [Railway Healthchecks](https://docs.railway.com/reference/healthchecks)
|
||||
|
||||
---
|
||||
|
||||
## المرحلة C — فحص Staging من جهازك
|
||||
|
||||
بعد أن يكون لديك **Base URL** بدون شرطة مائلة أخيرة:
|
||||
|
||||
```bash
|
||||
cd dealix
|
||||
set STAGING_BASE_URL=https://YOUR-STAGING-URL.example # Windows PowerShell: $env:STAGING_BASE_URL="https://..."
|
||||
python scripts/smoke_staging.py --base-url "%STAGING_BASE_URL%" # أو: --base-url $env:STAGING_BASE_URL
|
||||
python scripts/launch_readiness_check.py --base-url "%STAGING_BASE_URL%"
|
||||
```
|
||||
|
||||
(Linux/macOS: `export STAGING_BASE_URL=...` ثم نفس الأوامر بدون `%`.)
|
||||
|
||||
إذا فرض الـ staging مفتاح API: عيّن `STAGING_API_KEY` (يُرسل كـ `X-API-Key`) — انظر تعليقات [`scripts/smoke_staging.py`](../scripts/smoke_staging.py).
|
||||
|
||||
**علامة نجاح C:**
|
||||
|
||||
```text
|
||||
smoke_staging.py ينتهي بنجاح (exit 0)
|
||||
launch_readiness_check.py → VERDICT: PAID_BETA_READY و exit 0
|
||||
```
|
||||
|
||||
**إذا ظهر NO_GO:** لا تبيع، لا رابط دفع، لا Pilot — عالج سبب الفشل (مسار، متغيرات، landing، إلخ) ثم أعد التشغيل.
|
||||
|
||||
---
|
||||
|
||||
## المرحلة D — GitHub Secret + Workflow
|
||||
|
||||
| الخطوة | ماذا تفعل |
|
||||
|--------|-----------|
|
||||
| D1 | **Settings → Secrets and variables → Actions → New repository secret** → `STAGING_BASE_URL` = `https://your-staging-host` (بدون `/` زائدة في النهاية إن أمكن). |
|
||||
| D2 | **Actions → Dealix staging smoke → Run workflow** (يدوي `workflow_dispatch`). |
|
||||
|
||||
الـ workflow يشغّل [`dealix-staging-smoke.yml`](../../.github/workflows/dealix-staging-smoke.yml): `smoke_staging.py` ثم `launch_readiness_check.py --base-url "$STAGING_BASE_URL"`.
|
||||
|
||||
**علامة نجاح D:**
|
||||
|
||||
```text
|
||||
Workflow أخضر عندما يكون STAGING_BASE_URL مضبوطاً
|
||||
نفس PAID_BETA_READY من CI كما من جهازك
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## المرحلة E — Moyasar (أول دخل بدون Billing API كامل)
|
||||
|
||||
| الخطوة | ماذا تفعل |
|
||||
|--------|-----------|
|
||||
| E1 | من **Moyasar Dashboard**: إنشاء **Invoice** — المبلغ **499 SAR**، وصف واضح (مثلاً: Dealix Private Beta Pilot — 7 days)، صلاحية مناسبة (مثلاً 7 أيام). |
|
||||
| E2 | أرسل رابط الدفع عبر قناة موثوقة (إيميل أو رسالة **يدوية** مع opt-in). |
|
||||
|
||||
**ملاحظة وحدات API (للمستقبل):** في API غالباً المبلغ بالهللات؛ 499 ريال = `49900` هللة. راجع وثائق Moyasar الرسمية عند الربط البرمجي. مرجع مساعد: [Moyasar Dashboard: Invoice](https://help.moyasar.com/en/article/moyasar-dashboard-invoice-rf3kyd/)
|
||||
|
||||
**نص جاهز للعميل (مقتبس — عدّل حسب سياسة شركتك):**
|
||||
|
||||
```text
|
||||
تمام، نبدأ Pilot لمدة 7 أيام بـ 499 ريال.
|
||||
يشمل: 10 فرص مناسبة، رسائل عربية جاهزة للمراجعة، فحص مخاطر القنوات، خطة متابعة 7 أيام، Proof Pack مختصر.
|
||||
بعد الدفع أحتاج: رابط الموقع، القطاع، المدينة، العرض الرئيسي، وصف العميل المثالي.
|
||||
```
|
||||
|
||||
**علامة نجاح E:**
|
||||
|
||||
```text
|
||||
فاتورة/رابط دفع جاهز + عميل استلم الرابط
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## المرحلة F — مبيعات اليوم (تنفيذ يدوي آمن)
|
||||
|
||||
**هدف يوم واحد:**
|
||||
|
||||
```text
|
||||
25 تواصل يدوي
|
||||
5 follow-ups
|
||||
1 منشور LinkedIn + 1 منشور X (أو منصة واحدة إن كان الوقت ضيقاً)
|
||||
1 محادثة شريك
|
||||
1 محاولة حجز ديمو
|
||||
```
|
||||
|
||||
**قواعد:** لا scraping، لا auto-DM، لا واتساب بارد جماعي. التزم بسياسة المنصات — مثلاً LinkedIn يحدّ من برمجيات الالتقاط والإرسال غير الأصيل. مرجع: [LinkedIn — prohibited software and extensions](https://www.linkedin.com/help/linkedin/answer/a1341387/prohibited-software-and-extensions)
|
||||
|
||||
**تقسيم الـ 25:**
|
||||
|
||||
```text
|
||||
10 وكالات B2B / مسوقين
|
||||
5 شركات تدريب
|
||||
5 B2B SaaS أو خدمات تقنية
|
||||
5 خدمات محلية
|
||||
```
|
||||
|
||||
**قوالب مختصرة** (طوّرها من [`sales-kit/layer14_email_sequences_4x7_ar.md`](sales-kit/layer14_email_sequences_4x7_ar.md)):
|
||||
|
||||
- **وكالة:** Beta محدودة + Pilot مشترك على عميل حقيقي + ديمو 15 دقيقة؟
|
||||
- **شركة:** 10 فرص + رسائل عربية + موافقة قبل أي تواصل + Proof Pack + Diagnostic مجاني؟
|
||||
|
||||
**Follow-up مقترح:** عينة صغيرة (3 فرص + رسالة واحدة + قناة) بدل ديمو كامل إن احتجت تخفيف الاحتكاك.
|
||||
|
||||
**علامة نجاح F:**
|
||||
|
||||
```text
|
||||
25 لمسة مُسجّلة في الـ Operating Board (انظر المرحلة G)
|
||||
0 إجراءات غير آمنة (لا live send بدون موافقة وسياسة)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## المرحلة G — Operating Board (جدول تتبّع)
|
||||
|
||||
1. أنشئ Google Sheet: **`Dealix Paid Beta Operating Board`**.
|
||||
2. الصف الأول (عناوين أعمدة):
|
||||
|
||||
```text
|
||||
company,person,segment,channel,message_sent_at,reply_status,demo_booked,diagnostic_sent,pilot_offered,invoice_sent,paid_or_commitment,proof_pack_sent,next_step,notes
|
||||
```
|
||||
|
||||
3. نهاية اليوم — سجل الأرقام في **Daily Scorecard** (من مجلد `dealix`):
|
||||
|
||||
```bash
|
||||
python scripts/paid_beta_daily_scorecard.py --messages 25 --replies 0 --demos 0 --pilots 0 --payments 0 --proof-packs 0
|
||||
```
|
||||
|
||||
مع نتائج فعلية (مثال):
|
||||
|
||||
```bash
|
||||
python scripts/paid_beta_daily_scorecard.py --messages 25 --replies 4 --demos 2 --pilots 1 --payments 1 --proof-packs 0 --json
|
||||
```
|
||||
|
||||
**يوم جيد (مؤشرات تقريبية):**
|
||||
|
||||
```text
|
||||
25 messages
|
||||
3–5 replies
|
||||
1–2 demos
|
||||
1 pilot offered
|
||||
0 unsafe actions
|
||||
```
|
||||
|
||||
**علامة نجاح G:** الصفوف مكتملة + scorecard يعكس الواقع.
|
||||
|
||||
---
|
||||
|
||||
## المرحلة H — ديمو ١٢ دقيقة (خط زمني للمكالمة)
|
||||
|
||||
| الوقت | ماذا تقول / تعرض |
|
||||
|--------|-------------------|
|
||||
| 0–2 | المشكلة: بيانات وقنوات لكن لا وضوح في من + ماذا + متى + كيف تُثبت النتيجة. |
|
||||
| 2–4 | Dealix: هدف نمو → خدمة واضحة → فرص، رسائل، موافقات، متابعة، Proof. |
|
||||
| 4–7 | ثلاث خدمات فقط كأمثلة: First 10 Opportunities، List Intelligence، Growth OS Pilot (اضبط الأسماء مع كتالوجكم). |
|
||||
| 7–9 | لا واتساب بارد، لا سحب LinkedIn، لا live بدون موافقة — draft وapproval-first. |
|
||||
| 9–11 | Pilot 7 أيام بـ 499 ريال (أو العرض المعتمد عندكم). |
|
||||
| 11–12 | «تبغى رابط الدفع ونبدأ اليوم؟» |
|
||||
|
||||
**سكربت مفصّل + اعتراضات:** [`sales-kit/layer14_demo_12min_script_ar.md`](sales-kit/layer14_demo_12min_script_ar.md) · جدول الدقائق: [`DEMO_SCRIPT_12_MINUTES.md`](DEMO_SCRIPT_12_MINUTES.md)
|
||||
|
||||
---
|
||||
|
||||
## المرحلة I — أول Pilot خلال ٤٨ ساعة
|
||||
|
||||
### أول ٣٠ دقيقة — Intake (اطلب)
|
||||
|
||||
```text
|
||||
company_name, website, sector, city, offer, ideal_customer, average_deal_value,
|
||||
has_contact_list, preferred_channels, current_sales_process
|
||||
```
|
||||
|
||||
### خلال ٢٤ ساعة — Diagnostic (سلّم)
|
||||
|
||||
```text
|
||||
3 فرص، 1 رسالة عربية، 1 مخاطرة، 1 توصية خدمة
|
||||
```
|
||||
|
||||
### خلال ٤٨ ساعة — Pilot ٤٩٩ (سلّم)
|
||||
|
||||
```text
|
||||
10 فرص، why-now لكل فرصة، صاحب قرار محتمل، قناة مقترحة، رسالة عربية،
|
||||
مخاطرة/contactability، خطة متابعة 7 أيام، Proof Pack مختصر
|
||||
```
|
||||
|
||||
**علامة نجاح I:** عميل استلم Diagnostic ثم حزمة Pilot ضمن الإطار الزمني المتفق عليه.
|
||||
|
||||
---
|
||||
|
||||
## المرحلة J — Proof Pack (هيكل التقرير)
|
||||
|
||||
```text
|
||||
Dealix Proof Pack — Week 1
|
||||
|
||||
Client:
|
||||
Service:
|
||||
Period:
|
||||
|
||||
1. What was created
|
||||
- opportunities_created:
|
||||
- drafts_created:
|
||||
- followups_created:
|
||||
|
||||
2. What was protected
|
||||
- risks_blocked:
|
||||
- unsafe_channels_avoided:
|
||||
|
||||
3. What needs approval
|
||||
- approvals_needed:
|
||||
- recommended_next_actions:
|
||||
|
||||
4. Revenue impact estimate
|
||||
- potential_pipeline_sar:
|
||||
- confidence:
|
||||
|
||||
5. Next step
|
||||
- upgrade recommendation:
|
||||
```
|
||||
|
||||
**رسالة تسليم مختصرة:** ملخص النقاط الأربع (فرص، رسائل، مخاطر ممنوعة، قناة، توصية تالية) + عرض ترقية منطقي إن وُجد.
|
||||
|
||||
**علامة نجاح J:** عميل استلم Proof Pack **مكتوباً ومُرسلاً** ويمكنه إعادة توجيهه داخل شركته.
|
||||
|
||||
---
|
||||
|
||||
## المرحلة K — بعد أول Pilot
|
||||
|
||||
| الحالة | ماذا تعرض / تسأل |
|
||||
|--------|------------------|
|
||||
| دفع + رضا | Growth OS شهري (مثلاً 2,999 ريال) — حدّد البنود مع كتالوج الخدمات والـ SLA. |
|
||||
| لم يدفع | سؤال واحد: «هل المشكلة السعر، التوقيت، الثقة، أم وضوح القيمة؟» — **لا تبنِ ميزة جديدة** قبل فهم السبب. |
|
||||
| وكالة مهتمة | Agency Partner Pilot: عميل واحد من طرفهم، Proof Pack بشعار مشترك، تقسيم ربح / referral. |
|
||||
|
||||
---
|
||||
|
||||
## المرحلة L — متى تبني كود جديد؟
|
||||
|
||||
فقط إذا تحقق **واحد** مما يلي:
|
||||
|
||||
```text
|
||||
عميل مدفوع طلب نفس الشيء مرتين
|
||||
3 pilots تعثروا لنفس السبب
|
||||
التشغيل اليدوي يستهلك وقتاً واضحاً
|
||||
Proof Pack يحتاج أتمتة لتسليم أسرع
|
||||
Staging فشل بسبب bug حقيقي وليس إعداداً فقط
|
||||
```
|
||||
|
||||
**قواعد الـ PR:** صغير، اختبار واضح، لا تغيير ضخم، لا «ميزة عامة» بدون طلب متكرر.
|
||||
|
||||
---
|
||||
|
||||
## تعريف «الإغلاق الكامل»
|
||||
|
||||
### تقني + تشغيلي
|
||||
|
||||
```text
|
||||
GitHub: فرع محمي + checks مطلوبة
|
||||
Railway staging: Active + /health = 200
|
||||
PAID_BETA_READY من launch_readiness_check على staging
|
||||
Staging smoke workflow أخضر (عند ضبط STAGING_BASE_URL)
|
||||
```
|
||||
|
||||
### تجاري (Paid Beta «حقيقية»)
|
||||
|
||||
```text
|
||||
PAID_BETA_READY
|
||||
+ أول دفع أو commitment واضح
|
||||
+ أول Proof Pack مُسلَّم للعميل
|
||||
```
|
||||
|
||||
### حزمة يوم التنفيذ (مواد جاهزة)
|
||||
|
||||
```text
|
||||
25 outreach + Operating Board + scorecard
|
||||
ديمو 12 دقيقة (سكربت Layer 14)
|
||||
تسلسلات بريد + battlecards (Layer 14)
|
||||
Moyasar invoice جاهز للإرسال
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## خريطة سريعة: أين الملف؟
|
||||
|
||||
| موضوع | ملف |
|
||||
|--------|------|
|
||||
| تحقق بعد الدمج محلياً | [`POST_MERGE_VERIFICATION.md`](POST_MERGE_VERIFICATION.md) |
|
||||
| حماية الفرع وأسماء الـ CI jobs | [`BRANCH_PROTECTION_AND_CI.md`](BRANCH_PROTECTION_AND_CI.md) |
|
||||
| Railway + ربط الريبو | [`ops/RAILWAY_AI_COMPANY_BIND.md`](ops/RAILWAY_AI_COMPANY_BIND.md) |
|
||||
| بوابة Public Launch (Layer 13) | [`PUBLIC_LAUNCH_READINESS.md`](PUBLIC_LAUNCH_READINESS.md) |
|
||||
| بريد 4×7 + battlecards + ديمو | [`sales-kit/START_HERE.md`](sales-kit/START_HERE.md) |
|
||||
|
||||
---
|
||||
|
||||
*آخر تحديث للهيكل: 2026-05-01 — طابق الأوامر مع نسخة السكربتات في الريبو عند التنفيذ.*
|
||||
@ -21,6 +21,8 @@ python scripts/smoke_inprocess.py
|
||||
|
||||
**بوابة الإطلاق:** بعد الدمج، شغّل أيضاً `scripts/smoke_staging.py` على staging مع `STAGING_BASE_URL` — انظر [`LAUNCH_DAY_RUNBOOK_AR.md`](LAUNCH_DAY_RUNBOOK_AR.md).
|
||||
|
||||
**Runbook تنفيذ كامل (GitHub → Railway → PAID_BETA_READY → أول عميل → Proof Pack):** [`PAID_BETA_FULL_RUNBOOK_AR.md`](PAID_BETA_FULL_RUNBOOK_AR.md).
|
||||
|
||||
Optional secret-pattern scan (adapt to your environment):
|
||||
|
||||
```bash
|
||||
@ -44,17 +46,38 @@ rg "ghp_|github_pat_|sk_live_" --glob '!htmlcov/**' --glob '!.venv/**'
|
||||
|
||||
## Last recorded run (workspace snapshot)
|
||||
|
||||
### Snapshot A — قبل الدمج (للمرجع)
|
||||
|
||||
| Step | Result |
|
||||
|------|--------|
|
||||
| Git HEAD | `16e8ba2` on branch `ai-company` (re-run on `main` after merge) |
|
||||
| compileall | OK (`api`, `auto_client_acquisition`, `db`, `core`) |
|
||||
| pytest | `652 passed`, `6 skipped`, `0 failed` (`APP_ENV=test`, dummy LLM keys) — 2026-05-01 بعد `launch_readiness` + تكامل الواجهات؛ أعد التشغيل بعد الدمج |
|
||||
|
||||
### Snapshot B — على default branch بعد الدمج (الأحدث · 2026-05-01 محلياً)
|
||||
|
||||
| Step | Result |
|
||||
|------|--------|
|
||||
| Git HEAD | `41ca592` (re-run after merge on your default branch) |
|
||||
| compileall | OK (`api`, `auto_client_acquisition`, `integrations`, `db`, `core`) |
|
||||
| pytest | `791 passed`, `6 skipped`, `0 failed` (`APP_ENV=test`, `--no-cov`) — 6 skipped: E2E يحتاج سيرفر على `8001`، مزوّدون اختياريون بدون مفاتيح |
|
||||
| `print_routes.py` | `ROUTE_CHECK_OK no duplicate method+path` |
|
||||
| `smoke_inprocess.py` | `SMOKE_INPROCESS_OK` (يشمل `GET /api/v1/revenue-launch/offer` و`GET /api/v1/revenue-launch/offer?lang=en`) |
|
||||
| `launch_readiness_check.py` | `VERDICT: GO_PRIVATE_BETA`، exit `0` — يفحص محلياً: `/health`، customer-ops (checklist/sla/connectors)، `services/catalog` (حقول التسعير وProof لكل خدمة)، `launch/private-beta/offer`، `security-curator/demo`، ملفات `landing/companies|marketers|private-beta.html`، و`WHATSAPP_ALLOW_LIVE_SEND=false`. مع `--base-url` أو `STAGING_BASE_URL`: نفس المسارات عن بُعد → `PAID_BETA_READY` إذا نجحت كلها؛ وإلا `NO_GO`. اختياري: `--secrets` لفحص أنماط تسرّب شائعة. `--json` لمخرجات آلة |
|
||||
| `launch_readiness_check.py` | `VERDICT: GO_PRIVATE_BETA`، exit `0` — يفحص محلياً: `/health`، customer-ops (checklist/sla/connectors)، `services/catalog` (حقول التسعير وProof لكل خدمة)، `launch/private-beta/offer`، `security-curator/demo`، ملفات `landing/companies\|marketers\|private-beta.html`، و`WHATSAPP_ALLOW_LIVE_SEND=false`. مع `--base-url` أو `STAGING_BASE_URL`: نفس المسارات عن بُعد → `PAID_BETA_READY` إذا نجحت كلها؛ وإلا `NO_GO`. اختياري: `--secrets` لفحص أنماط تسرّب شائعة. `--json` لمخرجات آلة |
|
||||
| Secret-pattern scan | `ghp_` / `github_pat_` / `sk_live_` — التطابقات الظاهرة في الريبو هي وثائق تشغيل، أمثلة اختبار، أو regex للكشف؛ ليست بالضرورة تسريباً. راجع `docs/ops/*` دورياً |
|
||||
| `smoke_staging.py` | يتطلب `STAGING_BASE_URL` — يشمل الآن `…/revenue-launch/offer?lang=en`؛ شغّله على الاستضافة الفعلية قبل أول عميل |
|
||||
| Frontend + EN + `?lang=en` | وثّق في [`FRONTEND_AND_API_MAP.md`](FRONTEND_AND_API_MAP.md) — أعد `pytest` بعد أي تغيير على `revenue_launch` |
|
||||
|
||||
### Verified-from-clone re-run (2026-05-01, sandbox clone of `sync/dealix-full-complete` @ `41ca592`)
|
||||
|
||||
| Step | Result |
|
||||
|------|--------|
|
||||
| compileall (`api`, `auto_client_acquisition`, `integrations`, `db`, `core`) | OK |
|
||||
| pytest -q --no-cov (`APP_ENV=test`) | `779 passed`, `6 skipped` — يطابق Snapshot B بـ 12 اختباراً أقل؛ السبب: الـ12 المضافة تأتي من ملفات `tests/test_paid_beta_daily_scorecard.py` المحدّثة محلياً غير المرفوعة |
|
||||
| `print_routes.py` | `ROUTE_CHECK_OK no duplicate method+path` |
|
||||
| `smoke_inprocess.py` | `SMOKE_INPROCESS_OK` |
|
||||
| `launch_readiness_check.py` | `VERDICT: GO_PRIVATE_BETA` |
|
||||
|
||||
## CI
|
||||
|
||||
Confirm GitHub Actions workflow [`.github/workflows/dealix-api-ci.yml`](../../.github/workflows/dealix-api-ci.yml) is green on the merged commit (jobs: `pytest`, `smoke_inprocess`, `launch_readiness`). لإعداد **branch protection** وأسماء الـ checks: [`BRANCH_PROTECTION_AND_CI.md`](BRANCH_PROTECTION_AND_CI.md).
|
||||
|
||||
214
dealix/docs/PUBLIC_LAUNCH_READINESS.md
Normal file
214
dealix/docs/PUBLIC_LAUNCH_READINESS.md
Normal file
@ -0,0 +1,214 @@
|
||||
# Public Launch Readiness — Layer 13
|
||||
|
||||
> **القاعدة:** الانتقال من Paid Beta إلى Public Launch لا يتم بناءً على رغبة المؤسس. يتم بناءً على 9 معايير deterministic، PDPL compliance، وBrand Moat Score. كل قرار قابل للتدقيق.
|
||||
|
||||
---
|
||||
|
||||
## 1. الـ 9 معايير
|
||||
|
||||
| # | Key | الحد الأدنى | كيف يُقاس |
|
||||
|---|-----|------------|----------|
|
||||
| 1 | `pilots_completed` | ≥5 | عدد Pilots سُلّم لها Proof Pack نهائي خلال 7 أيام |
|
||||
| 2 | `paid_customers` | ≥2 | عملاء دفعوا Moyasar أو وقّعوا Growth OS |
|
||||
| 3 | `unsafe_sends` | =0 | live actions بدون موافقة في Action Ledger |
|
||||
| 4 | `proof_cadence_weeks` | ≥3 متتالية | أسابيع متتالية صدر فيها Proof Pack |
|
||||
| 5 | `support_first_response_minutes_p1` | ≤120 | متوسط استجابة P1 |
|
||||
| 6 | `funnel_visible` | =True | lead→demo→pilot→paid قابل للقياس |
|
||||
| 7 | `staging_uptime_days` | ≥14 | أيام متتالية بـ uptime ≥99% |
|
||||
| 8 | `billing_webhook_verified` | =True | Moyasar webhook signed وتم التحقق |
|
||||
| 9 | `legal_complete` | =True | Terms + Privacy + DPA منشورة باللغتين |
|
||||
|
||||
---
|
||||
|
||||
## 2. القرار الناتج
|
||||
|
||||
```
|
||||
GO_PUBLIC_LAUNCH — كل المعايير الـ9 متحققة → ابدأ Public Launch
|
||||
NO_GO — معيار أو أكثر فشل (لكن ليس unsafe_sends)
|
||||
BLOCKED — unsafe_sends > 0 (Hard block — incident SEV1 أولاً)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. الـ Endpoints
|
||||
|
||||
```
|
||||
GET /api/v1/public-launch/criteria — قائمة الـ 9 معايير
|
||||
POST /api/v1/public-launch/gate-check — تقييم gate من state
|
||||
POST /api/v1/public-launch/pilot-tracker — ملخص Pilots
|
||||
POST /api/v1/public-launch/pdpl-compliance — PDPL audit
|
||||
POST /api/v1/public-launch/brand-moat — Brand Moat Score
|
||||
GET /api/v1/public-launch/demo — مثال شامل
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. مثال استدعاء `gate-check`
|
||||
|
||||
```bash
|
||||
curl -X POST https://api.dealix.me/api/v1/public-launch/gate-check \
|
||||
-H 'Content-Type: application/json' \
|
||||
-d '{
|
||||
"state": {
|
||||
"pilots_completed": 7,
|
||||
"paid_customers": 3,
|
||||
"unsafe_sends": 0,
|
||||
"proof_cadence_weeks": 4,
|
||||
"support_first_response_minutes_p1": 60,
|
||||
"funnel_visible": true,
|
||||
"staging_uptime_days": 21,
|
||||
"billing_webhook_verified": true,
|
||||
"legal_complete": true
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
النتيجة:
|
||||
|
||||
```json
|
||||
{
|
||||
"decision": "GO_PUBLIC_LAUNCH",
|
||||
"score_passed": 9,
|
||||
"score_total": 9,
|
||||
"blockers": [],
|
||||
"next_actions_ar": [],
|
||||
"summary_ar": "✅ جاهز للإطلاق العام — كل المعايير الـ9 متحققة..."
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. PDPL Compliance Check (10 فحوصات)
|
||||
|
||||
| Severity | Check | لماذا critical |
|
||||
|----------|-------|---------------|
|
||||
| critical | `data_residency_saudi` | PDPL يلزم بالـ Saudi region |
|
||||
| critical | `whatsapp_opt_in_audit` | عقوبات Meta + PDPL |
|
||||
| critical | `breach_notification_72h_ready` | غرامة PDPL 5M ر.س |
|
||||
| critical | `privacy_policy_bilingual` | حق العميل بالإطلاع |
|
||||
| critical | `trace_redaction_active` | منع تسريب PII في logs |
|
||||
| high | `email_opt_in_audit` | تجنب blacklist |
|
||||
| high | `dpa_template_published` | عقد DPA لكل عميل |
|
||||
| high | `data_retention_policy` | حذف 90 يوم |
|
||||
| high | `action_ledger_audit` | accountability |
|
||||
| medium | `consent_revocation_path` | حق العميل بإلغاء opt-in |
|
||||
|
||||
أي critical فاشل → `non_compliant` → **لا انتقال إلى Public Launch**.
|
||||
|
||||
---
|
||||
|
||||
## 6. Brand Moat Score (5 طبقات)
|
||||
|
||||
| Dimension | Weight | الحد الأدنى لـ "defensible" |
|
||||
|-----------|-------:|---------------------------|
|
||||
| Data Moat (Saudi Revenue Graph) | 30% | 1,000 events + 10 sectors |
|
||||
| Brand Moat (Saudi-First) | 20% | 5K LinkedIn + 1K newsletter |
|
||||
| Compliance Moat (PDPL Native) | 20% | 100% PDPL + ISO 27001 progress |
|
||||
| Network Moat (Agency Channel) | 20% | 30 agency partners |
|
||||
| Distribution Moat (Operator Network) | 10% | 100 certified operators |
|
||||
|
||||
```
|
||||
overall ≥ 80 → dominant (Series-A ready)
|
||||
overall ≥ 60 → defensible (GCC expansion ready)
|
||||
overall ≥ 35 → emerging (build phase)
|
||||
overall < 35 → fragile (focus on weakest)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Pilot Tracker
|
||||
|
||||
كل Pilot يمر بـ 8 stages:
|
||||
```
|
||||
intake → diagnostic_sent → pilot_delivered → proof_pack_sent
|
||||
→ upgrade_decided → completed | stalled | lost
|
||||
```
|
||||
|
||||
Upgrade outcomes (6):
|
||||
```
|
||||
growth_os_monthly | partnership_growth | case_study
|
||||
| second_pilot | no_upgrade | ghost
|
||||
```
|
||||
|
||||
API يحسب:
|
||||
- `total_pilots`, `completed_pilots`, `proof_packs_delivered`
|
||||
- `paid_pilots`, `paid_revenue_sar`, `upgrade_revenue_sar`
|
||||
- `case_studies`, `growth_os_subscribers`
|
||||
- `completion_rate`, `paid_conversion_rate`, `upgrade_conversion_rate`
|
||||
- `by_sector`, `by_city`
|
||||
- `average_proof_pack_days`
|
||||
|
||||
---
|
||||
|
||||
## 8. كيف تستخدمه عملياً
|
||||
|
||||
### يومياً (في الـ Founder Brief)
|
||||
```bash
|
||||
curl https://api.dealix.me/api/v1/public-launch/demo
|
||||
```
|
||||
|
||||
تشاهد:
|
||||
- Gate score الحالي
|
||||
- Pilots summary
|
||||
- PDPL status
|
||||
- Brand Moat tier
|
||||
|
||||
### أسبوعياً (في الـ Weekly Strategic Review)
|
||||
1. حدّث state بأرقام الأسبوع.
|
||||
2. شغّل `gate-check` + `pdpl-compliance` + `brand-moat`.
|
||||
3. ركّز على أضعف dimension في Brand Moat.
|
||||
4. أصلح أي critical في PDPL.
|
||||
|
||||
### قبل الانتقال إلى Public Launch
|
||||
1. `gate-check` يجب يرجع `GO_PUBLIC_LAUNCH`.
|
||||
2. `pdpl-compliance` يجب يرجع `compliant` (لا critical/high).
|
||||
3. `brand-moat` يجب يكون ≥ `defensible` (60+).
|
||||
4. أرسل تقرير شامل للـ founder + advisors.
|
||||
5. حضّر launch announcement.
|
||||
|
||||
---
|
||||
|
||||
## 9. ما لا يفعله Layer 13
|
||||
|
||||
- ❌ لا يرسل بياناتك خارجياً.
|
||||
- ❌ لا يستدعي LLM (deterministic 100%).
|
||||
- ❌ لا يعدّل بياناتك — read-only.
|
||||
- ❌ لا يستبدل التقييم البشري — يكمّله.
|
||||
|
||||
---
|
||||
|
||||
## 10. التكامل مع الطبقات الأخرى
|
||||
|
||||
| الطبقة | كيف يستفيد منها Public Launch |
|
||||
|--------|-----------------------------|
|
||||
| Customer Ops (Layer 6) | يقرأ SLA + tickets للحساب `support_first_response_minutes_p1` |
|
||||
| Service Excellence (Layer 3) | يضمن أن كل خدمة تظهر لها score ≥80 |
|
||||
| Revenue Company OS (Layer 9) | يقرأ Action Ledger للحساب `unsafe_sends` |
|
||||
| Proof Ledger (Layer 10) | يقرأ proof pack history للحساب `proof_cadence_weeks` |
|
||||
| Service Tower (Layer 2) | يحسب `paid_customers` + `pilots_completed` |
|
||||
| Targeting OS (Layer 4) | يبني funnel للحساب `funnel_visible` |
|
||||
|
||||
---
|
||||
|
||||
## 11. القرار التشغيلي
|
||||
|
||||
```
|
||||
لا تنتقل إلى Public Launch بناءً على "الشعور".
|
||||
انتقل بناءً على /api/v1/public-launch/gate-check = GO_PUBLIC_LAUNCH
|
||||
+ /api/v1/public-launch/pdpl-compliance = compliant
|
||||
+ /api/v1/public-launch/brand-moat ≥ defensible.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 12. Layer 14 — حزمة التنفيذ الميداني (B + G + C)
|
||||
|
||||
مواد جاهزة للتواصل والديمو (عربي، متسقة مع `POSITIONING_LOCK`):
|
||||
|
||||
- [`sales-kit/layer14_email_sequences_4x7_ar.md`](sales-kit/layer14_email_sequences_4x7_ar.md)
|
||||
- [`sales-kit/layer14_battlecards_6_ar.md`](sales-kit/layer14_battlecards_6_ar.md)
|
||||
- [`sales-kit/layer14_demo_12min_script_ar.md`](sales-kit/layer14_demo_12min_script_ar.md)
|
||||
|
||||
فهرس سريع: [`sales-kit/START_HERE.md`](sales-kit/START_HERE.md) → قسم Layer 14.
|
||||
|
||||
**من Private Beta إلى أول Proof Pack (ترتيب العمليات كاملاً):** [`PAID_BETA_FULL_RUNBOOK_AR.md`](PAID_BETA_FULL_RUNBOOK_AR.md).
|
||||
2335
dealix/docs/public_launch_layer_13.patch
Normal file
2335
dealix/docs/public_launch_layer_13.patch
Normal file
File diff suppressed because it is too large
Load Diff
@ -27,6 +27,16 @@
|
||||
| `dealix_onepager.html` | للإرسال في LinkedIn |
|
||||
| `dealix_14day_tracker.html` | تتبع يومي |
|
||||
|
||||
### Layer 14 — تنفيذ سريع (بريد + ديمو + منافسون)
|
||||
|
||||
| الملف | متى تستخدمه |
|
||||
|------|-------------|
|
||||
| [`layer14_email_sequences_4x7_ar.md`](layer14_email_sequences_4x7_ar.md) | ٤ تسلسلات × ٧ رسائل = ٢٨ بريداً جاهزاً (وكالات / تدريب / SaaS / خدمات محلية) |
|
||||
| [`layer14_battlecards_6_ar.md`](layer14_battlecards_6_ar.md) | مواجهة HubSpot / Salesforce / Apollo / Wati / Clay / «AI عام» |
|
||||
| [`layer14_demo_12min_script_ar.md`](layer14_demo_12min_script_ar.md) | سكربت ١٢ دقيقة بوتيرة سعودية + اعتراضات |
|
||||
|
||||
يُكمّل الجدول أعلاه ولا يستبدل `dealix_demo_script_30min.md` إذا احتجت ديمو أطول.
|
||||
|
||||
---
|
||||
|
||||
## 📅 الخطة في 5 مراحل
|
||||
|
||||
90
dealix/docs/sales-kit/layer14_battlecards_6_ar.md
Normal file
90
dealix/docs/sales-kit/layer14_battlecards_6_ar.md
Normal file
@ -0,0 +1,90 @@
|
||||
# Layer 14 — بطاقات مواجهة (٦ منافسين) — للديمو والمتابعة
|
||||
|
||||
**قاعدة:** نحترم المنافس. نبيّن الفجوة. لا نهين ولا نبالغ في المطالبات.
|
||||
**زاوية Dealix:** عربي سعودي تشغيلي، مسودات + موافقة، إشارات محلية، واتساب ضمن سياسة — لا وعود نتائج مضمونة.
|
||||
|
||||
لمقارنات إضافية (Apollo / ZoomInfo / إلخ) راجع [`dealix_competitor_battlecards_v2.md`](dealix_competitor_battlecards_v2.md).
|
||||
|
||||
---
|
||||
|
||||
## ١) مقابل HubSpot (Sales Hub / Breeze)
|
||||
|
||||
**ما يفعلونه جيداً:** CRM قوي، سير عمل، ثقة مؤسسات، تكاملات.
|
||||
**الفجوة لدينا:** التميز في **العربية التشغيلية** و**واتساب كقناة أولى** مع **مسودات + موافقة** وليس «أتمتة إرسال» افتراضية. غالباً التكلفة/المقعد للفرق المتوسطة أعلى من نقطة دخول Pilot لدينا.
|
||||
|
||||
**جملة تقولها:**
|
||||
«إذا HubSpot يخدمكم بالإنجليزي والعمليات الداخلية — ممتاز. Dealix يكمّل الطبقة العربية والمسودات السريعة بموافقة؛ نقدر نتكامل عبر Webhooks بدل المنافسة على الـ CRM.»
|
||||
|
||||
**متى يفوزون:** منظومة بالكامل على HubSpot ومبيعات عالمية إنجليزية.
|
||||
**متى نفوز:** فرق سعودية عربية، واتساب كثيف، وتحتاجون سرعة مسودات موحّدة.
|
||||
|
||||
---
|
||||
|
||||
## ٢) مقابل Salesforce
|
||||
|
||||
**ما يفعلونه جيداً:** منصة مبيعات وخدمة ومؤسسات ضخمة.
|
||||
**الفجوة:** زمن التفعيل والتعقيد للـ SMB؛ العربية التشغيلية اليومية في الواتساب ليست جوهر المنتج.
|
||||
|
||||
**جملة:**
|
||||
«Salesforce منصة عالمية للتحكم؛ نحن طبقة تنفيذ عربية للمسودات والمتابعة القصيرة — غالباً نكمّل لا نستبدل.»
|
||||
|
||||
**متى يفوزون:** RFP مؤسسي، فريق تنفيذ كبير، ميزانية سنوية عالية.
|
||||
**متى نفوز:** سرعة إطلاق Pilot على قنواتكم الحالية خلال أيام.
|
||||
|
||||
---
|
||||
|
||||
## ٣) مقابل Apollo.io
|
||||
|
||||
**ما يفعلونه جيداً:** قواعد بيانات، بحث، تسلسلات بريد، إثراء.
|
||||
**الفجوة:** التركيز إيميل/سوق غربي؛ العربية الخليجية والسياق السعودي في الردود أضعف؛ الواتساب ليس نفس مستوى «التشغيل اليومي».
|
||||
|
||||
**جملة:**
|
||||
«Apollo قوي للبحث والإيميل؛ Dealix يركّز على ما بعد الـ lead: رد عربي سريع كمسودة + موافقة + Proof بسيط.»
|
||||
|
||||
**متى يفوزون:** outbound إنجليزي كبير وفريق RevOps يبني سقالات.
|
||||
**متى نفوز:** سوقكم سعودي/خليجي وقنواتكم واتساب + عربي.
|
||||
|
||||
---
|
||||
|
||||
## ٤) مقابل Wati / مزودي واتساب عامين
|
||||
|
||||
**ما يفعلونه جيداً:** قنوات واتساب، قوالب، أتمتة محادثة.
|
||||
**الفجوة:** غالباً **لا يوجد عمق بيعي B2B** (إشارة → خدمة → اعتراض → Proof) ولا **بوابة موافقة تشغيلية** بنفس شكل Dealix؛ خطر «إرسال حي» بدون حوكمة.
|
||||
|
||||
**جملة:**
|
||||
«أدوات الواتساب تمكّن الإرسال؛ Dealix يفرض مسار مسودة + موافقة + سجل قرارات — هذا الفرق في المخاطر.»
|
||||
|
||||
**متى يفوزون:** حملات إشعارات وتسويق جماعي بسيط.
|
||||
**متى نفوز:** B2B، مخاطر سمعة، وحاجة لمسار موافقة واضح.
|
||||
|
||||
---
|
||||
|
||||
## ٥) مقابل Clay
|
||||
|
||||
**ما يفعلونه جيداً:** إثراء متعدد المصادر، مرونة، مجتمع مشغّلين.
|
||||
**الفجوة:** واجهة/سير عمل إنجليزي؛ العربية غالباً رسمية؛ التركيز إثراء وليس «إغلاق سعودي يومي» مع حوكمة.
|
||||
|
||||
**جملة:**
|
||||
«Clay ممتاز لبناء البيانات؛ Dealix لطبقة الرد والمتابعة القصيرة بالعربي مع موافقة.»
|
||||
|
||||
**متى يفوزون:** فرق تقنية تبني جداول إثراء معقدة.
|
||||
**متى نفوز:** تريدون تشغيل عربي على leads موجودة لديكم.
|
||||
|
||||
---
|
||||
|
||||
## ٦) مقابل «AI عام» (ChatGPT / وكيل بدون منتج)
|
||||
|
||||
**ما يفعلونه جيداً:** سرعة صياغة، تنويع أفكار.
|
||||
**الفجوة:** لا سجل موافقات، لا سياسة قنوات، لا كتالوج خدمات، لا Proof Pack، لا تكامل مسارات Dealix — = مخاطرة تشغيلية.
|
||||
|
||||
**جملة:**
|
||||
«الذكاء العام أداة؛ Dealix نظام تشغيل: موافقة، سجل، عروض، وتسليم — بدون ادّعاء نتائج مضمونة.»
|
||||
|
||||
**متى «الـ AI العام» يكفي:** مهام نادرة، فرد واحد، لا قنوات حساسة.
|
||||
**متى نفوز:** فريق، قنوات، ورغبة بقياس وتسليم.
|
||||
|
||||
---
|
||||
|
||||
## إغلاق سريع (٣٠ ثانية)
|
||||
|
||||
«نحن لسنا بديل CRM وليس بوت واتساب عشوائي — نحن طبقة عربية للمسودات والموافقة والـ Proof على قنواتكم، مع Pilot صغير يُقاس.»
|
||||
107
dealix/docs/sales-kit/layer14_demo_12min_script_ar.md
Normal file
107
dealix/docs/sales-kit/layer14_demo_12min_script_ar.md
Normal file
@ -0,0 +1,107 @@
|
||||
# Layer 14 — سكربت ديمو ١٢ دقيقة (وتيره سعودية + اعتراضات)
|
||||
|
||||
**مرافق:** [`../DEMO_SCRIPT_12_MINUTES.md`](../DEMO_SCRIPT_12_MINUTES.md) (جدول الدقائق والـ API).
|
||||
**مبدأ:** هدوء، احترام وقت العميل، لا وعود نتائج — وعد بمسار: مسودات، موافقة، Proof.
|
||||
|
||||
---
|
||||
|
||||
## قبل الاتصال (٦٠ ثانية)
|
||||
|
||||
- تأكد: `WHATSAPP_ALLOW_LIVE_SEND=false` في العرض.
|
||||
- جهّز تبويب: الديمو أو `/api/v1/personal-operator/daily-brief` (أو لقطة شاشة).
|
||||
- اكتب على ورقة: اسم الشركة، المدينة، قطاع واحد، قناة رئيسية (واتساب/إيميل).
|
||||
|
||||
---
|
||||
|
||||
## ٠:٠٠–٠:٤٥ | تحية + إطار
|
||||
|
||||
«السلام عليكم [الاسم]، شكراً على الوقت — ١٢ دقيقة بالضبط، وآخر دقيقتين لأسئلتكم.
|
||||
اليوم ما أبيع «ميزات»؛ أوريكم مسار عمل واحد: من إشارة إلى مسودة إلى موافقة إلى خطوة تالية. إذا احتجتم نتوسع لاحقاً في جلسة ثانية.»
|
||||
|
||||
---
|
||||
|
||||
## ٠:٤٥–٢:٣٠ | المشكلة + الوعد (بدون مبالغة)
|
||||
|
||||
«شركات B2B عندنا غالب المشكلة ليست نقص أدوات — المشكلة تسريب في ثلاثة أماكن:
|
||||
(١) بطء المسودة العربية (٢) عدم توحيد النبرة بين شخصين (٣) متابعة ضعيفة بعد أول رد.
|
||||
Dealix يقلّل الاحتكاك بمسودات جاهزة للمراجعة وسجل موافقة — مو بنتائج مضمونة، بل بسرعة تنفيذ أوضح.»
|
||||
|
||||
**اعتراض ١:** «هذا يبدو ChatGPT.»
|
||||
«صحيح النموذج لغوي — الفرق هو المسار: موافقة، سياسة قنوات، وربط بخدماتكم الفعلية وليس نصّاً حرّاً.»
|
||||
|
||||
---
|
||||
|
||||
## ٢:٣٠–٤:٣٠ | Daily Brief (مدير مشغول)
|
||||
|
||||
«لو افترضنا أنكم تبيعون لـ[قطاع] في [المدينة] — المدير يحتاج قرارين أو ثلاثة اليوم، لا ٢٠ إشعار.
|
||||
هنا مثال موجز يومي: قرارات مقترحة + مخاطر + تالي أفضل إجراء — كله مسودة للمراجعة.»
|
||||
(اعرض `daily-brief` أو شاشة مكافئة.)
|
||||
|
||||
**اعتراض ٢:** «ما عندنا وقت نراجع مسودات.»
|
||||
«عندكم خيارين: إما تضيقون الحجم (٥ لمسات يومياً) أو ترفعون عتبة الموافقة — النظام مصمم لعدم الإرسال الحي بدون سياسة.»
|
||||
|
||||
---
|
||||
|
||||
## ٤:٣٠–٦:٣٠ | فرص ومتابعة (بدون ازدحام)
|
||||
|
||||
«الفكرة: من إشارة إلى «فرصة» إلى مسودة متابعة قصيرة — ليس تفريغ قائمة آلياً.
|
||||
نوريكم مثال ١٠ فرص كنمط تفكير، حتى لو الأرقام تجريبية في الديمو.»
|
||||
|
||||
**اعتراض ٣:** «احنا ما نبغى آلي يكلم عملاءنا.»
|
||||
«تمام — الافتراضي عندنا مسودة + موافقة؛ الإرسال الحي يحتاج opt-in وسياسة صريحة.»
|
||||
|
||||
---
|
||||
|
||||
## ٦:٣٠–٨:٣٠ | كتالوج الخدمات + سعر تقريبي (شفافية)
|
||||
|
||||
«هنا نربط الإشارة بخدمة واضحة: ماذا تُسلَّم؟ خلال كم يوم؟ ما الـ Proof؟
|
||||
ما نخبّي أن التسعير نطاقي — لأن النطاق يتغير بعمق القائمة والقنوات.»
|
||||
|
||||
**اعتراض ٤:** «غالي.»
|
||||
«نفصل بين Pilot صغير يُقاس وبين اشتراك أوسع. إذا Pilot ما أثبت تنظيم الردود خلال أسبوع، لا داعي نكبر العقد.»
|
||||
|
||||
---
|
||||
|
||||
## ٨:٣٠–١٠:٣٠ | Pilot + Proof Pack + الخطوة التالية
|
||||
|
||||
«Pilot عملي: نطاق صغير، تقرير Proof واحد، قرار واضح في النهاية.
|
||||
ما نعد نتائج مضمونة — نعد تسليماً يمكنكم عرضه داخل شركتكم.»
|
||||
|
||||
**اعتراض ٥:** «نبي ضمان ROI.»
|
||||
«ما نقدر نضمن ROI — نقدر نضبط قياساً قبل/بعد على مؤشرات متفق عليها (مثلاً زمن أول رد، عدد المسودات المعتمدة، عدد اللقاءات المحجوزة).»
|
||||
|
||||
**اعتراض ٦:** «نرجع لكم بعد الميزانية.»
|
||||
«تمام — أرسل لكم ملخص ست أسطر + خياران للموعد بعد أسبوعين؛ أي تاريخ أخف ضغطاً على مدير المشتريات؟»
|
||||
|
||||
---
|
||||
|
||||
## ١٠:٣٠–١١:٣٠ | PDPL / أمان (٣٠ ثانية — لا تطويل)
|
||||
|
||||
«البيانات شخصية: نمشي على مسار موافقة وتقليل بيانات؛ التفاصيل في وثائقكم القانونية + DPA عند الحاجة.
|
||||
الإرسال الحي يتبع سياسة القناة — هذا خط أحمر لنا وليس خيار تسويق.»
|
||||
|
||||
---
|
||||
|
||||
## ١١:٣٠–١٢:٠٠ | إغلاق + CTA واحد
|
||||
|
||||
«الخطوة التالية المنطقية: جلسة ٣٠ دقيقة مع شخص يملك القرار التقني/التجاري، أو Pilot ٧ أيام بنطاق صغير.
|
||||
أيهما أنسب لكم الأسبوع هذا؟»
|
||||
|
||||
---
|
||||
|
||||
## ملحق — اعتراضات إضافية سريعة
|
||||
|
||||
| الاعتراض | رد |
|
||||
|----------|-----|
|
||||
| «عندنا HubSpot» | نكمّل العربي/الواتساب والمسودات؛ لا نكرّر الـ CRM. |
|
||||
| «نبي تكامل كامل اليوم» | نبدأ بWebhook أو تصدير يومي؛ التكامل الكامل مرحلة لاحقة بخطة. |
|
||||
| «القطاع حساس» | نضيق القنوات + نرفع مراجعة الموافقات + نقلل الحجم. |
|
||||
| «الفريق يخاف من AI» | نسمّيه «مسودات مقترحة» ونثبت أن الإنسان يوافق. |
|
||||
|
||||
---
|
||||
|
||||
## بعد الديمو مباشرة (٥ دقائق منك)
|
||||
|
||||
- أرسل ملخص ٦ أسطر + موعد متابعة واحد.
|
||||
- أرفق [`dealix_roi_calculator.html`](dealix_roi_calculator.html) إن كان يناسبهم.
|
||||
- سجّل في الـ CRM: اعتراض رئيسي + قرارهم + تاريخ المتابعة.
|
||||
274
dealix/docs/sales-kit/layer14_email_sequences_4x7_ar.md
Normal file
274
dealix/docs/sales-kit/layer14_email_sequences_4x7_ar.md
Normal file
@ -0,0 +1,274 @@
|
||||
# Layer 14 — تسلسلات بريد عربية (٤ أشخاص × ٧ رسائل = ٢٨)
|
||||
|
||||
**الاستخدام:** بعد أول لمسة (رد، فتح، زيارة صفحة) ولم يُحجز ديمو.
|
||||
**القواعد:** رسالة واحدة واضحة، ≤ ٢٠٠ كلمة، CTA واحد، تذييل PDPL (إيقاف).
|
||||
|
||||
**جدولة مقترحة (لا ترسل كل شيء في يوم واحد):**
|
||||
رسالة ١ يوم ٠، ٢ بعد يوم، ٣ بعد يومين، ٤ بعد ٣ أيام، ٥ بعد ٥، ٦ بعد ٧، ٧ بعد ١٠ من آخر تفاعل.
|
||||
|
||||
**عناصر تستبدلها:** `[الاسم]` `[اسم الشركة]` `[المدينة]` `[رابط_الديمو]` `[رابط_الموقع]`
|
||||
|
||||
---
|
||||
|
||||
## التسلسل ١ — وكالات تسويق B2B (الرياض / جدة / الدمام)
|
||||
|
||||
### ١ — يوم ٠ | موضوع: `٣ أشياء تسرّب عمولتكم بدون ما تلاحظوا`
|
||||
|
||||
السلام عليكم [الاسم]،
|
||||
|
||||
وكالات مثل [اسم الشركة] تربحون من السرعة: عرض → اقتراح → موافقة عميل. أين التسريب؟
|
||||
(١) متابعة الـ leads بعد أول «تم الاطلاع» (٢) عدم توحيد نبرة العربي بين فريقين (٣) غياب Proof بسيط يُرسل للعميل كل أسبوع.
|
||||
|
||||
Dealix يعطيكم مسودات عربية + كروت موافقة + تتبع — بدون وعد بنتائج مضمونة.
|
||||
|
||||
هل نخصص ١٢ دقيقة؟ [رابط_الديمو]
|
||||
|
||||
سامي — Dealix
|
||||
— لإيقاف الرسائل: رد «إيقاف».
|
||||
|
||||
### ٢ — يوم ١ | موضوع: `سطر واحد يزيد احتمال الرد على العميل`
|
||||
|
||||
[الاسم]،
|
||||
|
||||
جرّب تبدأ أي متابعة بجملة سياق سعودي قصيرة (مدينة + قطاع + سبب اللمسة) ثم سؤال واحد فقط.
|
||||
Dealix يولّد هذا النمط تلقائياً كمسودة للمراجعة.
|
||||
|
||||
نرسل لكم ٣ أمثلة على قائمتكم التجريبية؟ رد بنعم أو احجز: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٣ — يوم ٢ | موضوع: `كيف تُغلقون Pilot بدون «ميزانية العام القادم»`
|
||||
|
||||
السلام عليكم،
|
||||
|
||||
أغلب الوكالات تخسر الديمو لأن العرض كبير. نمط يعمل: Pilot ٧ أيام + نطاق صغير + Proof أسبوعي واحد.
|
||||
Dealix يجهّز لكم نص Pilot جاهز للنسخ (عربي) + قائمة تسليم.
|
||||
|
||||
١٢ دقيقة توضيح: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٤ — يوم ٣ | موضوع: `واتساب للوكالة: مسودة أولاً`
|
||||
|
||||
[الاسم]،
|
||||
|
||||
لا نرسل حيّاً بدون opt-in وسياسة — هذا خط أحمر. ما نقدمه: مسودات عربية + موافقة داخلية + سجل قرارات.
|
||||
لو تبغون نراجع سياسة القنوات عندكم في نفس الجلسة: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٥ — يوم ٥ | موضوع: `ماذا نرسل للعميل إذا قال «ارسلوا عرض أسعار»؟`
|
||||
|
||||
قالب قصير يعمل: (أ) ملخص فهم (٣ أسطر) (ب) ٣ خيارات أسعار مع حدود (ج) خطوة تالية واحدة + موعد.
|
||||
Dealix يولّد المسودة؛ أنتم توافقون.
|
||||
|
||||
نريكم المثال على وكالتكم؟ [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٦ — يوم ٧ | موضوع: `Battlecard سريع: عميلكم يقارنكم بـ HubSpot`
|
||||
|
||||
لو سمعتم «عندنا HubSpot» — الجواب ليس «نستبدلهم». الجواب: «نكمّل العربي + الواتساب + المسودات بموافقة».
|
||||
أرسل لكم بطاقة مقارنة جاهزة بعد ديمو قصير: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٧ — يوم ١٠ | موضوع: `آخر متابعة — ونص referral للوكالة`
|
||||
|
||||
[الاسم]،
|
||||
|
||||
إذا التوقيت مو مناسب، تمام. لو تعرفون شركة B2B سعودية تحتاج تسريع ردود عربية — ردوا باسم جهة الاتصال وسأرسل لهم لمسة واحدة فقط بإذنكم.
|
||||
|
||||
شكراً،
|
||||
سامي — Dealix
|
||||
(آخر رسالة آلية في هذا التسلسل)
|
||||
|
||||
---
|
||||
|
||||
## التسلسل ٢ — شركات تدريب وتطوير (برامج للشركات)
|
||||
|
||||
### ١ — يوم ٠ | موضوع: `من يملأ مقاعد البرنامج بعد أول إعلان؟`
|
||||
|
||||
السلام عليكم [الاسم]،
|
||||
|
||||
التدريب للشركات يبيع «التحوّل» — لكن المبيعات تموت بين «أرسلوا البرنامج» و«راجع الميزانية».
|
||||
Dealix يساعدكم على متابعة جهات الاتصال بمسودات عربية قصيرة + تذكير موافقة داخلية.
|
||||
|
||||
ديمو ١٢ دقيقة: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٢ — يوم ١ | موضوع: `٣ رسائل فقط ترفعون فيها حجز الاستكشاف`
|
||||
|
||||
(١) سؤال عن هدف الربع (٢) ربط البرنامج بنتيجة قابلة للقياس (٣) موعدين اختيار.
|
||||
نرسل أمثلة باسم برنامجكم؟ [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٣ — يوم ٢ | موضوع: `PDF لا يكفي — لازم «جملة قرار»`
|
||||
|
||||
السلام عليكم،
|
||||
|
||||
ملخص صفحة واحدة يشرح: لمن؟ ماذا يتغير في أسبوعين؟ ما المخاطر؟ ماذا نحتاج من العميل؟
|
||||
Dealix يولّد المسودة؛ أنتم تضبطون المنهج.
|
||||
|
||||
١٢ دقيقة: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٤ — يوم ٣ | موضوع: `متابعة بعد «شكراً سنتواصل»`
|
||||
|
||||
جملة تعمل: «تمام — أرسل لكم ملخص ٦ أسطر + ٣ تواريخ اختيارية؛ أي تاريخ يناسب مدير التعلم؟»
|
||||
نضبطها على نبرة شركتكم؟ [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٥ — يوم ٥ | موضوع: `Pilot للتدريب: نطاق صغير يُقاس`
|
||||
|
||||
اقتراح: ورشة واحدة + قائمة حضور ٣٠ + تقرير مشاركة + Proof للعميل.
|
||||
Dealix يساعد في المسودات والمتابعة — بدون إرسال حي افتراضي.
|
||||
|
||||
[رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٦ — يوم ٧ | موضوع: `اعتراض شائع: «عندنا فريق مبيعات»`
|
||||
|
||||
ممتاز — نحن لا نستبدل الفريق؛ نزيل الاحتكاك: مسودات أسرع + توحيد عربي + سجل موافقات.
|
||||
نريكم في الديمو: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٧ — يوم ١٠ | موضوع: `نغلق الملف باحترام`
|
||||
|
||||
[الاسم]،
|
||||
|
||||
آخر رسالة. إذا رجعتم لاحقاً، ردوا على نفس الخيط.
|
||||
إن عرفتم شركة تدريب تعاني من تأخر الردود — أرسلوا اسم جهة الاتصال (بإذنهم).
|
||||
|
||||
سامي — Dealix
|
||||
|
||||
---
|
||||
|
||||
## التسلسل ٣ — B2B SaaS (منتج تقني للشركات)
|
||||
|
||||
### ١ — يوم ٠ | موضوع: `الـ demo لا يُغلق لأن السؤال الأخير ضعيف`
|
||||
|
||||
السلام عليكم [الاسم]،
|
||||
|
||||
أغلب SaaS يختم الديمو بـ«نرسل عرض» بدل سؤال واحد: «ما الذي يمنع التفعيل الأسبوع القادم؟»
|
||||
Dealix يولّد مسودات متابعة عربية + كروت موافقة.
|
||||
|
||||
١٢ دقيقة: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٢ — يوم ١ | موضوع: `Feature list تقتل البريد — استخدموا نتيجة واحدة`
|
||||
|
||||
بدل ١٢ ميزة: «نقلل وقت الرد من ساعات إلى دقائق على قناة X لدى فرق مثلكم».
|
||||
نضبطها على منتجكم؟ [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٣ — يوم ٢ | موضوع: `Security مسألة ٣٠ ثانية في البريد`
|
||||
|
||||
«مسودات فقط، موافقة داخلية، سجل قرارات، واتساب opt-in».
|
||||
Dealix مبني على هذا المبدأ — نشرح في الديمو: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٤ — يوم ٣ | موضوع: `مقارنة مع أداة عالمية بدون مهاجمة`
|
||||
|
||||
«نكمّل أدواتكم الحالية للطبقة العربية + المتابعة القصيرة».
|
||||
Battlecards جاهزة بعد الديمو.
|
||||
|
||||
[رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٥ — يوم ٥ | موضوع: `POC أسبوع واحد بدل RFP لا نهاية له`
|
||||
|
||||
نطاق: ٢٥ lead حقيقي + مسودات + تقرير Proof واحد.
|
||||
هل يناسبكم؟ [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٦ — يوم ٧ | موضوع: `الأسعار: قولوا الحدود ثم السؤال`
|
||||
|
||||
«يبدأ من X ويناسب فرق بحجمكم بين Y وZ — أي نطاق أقرب لميزانيتكم؟»
|
||||
نراجع نبرة السعر معكم: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٧ — يوم ١٠ | موضوع: `ننتقل لمرحلة صمت — أو referral`
|
||||
|
||||
شكراً لوقتكم. لو تعرفون SaaS سعودي يبيع للشركات ويعاني من المتابعة — رشّحوا اسمًا (بإذنهم).
|
||||
سامي — Dealix
|
||||
|
||||
---
|
||||
|
||||
## التسلسل ٤ — خدمات محلية (تشغيل، لوجستيات، صيانة، موردين B2B)
|
||||
|
||||
### ١ — يوم ٠ | موضوع: `طلبات واتساب كثيرة؟ هذا أغلى من «الرد الآلي»`
|
||||
|
||||
السلام عليكم [الاسم]،
|
||||
|
||||
المشكلة ليست السرعة فقط — المشكلة توحيد الرد + تذكير الفريق بما وُعد به العميل.
|
||||
Dealix: مسودات عربية + موافقة + تتبع.
|
||||
|
||||
١٢ دقيقة: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٢ — يوم ١ | موضوع: `جملة واحدة تقلل الشكوى`
|
||||
|
||||
«تم الاستلام — المتوقع خلال X — وسأرسل لكم رقم المتابعة».
|
||||
نولّدها كقالب لكم؟ [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٣ — يوم ٢ | موضوع: `جدولة زيارات بدون ازدحام الواتساب`
|
||||
|
||||
مسودة: خياران للتاريخ + سؤال عن الموقع + تذكير بالمخاطر (بوابة/تصريح).
|
||||
[رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٤ — يوم ٣ | موضوع: `الفواتير والمتابعة — بلغ بسيط`
|
||||
|
||||
«فاتورتكم جاهزة — الرابط هنا — أي استفسار على البند X؟»
|
||||
Dealix يساعد على صياغة عربي واضح للعمليات.
|
||||
|
||||
[رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٥ — يوم ٥ | موضوع: `توسيع نفس القوالب لفرع ثاني في [المدينة]`
|
||||
|
||||
لو عندكم فرعان، توحيد النبرة يقلل الأخطاء.
|
||||
نراجع أمثلة من قطاعكم: [رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٦ — يوم ٧ | موضوع: `«نبي نظام» — نبدأ بأصغر خطوة قياس`
|
||||
|
||||
Pilot: أسبوع + قناة واحدة + ٣ قوالب موافقة.
|
||||
[رابط_الديمو]
|
||||
|
||||
— إيقاف: رد «إيقاف».
|
||||
|
||||
### ٧ — يوم ١٠ | موضوع: `شكراً — الباب مفتوح`
|
||||
|
||||
[الاسم]،
|
||||
|
||||
نقدّر شغلكم الميداني. إذا احتجتمنا لاحقاً، ردوا هنا.
|
||||
إن عرفتم منشأة خدمات في [المدينة] تحتاج تنظيم واتساب — رشّحوا (بإذنهم).
|
||||
|
||||
سامي — Dealix
|
||||
|
||||
---
|
||||
|
||||
## ملاحظة تشغيلية
|
||||
|
||||
- راجع [`POSITIONING_LOCK.md`](../POSITIONING_LOCK.md) و[`APPROVED_MARKET_MESSAGING.md`](../APPROVED_MARKET_MESSAGING.md) قبل الإرسال الجماعي.
|
||||
- للتسلسلات الأقدم في نفس المجلد راجع أيضاً [`dealix_email_drip_sequences.md`](dealix_email_drip_sequences.md).
|
||||
296
dealix/tests/unit/test_public_launch.py
Normal file
296
dealix/tests/unit/test_public_launch.py
Normal file
@ -0,0 +1,296 @@
|
||||
"""Tests for the Public Launch Gate (Layer 13)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from auto_client_acquisition.public_launch import (
|
||||
PUBLIC_LAUNCH_CRITERIA,
|
||||
GateVerdict,
|
||||
evaluate_public_launch_gate,
|
||||
pilot_tracker_summary,
|
||||
PilotRecord,
|
||||
compute_pdpl_compliance,
|
||||
compute_brand_moat_score,
|
||||
)
|
||||
|
||||
|
||||
# ===== Gate evaluation =====
|
||||
|
||||
def test_criteria_count_is_nine():
|
||||
assert len(PUBLIC_LAUNCH_CRITERIA) == 9
|
||||
|
||||
|
||||
def test_gate_all_passing_yields_go_public_launch():
|
||||
state = {
|
||||
"pilots_completed": 7,
|
||||
"paid_customers": 3,
|
||||
"unsafe_sends": 0,
|
||||
"proof_cadence_weeks": 4,
|
||||
"support_first_response_minutes_p1": 60,
|
||||
"funnel_visible": True,
|
||||
"staging_uptime_days": 21,
|
||||
"billing_webhook_verified": True,
|
||||
"legal_complete": True,
|
||||
}
|
||||
v = evaluate_public_launch_gate(state)
|
||||
assert v.decision == "GO_PUBLIC_LAUNCH"
|
||||
assert v.score_passed == v.score_total == 9
|
||||
assert not v.blockers
|
||||
assert "جاهز للإطلاق العام" in v.summary_ar
|
||||
|
||||
|
||||
def test_gate_unsafe_sends_triggers_blocked():
|
||||
state = {
|
||||
"pilots_completed": 7,
|
||||
"paid_customers": 3,
|
||||
"unsafe_sends": 1, # ← hard block
|
||||
"proof_cadence_weeks": 4,
|
||||
"support_first_response_minutes_p1": 60,
|
||||
"funnel_visible": True,
|
||||
"staging_uptime_days": 21,
|
||||
"billing_webhook_verified": True,
|
||||
"legal_complete": True,
|
||||
}
|
||||
v = evaluate_public_launch_gate(state)
|
||||
assert v.decision == "BLOCKED"
|
||||
assert "Hard block" in v.summary_ar
|
||||
|
||||
|
||||
def test_gate_partial_yields_no_go_with_blockers():
|
||||
state = {
|
||||
"pilots_completed": 2,
|
||||
"paid_customers": 1,
|
||||
"unsafe_sends": 0,
|
||||
"proof_cadence_weeks": 1,
|
||||
"support_first_response_minutes_p1": 60,
|
||||
"funnel_visible": True,
|
||||
"staging_uptime_days": 5,
|
||||
"billing_webhook_verified": False,
|
||||
"legal_complete": False,
|
||||
}
|
||||
v = evaluate_public_launch_gate(state)
|
||||
assert v.decision == "NO_GO"
|
||||
assert v.score_passed < v.score_total
|
||||
blocker_keys = {b["key"] for b in v.blockers}
|
||||
assert "pilots_completed" in blocker_keys
|
||||
assert "billing_webhook_verified" in blocker_keys
|
||||
assert "legal_complete" in blocker_keys
|
||||
assert v.next_actions_ar # has Arabic actions
|
||||
|
||||
|
||||
def test_gate_empty_state_blocks_everything():
|
||||
v = evaluate_public_launch_gate({})
|
||||
assert v.decision != "GO_PUBLIC_LAUNCH"
|
||||
assert len(v.blockers) >= 8
|
||||
|
||||
|
||||
def test_gate_support_response_is_max_threshold_lower_better():
|
||||
state_good = {"support_first_response_minutes_p1": 30}
|
||||
state_bad = {"support_first_response_minutes_p1": 200}
|
||||
# 30 ≤ 120 → pass; 200 > 120 → fail
|
||||
keys_good = {r["key"] for r in evaluate_public_launch_gate(state_good).criteria_results if r["passed"]}
|
||||
keys_bad = {r["key"] for r in evaluate_public_launch_gate(state_bad).criteria_results if r["passed"]}
|
||||
assert "support_first_response_minutes_p1" in keys_good
|
||||
assert "support_first_response_minutes_p1" not in keys_bad
|
||||
|
||||
|
||||
# ===== Pilot tracker =====
|
||||
|
||||
def test_pilot_summary_basic_aggregation():
|
||||
pilots = [
|
||||
{
|
||||
"pilot_id": "p1", "company": "A", "sector": "agency", "city": "RUH",
|
||||
"started_at": "2026-04-25", "stage": "completed",
|
||||
"paid": True, "pilot_price_sar": 499,
|
||||
"proof_pack_sent": True, "proof_pack_sent_at": "2026-05-01",
|
||||
"upgrade_outcome": "growth_os_monthly", "upgrade_value_sar": 2999,
|
||||
},
|
||||
{
|
||||
"pilot_id": "p2", "company": "B", "sector": "training", "city": "JED",
|
||||
"started_at": "2026-04-20", "stage": "stalled",
|
||||
"paid": False, "pilot_price_sar": 0,
|
||||
"proof_pack_sent": False, "proof_pack_sent_at": None,
|
||||
"upgrade_outcome": None,
|
||||
},
|
||||
]
|
||||
s = pilot_tracker_summary(pilots)
|
||||
assert s.total_pilots == 2
|
||||
assert s.completed_pilots == 1
|
||||
assert s.proof_packs_delivered == 1
|
||||
assert s.paid_pilots == 1
|
||||
assert s.paid_revenue_sar == 499
|
||||
assert s.upgrade_revenue_sar == 2999
|
||||
assert s.growth_os_subscribers == 1
|
||||
assert s.stalled_pilots == 1
|
||||
assert s.by_sector == {"agency": 1, "training": 1}
|
||||
assert s.by_city == {"RUH": 1, "JED": 1}
|
||||
|
||||
|
||||
def test_pilot_summary_empty_returns_zeros():
|
||||
s = pilot_tracker_summary([])
|
||||
assert s.total_pilots == 0
|
||||
assert s.completion_rate == 0.0
|
||||
assert s.paid_conversion_rate == 0.0
|
||||
assert s.upgrade_conversion_rate == 0.0
|
||||
|
||||
|
||||
def test_pilot_summary_avg_proof_days_computed():
|
||||
pilots = [
|
||||
{
|
||||
"pilot_id": "p1", "company": "A", "sector": "saas", "city": "RUH",
|
||||
"started_at": "2026-04-25T00:00:00", "stage": "completed",
|
||||
"paid": True, "pilot_price_sar": 499,
|
||||
"proof_pack_sent": True,
|
||||
"proof_pack_sent_at": "2026-05-02T00:00:00",
|
||||
"upgrade_outcome": "case_study",
|
||||
}
|
||||
]
|
||||
s = pilot_tracker_summary(pilots)
|
||||
assert s.average_proof_pack_days == 7.0
|
||||
|
||||
|
||||
def test_pilot_summary_accepts_pilotrecord_instances():
|
||||
rec = PilotRecord(
|
||||
pilot_id="p1", company="A", sector="agency", city="RUH",
|
||||
started_at="2026-04-25", stage="completed",
|
||||
paid=True, pilot_price_sar=499,
|
||||
proof_pack_sent=True, proof_pack_sent_at="2026-05-01",
|
||||
upgrade_outcome="growth_os_monthly", upgrade_value_sar=2999,
|
||||
)
|
||||
s = pilot_tracker_summary([rec])
|
||||
assert s.total_pilots == 1
|
||||
assert s.paid_pilots == 1
|
||||
|
||||
|
||||
# ===== PDPL compliance =====
|
||||
|
||||
def test_pdpl_full_compliance_yields_compliant():
|
||||
state = {
|
||||
"data_residency_saudi": True,
|
||||
"whatsapp_opt_in_audit": True,
|
||||
"email_opt_in_audit": True,
|
||||
"breach_notification_72h_ready": True,
|
||||
"dpa_template_published": True,
|
||||
"privacy_policy_bilingual": True,
|
||||
"data_retention_policy": True,
|
||||
"trace_redaction_active": True,
|
||||
"action_ledger_audit": True,
|
||||
"consent_revocation_path": True,
|
||||
}
|
||||
r = compute_pdpl_compliance(state)
|
||||
assert r.overall_status == "compliant"
|
||||
assert r.score_passed == r.score_total
|
||||
assert not r.critical_failures
|
||||
|
||||
|
||||
def test_pdpl_critical_failure_yields_non_compliant():
|
||||
state = {
|
||||
"data_residency_saudi": False, # critical
|
||||
"whatsapp_opt_in_audit": True,
|
||||
"email_opt_in_audit": True,
|
||||
"breach_notification_72h_ready": True,
|
||||
"dpa_template_published": True,
|
||||
"privacy_policy_bilingual": True,
|
||||
"data_retention_policy": True,
|
||||
"trace_redaction_active": True,
|
||||
"action_ledger_audit": True,
|
||||
"consent_revocation_path": True,
|
||||
}
|
||||
r = compute_pdpl_compliance(state)
|
||||
assert r.overall_status == "non_compliant"
|
||||
assert any(f["key"] == "data_residency_saudi" for f in r.critical_failures)
|
||||
|
||||
|
||||
def test_pdpl_high_only_yields_needs_fixes():
|
||||
state = {
|
||||
"data_residency_saudi": True,
|
||||
"whatsapp_opt_in_audit": True,
|
||||
"email_opt_in_audit": False, # high
|
||||
"breach_notification_72h_ready": True,
|
||||
"dpa_template_published": True,
|
||||
"privacy_policy_bilingual": True,
|
||||
"data_retention_policy": True,
|
||||
"trace_redaction_active": True,
|
||||
"action_ledger_audit": True,
|
||||
"consent_revocation_path": True,
|
||||
}
|
||||
r = compute_pdpl_compliance(state)
|
||||
assert r.overall_status == "needs_fixes"
|
||||
assert not r.critical_failures
|
||||
assert any(f["key"] == "email_opt_in_audit" for f in r.high_failures)
|
||||
|
||||
|
||||
# ===== Brand moat score =====
|
||||
|
||||
def test_brand_moat_zero_state_yields_fragile():
|
||||
score = compute_brand_moat_score({})
|
||||
assert score.tier == "fragile"
|
||||
assert score.overall_score < 35
|
||||
|
||||
|
||||
def test_brand_moat_high_state_yields_dominant():
|
||||
state = {
|
||||
"events_logged_count": 5_000,
|
||||
"messages_per_sector_count": 200,
|
||||
"sectors_covered_count": 15,
|
||||
"linkedin_followers": 10_000,
|
||||
"newsletter_subscribers": 3_000,
|
||||
"monthly_branded_searches": 1_500,
|
||||
"case_studies_published": 30,
|
||||
"pdpl_compliance_pct": 100,
|
||||
"iso_27001_progress_pct": 100,
|
||||
"audit_count_last_year": 6,
|
||||
"dpa_signed_with_customers_pct": 100,
|
||||
"agency_partners_count": 50,
|
||||
"active_referring_agencies_count": 25,
|
||||
"agency_revenue_share_paid_sar": 200_000,
|
||||
"certified_operators_count": 200,
|
||||
"operators_active_last_30d": 100,
|
||||
"operator_revenue_share_paid_sar": 100_000,
|
||||
}
|
||||
score = compute_brand_moat_score(state)
|
||||
assert score.tier == "dominant"
|
||||
assert score.overall_score >= 80
|
||||
|
||||
|
||||
def test_brand_moat_identifies_weakest_dimension():
|
||||
state = {
|
||||
# Strong everywhere except network
|
||||
"events_logged_count": 5_000,
|
||||
"messages_per_sector_count": 200,
|
||||
"sectors_covered_count": 15,
|
||||
"linkedin_followers": 10_000,
|
||||
"newsletter_subscribers": 3_000,
|
||||
"monthly_branded_searches": 1_500,
|
||||
"case_studies_published": 30,
|
||||
"pdpl_compliance_pct": 100,
|
||||
"iso_27001_progress_pct": 100,
|
||||
"audit_count_last_year": 6,
|
||||
"dpa_signed_with_customers_pct": 100,
|
||||
# network = 0
|
||||
"agency_partners_count": 0,
|
||||
"active_referring_agencies_count": 0,
|
||||
"agency_revenue_share_paid_sar": 0,
|
||||
# distribution = 0
|
||||
"certified_operators_count": 0,
|
||||
"operators_active_last_30d": 0,
|
||||
"operator_revenue_share_paid_sar": 0,
|
||||
}
|
||||
score = compute_brand_moat_score(state)
|
||||
assert score.weakest_dimension in ("network_moat", "distribution_moat")
|
||||
|
||||
|
||||
def test_brand_moat_returns_arabic_summary():
|
||||
score = compute_brand_moat_score({})
|
||||
assert "Brand Moat Score" in score.summary_ar
|
||||
assert "fragile" in score.summary_ar or "هش" in score.summary_ar
|
||||
|
||||
|
||||
# ===== GateVerdict serialization =====
|
||||
|
||||
def test_gate_verdict_serializes_to_dict():
|
||||
v = evaluate_public_launch_gate({"pilots_completed": 5, "paid_customers": 2})
|
||||
d = v.to_dict()
|
||||
assert "decision" in d
|
||||
assert "criteria_results" in d
|
||||
assert "next_actions_ar" in d
|
||||
assert isinstance(d["criteria_results"], list)
|
||||
Loading…
Reference in New Issue
Block a user