system-prompts-and-models-o.../dealix/auto_client_acquisition/targeting_os/contract_drafts.py
Dealix Builder e106a9a0d2 feat(targeting+service+excellence): Saudi Targeting OS + Service Tower + Service Excellence — 38 modules + 62 endpoints + 105 tests
Targeting & Acquisition OS (16 modules) — نظام الاستهداف الذكي
- account_finder: account-first targeting; 12 buying signals; deterministic 10-25 accounts per (sector, city)
- buyer_role_mapper: 14 buyer roles + sector-specific buying-committee maps + role-based Arabic angles
- contact_source_policy: 12 sources (crm_customer→opt_out) with risk_score, channels-allowed, retention guidance, lawful_basis
- contactability_matrix: 5 action modes (suggest_only/draft_only/approval_required/approved_execute/blocked); opt-out always blocked
- linkedin_strategy: Lead Forms + Ads + manual ONLY; linkedin_do_not_do() locks scrape/auto-DM/auto-connect/extensions
- email_strategy: drafts + unsubscribe footer + domain-pacing (fresh/warmed/trusted/damaged) + spam-trigger risk
- whatsapp_strategy: opt-in only; rejects cold + risky phrases; opt-in template requires explicit purpose+company+unsubscribe
- social_strategy: official APIs only; listening + drafts; no auto-publish
- outreach_scheduler: day-by-day plans + daily limits + opt-out enforcement
- reputation_guard: bounce/complaint/opt-out thresholds → healthy/watch/pause + recovery actions per channel
- daily_autopilot: Arabic brief + 7 today actions + EOD report
- acquisition_scorecard: pipeline + meetings + risks + productivity_score
- self_growth_mode: 5 ICP focuses for Dealix; daily brief + monthly targets
- free_diagnostic: Free Growth Diagnostic (3 ops + msg + risk + plan) → paid pilot recommendation
- contract_drafts: Pilot/DPA/Referral/Agency/SOW outlines (legal_review_required, PDPL-aware)
- service_offers: 7 targeting-tier offers + recommend by customer-type

Service Tower (8 modules) — برج الخدمات الذاتية (12 productized services)
- service_catalog: 12 services with target_customer/outcome/inputs/workflow/deliverables/pricing/risk/proof/upgrade
- service_wizard: deterministic recommend (agency→partner; list→list_intelligence; founder→self_growth; CEO→exec_brief; budget≥2999→growth_os; default→first_10)
- mission_templates: workflow steps with approval gates + linked growth missions
- pricing_engine: SAR quotes scaled by company_size×urgency×channels_count + setup_fee + monthly_offer
- deliverables: client report outline + proof pack template + operator checklist (no live actions)
- service_scorecard: 0..100 score from drafts/replies/meetings/pipeline/CSAT
- whatsapp_ceo_control: daily brief, approval cards (≤3 buttons), risk alerts, EOD reports
- upgrade_paths: deterministic next-service recommendation + Arabic upsell messages

Service Excellence OS (8 modules) — مصنع الخدمات الممتازة
- feature_matrix: 12 must-have features per service + advanced/premium/future tiers
- service_scoring: 10-dimension excellence score (clarity, speed_to_value, automation, compliance, proof, upsell, uniqueness, scalability, ops_daily, proof_data) → launch_ready/beta_only/needs_work
- quality_review: 4 gates (proof / approval / pricing / channels) + status verdict; review_service_before_launch and review/all
- competitor_gap: 7 competitor categories (CRM, WhatsApp tools, email assistants, LinkedIn tools, agencies, revenue intelligence, generic AI) + Dealix advantages + do-not-copy
- proof_metrics: required metrics + ROI estimate (pipeline_x + closed_won_x) + Arabic summary
- research_lab: monthly brief + feature hypotheses + top-3 experiments + monthly review
- service_improvement_backlog: feedback→backlog conversion + impact/effort prioritization + weekly improvements
- launch_package: landing outline + sales script + 12-min demo script + 5-day onboarding checklist

