system-prompts-and-models-o.../dealix/docs/SERVICE_TOWER_STRATEGY.md
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

137 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

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

# Service Tower Strategy — برج الخدمات الذاتي
> **الفكرة:** كل قدرة في Dealix تتحول إلى **Productized Service** بمواصفات: target customer + outcome + inputs + workflow + deliverables + pricing + risk + proof + upgrade path.
---
## 1. القاعدة الذهبية
**العميل لا يشتري ميزة. يشتري نتيجة منظمة.**
كل خدمة تمشي في نفس الـ pipeline:
```
Goal → Intake → Data Check → Risk Check → Strategy →
Drafts → Approval → Execution/Export → Tracking → Proof → Upsell
```
---
## 2. الـ12 خدمة (Productized)
| # | الخدمة | المدخلات | المخرجات | السعر |
|---|--------|----------|---------|-------|
| 1 | Free Growth Diagnostic | sector/city/offer/goal | 3 فرص + رسالة + مخاطر + خطة Pilot | 0 |
| 2 | List Intelligence | CSV + channels | تنظيف + أفضل 50 + رسائل | 4991,500 |
| 3 | First 10 Opportunities Sprint | sector/city/offer/goal | 10 فرص + رسائل + Proof Pack | 4991,500 |
| 4 | Self-Growth Operator | company profile + goals | Daily brief + drafts + reports | 999/شهر |
| 5 | Growth OS Monthly | channels + team_size | المنصة الكاملة شهرياً | 2,999/شهر |
| 6 | Email Revenue Rescue | gmail label + ICP | استخراج فرص ضائعة + drafts | 1,5005,000 |
| 7 | Meeting Booking Sprint | prospects + calendar | invitations + briefs + follow-ups | 1,5005,000 |
| 8 | Partner Sprint | sector + partner goal | 20 شريك + رسائل + 5 اجتماعات | 3,0007,500 |
| 9 | Agency Partner Program | agency profile | بيع Dealix لعملاء الوكالة | 10,00050,000 |
| 10 | WhatsApp Compliance Setup | contact list + practice | audit + opt-in templates + ledger | 1,5004,000 |
| 11 | LinkedIn Lead Gen Setup | ICP + offer + ad budget | حملة Lead Form + ربط CRM | 2,0007,500 |
| 12 | Executive Growth Brief | company profile | موجز يومي 3+3+3 | 499999/شهر |
---
## 3. الـ Wizard
```
العميل يجيب:
- نوع الشركة
- الهدف
- هل عندك قائمة؟
- ما القنوات المتاحة؟
- الميزانية
النظام يوصي بخدمة واحدة + يبرر القرار.
```
ترتيب القرارات:
1. وكالة → Partner Sprint / Agency Program.
2. عنده قائمة → List Intelligence.
3. مؤسس → Self-Growth Operator.
4. CEO → Executive Growth Brief.
5. واتساب → Compliance Setup.
6. هدف rescue → Email Revenue Rescue.
7. هدف اجتماعات → Meeting Booking Sprint.
8. هدف شراكات → Partner Sprint.
9. ميزانية شهرية ≥ 2999 → Growth OS.
10. الافتراضي → First 10 Opportunities.
---
## 4. WhatsApp CEO Control
كل قرار يصل المؤسس عبر واتساب كـ كرت:
- Daily Service Brief (≤3 buttons).
- Service Approval Card (`اعتمد / عدّل / ارفض`).
- Risk Alert Card.
- End-of-Day Report.
---
## 5. Pricing Engine
ضرّابات السعر:
- `company_size`: micro 0.8x, small 1.0x, medium 1.3x, large 1.7x.
- `urgency`: normal 1.0x, rush 1.3x, asap 1.5x.
- `channels_count`: +15% لكل قناة إضافية.
Setup fee = month-equivalent للـ monthly services. السنوي بخصم 15%.
---
## 6. Upgrade Paths
```
Free Diagnostic → First 10 Opportunities → Growth OS Monthly → Agency Partner
List Intelligence → Growth OS Monthly
Self-Growth Operator → Growth OS Monthly
Email Revenue Rescue → Growth OS Monthly
Partner Sprint → Agency Partner Program
```
كل upgrade path له upsell message عربي جاهز.
---
## 7. Endpoints (`/api/v1/services/...`)
```
GET /catalog
GET /summary
POST /recommend
GET /{id}/intake-questions
POST /{id}/start
GET /{id}/workflow
GET /{id}/deliverables
GET /{id}/proof-pack-template
GET /{id}/client-report-outline
GET /{id}/operator-checklist
POST /{id}/quote
GET /{id}/setup-fee
GET /{id}/monthly-offer
POST /{id}/scorecard
GET /{id}/upgrade-path
GET /{id}/post-service-plan
GET /ceo/daily-brief
POST /ceo/approval-card
GET /ceo/risk-alert/demo
GET /ceo/end-of-day/demo
```
---
## 8. اختبارات
`tests/unit/test_service_tower.py` — 38 اختبار:
- Catalog ≥12 خدمة + critical services.
- Pricing + proof metrics + deliverables موجودة.
- Wizard recommendations (agency, list, founder, CEO, budget).
- Workflow includes approval.
- Quote scaling by size.
- CEO cards ≤3 buttons + لا live send.
- Upgrade paths.