system-prompts-and-models-o.../dealix/auto_client_acquisition/targeting_os/__init__.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

178 lines
5.7 KiB
Python

"""Targeting & Acquisition OS — يستهدف بذكاء، يقيّم المخاطر، يقترح القنوات.
Account-first targeting (شركات قبل أشخاص) + buying-committee mapping +
contactability gate + multi-channel strategy + reputation guard +
daily autopilot + self-growth mode + free diagnostic + contract drafts.
كل شيء deterministic، عربي، draft/approval-first، لا scraping ولا cold WA.
"""
from __future__ import annotations
from .account_finder import (
AccountSignal,
explain_why_now,
rank_accounts,
recommend_account_source_strategy,
recommend_accounts,
score_account_fit,
)
from .acquisition_scorecard import (
build_acquisition_scorecard,
calculate_meetings_booked,
calculate_pipeline_created,
calculate_productivity_score,
calculate_risks_blocked,
)
from .buyer_role_mapper import (
ALL_BUYER_ROLES,
draft_role_based_angle,
map_buying_committee,
recommend_decision_maker_roles,
recommend_influencer_roles,
)
from .contact_source_policy import (
ALL_SOURCES,
allowed_channels_for_source,
classify_source,
required_review_level,
retention_recommendation,
source_risk_score,
)
from .contactability_matrix import (
ACTION_MODES,
BLOCK_REASONS,
allowed_action_modes,
block_reason_codes,
evaluate_contactability,
explain_contactability_ar,
)
from .contract_drafts import (
draft_agency_partner_outline,
draft_dpa_outline,
draft_pilot_agreement_outline,
draft_referral_agreement_outline,
draft_scope_of_work,
)
from .daily_autopilot import (
build_daily_targeting_brief,
build_end_of_day_report,
prioritize_cards,
recommend_today_actions,
)
from .email_strategy import (
build_followup_sequence,
draft_b2b_email,
include_unsubscribe_footer,
recommend_pacing,
score_email_risk,
)
from .free_diagnostic import (
analyze_uploaded_list_preview,
build_free_growth_diagnostic,
build_mini_proof_plan,
recommend_paid_pilot_offer,
)
from .linkedin_strategy import (
build_lead_gen_form_plan,
build_manual_research_task,
build_safe_connection_message,
linkedin_do_not_do,
recommend_linkedin_strategy,
)
from .outreach_scheduler import (
build_outreach_plan,
enforce_daily_limits,
schedule_followups,
stop_on_opt_out,
summarize_plan_ar,
)
from .reputation_guard import (
calculate_channel_reputation,
recommend_recovery_action,
risk_thresholds,
should_pause_channel,
summarize_reputation_ar,
)
from .self_growth_mode import (
build_dealix_self_growth_plan,
build_free_service_offer,
build_self_growth_daily_brief,
build_weekly_learning_report,
recommend_dealix_targets,
)
from .service_offers import (
build_offer_card,
estimate_service_price,
list_targeting_services,
recommend_service_offer,
)
from .social_strategy import (
build_social_listening_plan,
draft_public_reply,
recommend_social_sources,
social_do_not_do,
)
from .whatsapp_strategy import (
build_opt_in_request_template,
draft_whatsapp_message,
requires_opt_in,
score_whatsapp_risk,
whatsapp_do_not_do,
)
__all__ = [
# account_finder
"AccountSignal", "explain_why_now", "rank_accounts",
"recommend_account_source_strategy", "recommend_accounts", "score_account_fit",
# acquisition_scorecard
"build_acquisition_scorecard", "calculate_meetings_booked",
"calculate_pipeline_created", "calculate_productivity_score",
"calculate_risks_blocked",
# buyer_role_mapper
"ALL_BUYER_ROLES", "draft_role_based_angle", "map_buying_committee",
"recommend_decision_maker_roles", "recommend_influencer_roles",
# contact_source_policy
"ALL_SOURCES", "allowed_channels_for_source", "classify_source",
"required_review_level", "retention_recommendation", "source_risk_score",
# contactability_matrix
"ACTION_MODES", "BLOCK_REASONS", "allowed_action_modes",
"block_reason_codes", "evaluate_contactability", "explain_contactability_ar",
# contract_drafts
"draft_agency_partner_outline", "draft_dpa_outline",
"draft_pilot_agreement_outline", "draft_referral_agreement_outline",
"draft_scope_of_work",
# daily_autopilot
"build_daily_targeting_brief", "build_end_of_day_report",
"prioritize_cards", "recommend_today_actions",
# email_strategy
"build_followup_sequence", "draft_b2b_email",
"include_unsubscribe_footer", "recommend_pacing", "score_email_risk",
# free_diagnostic
"analyze_uploaded_list_preview", "build_free_growth_diagnostic",
"build_mini_proof_plan", "recommend_paid_pilot_offer",
# linkedin_strategy
"build_lead_gen_form_plan", "build_manual_research_task",
"build_safe_connection_message", "linkedin_do_not_do",
"recommend_linkedin_strategy",
# outreach_scheduler
"build_outreach_plan", "enforce_daily_limits",
"schedule_followups", "stop_on_opt_out", "summarize_plan_ar",
# reputation_guard
"calculate_channel_reputation", "recommend_recovery_action",
"risk_thresholds", "should_pause_channel", "summarize_reputation_ar",
# self_growth_mode
"build_dealix_self_growth_plan", "build_free_service_offer",
"build_self_growth_daily_brief", "build_weekly_learning_report",
"recommend_dealix_targets",
# service_offers
"build_offer_card", "estimate_service_price",
"list_targeting_services", "recommend_service_offer",
# social_strategy
"build_social_listening_plan", "draft_public_reply",
"recommend_social_sources", "social_do_not_do",
# whatsapp_strategy
"build_opt_in_request_template", "draft_whatsapp_message",
"requires_opt_in", "score_whatsapp_risk", "whatsapp_do_not_do",
]