Routers (3 new) — 62 endpoints
- /api/v1/targeting/* — 20 endpoints (accounts, buying-committee, contacts, uploaded-list, outreach, daily-autopilot, self-growth, reputation, linkedin, drafts, free-diagnostic, services, contracts)
- /api/v1/services/* — 20 endpoints (catalog, recommend, intake, start, workflow, deliverables, proof-pack, quote, setup-fee, monthly-offer, scorecard, upgrade-path, ceo daily-brief/approval-card/risk-alert/EOD)
- /api/v1/service-excellence/* — 22 endpoints (feature-matrix, score, quality-review, review/all, proof-metrics, roi-estimate, gap-analysis, research-brief, hypotheses, experiments, monthly-review, backlog, weekly-improvements, launch-package, landing/sales/demo/onboarding)

Tests (3 new files, 105 tests)
- test_targeting_os: 47 tests (Arabic accounts, buying committees, opt-out blocked, cold WA blocked, LinkedIn no-scraping, email unsubscribe, WA risk, outreach plan, reputation guard, self-growth, contracts, scorecard)
- test_service_tower: 38 tests (12+ services, all have pricing/proof/deliverables/approval, wizard recommendations, workflow includes approval, quote scales, CEO cards ≤3 buttons, no live send)
- test_service_excellence: 33 tests (feature matrix, score returns status, ALL services pass quality gates, ROI x-multiples, 7 competitor categories, hypotheses+experiments, backlog conversion, launch package complete, demo=12min)

Docs (3 new + 1 updated)
- TARGETING_ACQUISITION_OS.md (Arabic)
- SERVICE_TOWER_STRATEGY.md (Arabic)
- SERVICE_EXCELLENCE_OS.md (Arabic)
- DEALIX_100_PERCENT_LAUNCH_PLAN.md — added §36 Targeting OS + §37 Service Tower + §38 Service Excellence + §39 Landing Pages

Landing pages (4 new, RTL Arabic)
- services.html — 3 doors + 12 productized services
- free-diagnostic.html — free growth diagnostic
- first-10-opportunities.html — kill feature
- agency-partner.html — agency partner program

Test results
- 105/105 new tests pass
- Full suite: 768 passed, 2 skipped
- 0 existing tests broken

Safety + integration with previous layers
- Targeting OS uses contactability_matrix → ALL contacts gated before any send
- Service Tower's workflow includes approval gate; ALL services live_send_allowed=False
- Service Excellence quality_review BLOCKS launch on missing proof/approval/pricing/unsafe channels
- linkedin_do_not_do() encodes 8 explicit prohibitions (scraping/auto-DM/auto-connect/extensions)
- whatsapp_do_not_do() blocks cold sends + group scraping
- Contracts always: legal_review_required=True, not_legal_advice=True, PDPL sections present
- Self-Growth Mode lets Dealix target its OWN ICP using the same approval-first pipeline

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

122 lines
5.1 KiB
Python

"""Contract draft outlines — Arabic skeletons; legal review required."""
from __future__ import annotations
from typing import Any
_DISCLAIMER_AR = (
"هذه مسودة هيكلية فقط، ليست استشارة قانونية. "
"لا تُوقَّع قبل مراجعة محامٍ مرخّص في المملكة العربية السعودية."
)
def draft_pilot_agreement_outline() -> dict[str, Any]:
"""Pilot Agreement outline (Arabic skeleton)."""
return {
"title_ar": "اتفاقية تجربة Pilot لخدمة Dealix",
"sections_ar": [
"الأطراف والتعريفات.",
"نطاق الـ Pilot ومدته (7 أيام).",
"المدخلات المطلوبة من العميل.",
"المخرجات المُتفق عليها (10 فرص + رسائل + Proof Pack).",
"السرية وعدم استخدام بيانات العميل لأغراض أخرى.",
"PDPL وحقوق الموضوعات (الأشخاص).",
"السعر وطريقة الدفع (Pilot أو case study).",
"إنهاء الاتفاقية والاستمرارية.",
"حدود المسؤولية.",
"القانون الواجب التطبيق والاختصاص.",
],
"approval_required": True,
"legal_review_required": True,
"not_legal_advice": True,
"disclaimer_ar": _DISCLAIMER_AR,
}
def draft_dpa_outline() -> dict[str, Any]:
"""Data Processing Addendum outline (Arabic skeleton, PDPL-aware)."""
return {
"title_ar": "ملحق معالجة البيانات (DPA)",
"sections_ar": [
"التعريفات حسب نظام حماية البيانات الشخصية السعودي (PDPL).",
"أدوار الأطراف (Controller / Processor).",
"أنواع البيانات والـ subjects.",
"أغراض المعالجة.",
"الإجراءات الأمنية المطبّقة.",
"نقل البيانات خارج المملكة (إن وُجد).",
"الاحتفاظ والإتلاف.",
"حقوق الموضوعات (طلبات الوصول/التصحيح/الحذف).",
"خرق البيانات والإبلاغ.",
"الـ subprocessors المعتمدون.",
"التدقيق والامتثال.",
],
"approval_required": True,
"legal_review_required": True,
"not_legal_advice": True,
"disclaimer_ar": _DISCLAIMER_AR,
}
def draft_referral_agreement_outline() -> dict[str, Any]:
"""Referral Agreement outline."""
return {
"title_ar": "اتفاقية إحالة (Referral)",
"sections_ar": [
"تعريف الـ Referrer والإحالة المؤهلة.",
"نموذج الـ revenue share (نسبة + مدة).",
"شروط الدفع وتاريخ الاستحقاق.",
"السرية.",
"عدم الإغراء (no-poach اختيارية).",
"سياسات PDPL لمشاركة بيانات الـ leads.",
"إنهاء الاتفاقية.",
],
"approval_required": True,
"legal_review_required": True,
"not_legal_advice": True,
"disclaimer_ar": _DISCLAIMER_AR,
}
def draft_agency_partner_outline() -> dict[str, Any]:
"""Agency Partner Agreement outline (white-label/co-branded)."""
return {
"title_ar": "اتفاقية شريك وكالة لـ Dealix",
"sections_ar": [
"هيكل الشراكة (revenue share / setup fee / co-branding).",
"نطاق الخدمات المقدّمة من الوكالة لعملائها.",
"Proof Packs مشتركة العلامة.",
"حقوق الملكية الفكرية.",
"السرية والـ NDAs.",
"PDPL ونقل البيانات بين Dealix والوكالة.",
"حدود المسؤولية والـ SLA.",
"إنهاء الاتفاقية وتسليم العملاء.",
],
"approval_required": True,
"legal_review_required": True,
"not_legal_advice": True,
"disclaimer_ar": _DISCLAIMER_AR,
}
def draft_scope_of_work() -> dict[str, Any]:
"""Generic Scope-of-Work outline."""
return {
"title_ar": "نطاق العمل (SOW)",
"sections_ar": [
"ملخص الخدمة.",
"المدخلات المطلوبة من العميل.",
"المخرجات والـ deliverables.",
"الجدول الزمني والـ milestones.",
"المسؤوليات والـ approvals.",
"السعر وطريقة الدفع.",
"حدود نطاق العمل وما خارجه.",
"تغييرات النطاق (Change Requests).",
"معايير القبول (Acceptance Criteria).",
],
"approval_required": True,
"legal_review_required": True,
"not_legal_advice": True,
"disclaimer_ar": _DISCLAIMER_AR,
}