4e969131c7
Platform Services Layer (10 modules) — برج التحكم بالنمو - event_bus: 27 typed events (whatsapp/email/calendar/lead/payment/review/social/partner/sheet/crm/action) - identity_resolution: cross-channel merge (phone+email+CRM+social) with confidence scoring - channel_registry: 11 channels (WA, Gmail, Calendar, Moyasar, LinkedIn, X, IG, GBP, Sheets, CRM, Forms) with capabilities/risk/PDPL notes - action_policy: 9 rules (block_cold_whatsapp, block_payment_no_confirm, block_secrets, external_send_needs_approval, calendar_insert_needs_approval, social_dm_needs_explicit, unknown_source_review, high_value_deal_review, draft_only_safe) - tool_gateway: single execution chokepoint, env-flag-gated live actions (default OFF) - unified_inbox: 8 card types, ≤3 buttons enforced, Arabic - action_ledger: requested→approved→executed audit trail - proof_ledger: leads/meetings/drafts/sends/payments/revenue/risks_blocked/time_saved per channel - service_catalog: 12 sellable services - router api/routers/platform_services.py — 13 endpoints under /api/v1/platform/ Intelligence Layer (10 modules) — الشبكة العصبية للنمو - growth_brain: per-customer Brain + is_ready_for_autopilot() (≥30 signals + ≥40% accept) - command_feed: 9 daily card types (opportunity/revenue_leak/partner_suggestion/meeting_prep/review_response/competitive_move/customer_reactivation/ai_visibility_alert/action_required) - action_graph: 10 typed edges (signal→action→outcome) with what_works_summary - mission_engine: 7 missions, KILL FEATURE first_10_opportunities (10 فرص في 10 دقائق) - decision_memory: learns from accept/skip/edit/block, returns preferences (channels, tones, sectors, rejected actions, accept_rate) - trust_score: composite 0-100 (source+opt_in+channel+content+freq+approval) → safe/needs_review/blocked - revenue_dna: best_channel/segment/angle + common_objection + avg_cycle_days - opportunity_simulator: 9 Saudi sectors, expected_replies/meetings/deals/pipeline_sar + risk_score - competitive_moves: 8 move types with Arabic recommended_action_ar - board_brief: weekly Founder Shadow Board (3 decisions + 3 opportunities + 3 risks + relationship + experiment + metric) - router api/routers/intelligence_layer.py — 12 endpoints under /api/v1/intelligence/ Tests - tests/unit/test_platform_services.py — 31 tests covering catalog/channels/events/policy/gateway/identity/inbox/ledger/proof - tests/unit/test_intelligence_layer.py — 29 tests covering brain/feed/graph/missions/memory/trust/dna/simulator/competitive/brief - 60/60 new tests pass; full suite 587 passed, 2 skipped Docs - docs/PLATFORM_SERVICES_STRATEGY.md (Arabic) - docs/INTELLIGENCE_LAYER_STRATEGY.md (Arabic) - docs/DEALIX_100_PERCENT_LAUNCH_PLAN.md — added §32 Platform Services + §33 Intelligence Layer Safety - No live send by default (all WA/Gmail/Calendar/Moyasar guarded by env flags, all OFF) - All external actions go through Tool Gateway → Action Policy → draft/approval_required - No secrets allowed in payloads (block_secrets policy) - PDPL-aware: cold WhatsApp without consent is hard-blocked - Existing 477+ tests untouched (no breaking changes) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
10 KiB
Dealix — تقرير الإطلاق الشامل (100٪ جاهزية) — مرجع رئيسي
هذا المستند يجمع: الحالة، الفجوات، المنعطفات، والخطط 30/90 يوماً، وأين ينفّذ كل عمل (Cursor / Claude / Supabase / السحابة / واتساب / Google).
1. الحالة الحالية
فرع dealix-v3-autonomous-revenue-os مع أساس v3 + Personal Operator + وثائق + اختبارات + طبقة أعمال وAPI (/api/v1/business/*).
2. ما بُني
Revenue memory تجريبية، وكلاء آمنون، رادار، امتثال، علوم إيرادات، ذاكرة مشروع (هجرة + فهرسة محلية)، مشغّل عربي، بطاقات واتساب (payload فقط)، تقارير جاهزية، نموذج أعمال ووثائق GTM.
3. الناقص تقنياً
OAuth كامل، إرسال واتساب فعلي، رفع embeddings إنتاجي، فوترة self-serve كاملة، بعض مسارات onboarding كـ API.
4. ما يمنع البيتا الخاصة
غياب بيئة staging ثابتة + تجربة واتساب موقعة + 3–5 عملاء باتفاق واضح.
5. ما يمنع الإطلاق العام
PDPL تشغيلية، فوترة، دعم، SLOs، أمان مستقل، صفحة تسعير عامة متسقة مع الشروط القانونية.
6. قائمة إطلاق تقني
اختبارات، مراقبة، نسخ احتياطي، RLS مراجَأ، مفاتيح service role معزولة.
7. قائمة إطلاق منتج
onboarding، proof pack تلقائي، قنوات، سياسات، لقطات UI.
8. قائمة إطلاق أعمال
تسعير، عقود أداء، شركاء، قصص نجاح.
9. قائمة إطلاق GTM
قائمة 10، محتوى، webinars، إحالات.
10. قائمة امتثال
سجل موافقات، تصدير/حذف، قمع، سياسة واتساب.
11. نموذج مالي (مبدئي)
اشتراكات + إعداد + أداء (عقدي) — أرقام توضيحية في /api/v1/business/unit-economics/demo.
12. التسعير
docs/PRICING_STRATEGY.md + /api/v1/business/pricing.
13. أول 10 عملاء
docs/GTM_PLAYBOOK.md + /api/v1/business/gtm/first-10.
14. أول 100 عميل
/api/v1/business/gtm/first-100.
15. سكربتات مبيعات
/api/v1/business/sales-script.
16. سكربت تجربة (Demo)
Command center + رادار + فرصة + مسودة + موافقة.
17. عرض pilot
7 أيام أو أسبوعان مع proof pack — انظر كتيب GTM.
18. مقاييس النجاح
/api/v1/business/metrics.
19. سجل المخاطر
امتثال واتساب، توقعات AI، جودة البيانات، تعقيد المنتج، منافسة، تعقيد الشراكات.
20. خطة 30 يوماً
أسبوع 1: staging + 5 مكالمات اكتشاف.
أسبوع 2: 3 pilots موقعة.
أسبوع 3: proof packs.
أسبوع 4: قرار التوسع أو تصحيح ICP.
21. خطة 90 يوماً
10 عملاء، قصص، تكامل واتساب إنتاجي بحذر، embeddings، تحسين المنتج.
22. ماذا يفعل سامي على الكمبيوتر
Cursor + GitHub + Supabase + Railway/Render + Postman/Bruno + إعداد Meta WhatsApp + Google Cloud للـ OAuth.
23. ماذا يبقى في محادثات الاستراتيجية (ChatGPT وغيره)
عصف ذهني للرسائل، مراجعة شرائح، سيناريوهات تفاوض — من دون تعديل الكود.
24. ماذا في Cursor
تنفيذ، refactor آمن، اختبارات، وثائق ريبو، PRs.
25. ماذا في Claude Code (إن استخدمته)
مهام طويلة موازية أو مسودات وثائق خارج الريبو — مع مزامنة يدوية للريبو.
26. ماذا في Supabase
هجرة، RLS، jobs للـ embeddings، بيئات منفصلة.
27. ماذا في Railway/Render
نشر API، secrets، مراقبة أساسية.
28. ماذا في WhatsApp Cloud
أرقام هوية، قوالب، webhook، توقيع، اختبار sandbox.
29. ماذا في Google Cloud
OAuth Gmail/Calendar، حصص، سياسات.
30. درجة الجاهزية الإجمالية
استدعِ GET /api/v1/personal-operator/launch-report — الرقم ديناميكي من النموذج الحالي؛ لا يُعتبر ضماناً تنبؤياً حتى تُربط ببيانات إنتاج وCI.
31. Innovation Roadmap (طبقة «Autonomous Growth Factory»)
ما يُنفَّذ الآن في الريبو (MVP موثّق + API تجريبية deterministic):
- وثيقة
INNOVATION_STRATEGY.md— ٢٠ مفهوماً مع MVP مقابل تأجيل ومقاييس ومخاطر، ومقارنة موجزة مع Gong/Clari/People.ai. - مسارات تحت
GET|POST /api/v1/innovation/*: Command Feed demo وlive (من DB مع fallback)، Growth Missions، ten-in-ten، AEO radar demo، Experiments (معpast_experiments)، Proof Ledger demo + أحداث دائمة + تقرير أسبوعي، Deal Room analyze — منطق فيauto_client_acquisition/innovation/بدون LLM داخل هذه الطبقة وبدون إرسال حي من مسارات الابتكار.
مراحل التمييز (معايير جاهزية):
| مرحلة | مخرجات | معيار «جاهز للعرض» |
|---|---|---|
| A — تمييز قابل للعرض | POST .../opportunities/ten-in-ten، GET .../aeo/radar/demo، فقرة مقارنة عالمية في الوثيقة |
يعمل في staging مع pytest أخضر |
| B — ذاكرة تشغيلية | جدول proof_ledger_events، GET .../proof-ledger/events، GET .../proof-ledger/report/week، GET .../command-feed/live |
أحداث تُسجَّل وتظهر في الـ feed أو التقرير لعميل pilot |
| C — تخصيص | past_experiments في POST .../experiments/recommend |
على الأقل قاعدة قواعد تنعكس في التوصيات من تاريخ عميل واحد |
ما يُؤجَّل إلى ما بعد البيانات والتشغيل:
- AEO حقيقي (استعلامات خارجية دورية)، Deal Graph كامل في DB، مسارات LangGraph متينة، MCP gateway، Partner Marketplace خارجي، تقارير PDF مؤتمتة من الـ Ledger.
Kill feature — «10 فرص في 10 دقائق»
وعد منتجي مركزي: من مدخلات شركة/قطاع/مدينة/عرض/هدف إلى قائمة ١٠ فرص مع Why Now ومستوى مخاطرة ومسودات عربية بانتظار الموافقة فقط — POST /api/v1/innovation/opportunities/ten-in-ten؛ وصف المهمة في GET /api/v1/innovation/growth-missions؛ الاستراتيجية في INNOVATION_STRATEGY.md؛ الإطار التشغيلي بجانب GET /api/v1/business/gtm/first-10 عند التوسع.
32. Platform Services Layer — برج التحكم بالنمو
طبقة موحدة multi-channel فوق growth_operator تحوّل Dealix من قناة WhatsApp إلى منصة:
- 11 قناة (
whatsapp, gmail, google_calendar, moyasar, linkedin_lead_forms, x_api, instagram_graph, google_business_profile, google_sheets, crm, website_forms). - Action Policy Engine: block_cold_whatsapp / block_payment_no_confirm / block_secrets / external_send_needs_approval / high_value_deal_review.
- Tool Gateway هو المخرج التنفيذي الوحيد — كل أداة تمر منه. Live env flags افتراضياً OFF.
- Unified Inbox: 8 أنواع بطاقات، ≤3 أزرار، عربية.
- Action Ledger + Proof Ledger (أثر فعلي مقاس بالقناة).
- 12 خدمة قابلة للبيع (
growth_operator_subscription,channel_setup_service,lead_intelligence_service,partnership_sprint,email_revenue_rescue,social_growth_os,local_business_growth,ai_visibility_aeo_sprint,revenue_proof_pack_service,customer_success_operator,payments_collections_operator,outreach_approval_service).
Endpoints: /api/v1/platform/{services/catalog, channels, policy/rules, actions/evaluate, tools/invoke, events/ingest, inbox/feed, identity/resolve, ledger/summary, proof-ledger/demo}. التفصيل: PLATFORM_SERVICES_STRATEGY.md.
33. Intelligence Layer — الشبكة العصبية للنمو
طبقة فوق Platform Services تجعل Dealix يتعلم ويقترح ويحاكي:
- Growth Brain لكل عميل +
is_ready_for_autopilot()(≥30 signals + ≥40% accept). - Command Feed: 9 أنواع بطاقات يومية (opportunity / revenue_leak / partner_suggestion / meeting_prep / review_response / competitive_move / customer_reactivation / ai_visibility_alert / action_required).
- Action Graph (10 أنواع حواف): signal → action → outcome.
- Mission Engine: 7 ميشنات، Kill Feature:
first_10_opportunities. - Decision Memory: تعلّم من Accept/Skip/Edit/Block.
- Trust Score مركب لكل رسالة (safe ≥70 / needs_review 40-69 / blocked <40).
- Revenue DNA: best_channel / best_segment / best_angle / common_objection / avg_cycle_days.
- Opportunity Simulator (9 قطاعات سعودية): توقع replies/meetings/deals/pipeline_sar + risk_score.
- Competitive Move Detector: 8 أنواع حركات + recommended_action_ar.
- Founder Shadow Board: موجز أسبوعي (3 قرارات + 3 فرص + 3 مخاطر + علاقة + تجربة + مؤشر).
Endpoints: /api/v1/intelligence/{growth-brain/build, command-feed/demo, missions, missions/recommend, trust-score, revenue-dna/demo, revenue-dna, simulate-opportunity, competitive-move/analyze, board-brief/demo, decisions/record, decisions/preferences}. التفصيل: INTELLIGENCE_LAYER_STRATEGY.md.
الخلاصة: المنتج قوي كأساس سوقي وتقني؛ الإطلاق العام يحتاج تشغيلاً وامتثالاً وتجربة عميل مغلقة أولاً.