system-prompts-and-models-of-ai-tools/dealix/docs/INTELLIGENCE_LAYER_STRATEGY.md

Intelligence Layer Strategy — الشبكة العصبية للنمو

(Dealix Growth Neural Network)

الهدف: تحويل Dealix من "منصة multi-channel" إلى شبكة عصبية للنمو تتعلم من قرارات صاحب النشاط، تستخرج DNA الإيرادات، وتعمل ميشنات نمو ذاتية بدلاً من الانتظار للمستخدم.

---

1. لماذا Intelligence Layer؟

Platform Services أعطتنا القنوات + الأمان + الـledgers. لكن:

• لا تتذكر ما يفضله المستخدم.
• لا تستخرج رؤى من الفائزين/الخاسرين.
• لا تقترح بطاقات قرار جاهزة كل صباح.
• لا تحاكي قبل ما ترسل.

Intelligence Layer هي الطبقة التي تجعل المنصة "تشتغل لوحدها أثناء نوم المستخدم".

---

2. الوحدات (10 modules)

#	الوحدة	الدور
1	growth_brain	Brain لكل عميل: قطاع، قنوات، أهداف، تفضيلات، مؤشرات. is_ready_for_autopilot().
2	command_feed	بطاقات قرار يومية بالعربي (opportunity / revenue_leak / partner_suggestion / meeting_prep / review_response / competitive_move).
3	action_graph	رسم بياني للنوع: signal → action → outcome (10 أنواع حواف).
4	mission_engine	7 ميشنات نمو، أهمها Kill Feature: "10 فرص في 10 دقائق".
5	decision_memory	يتعلم من Accept / Skip / Edit / Block ويخرج preferences.
6	trust_score	مقياس مركّب لكل رسالة (source + opt_in + channel + content + freq + approval).
7	revenue_dna	يستخرج: أفضل قناة، أفضل segment، أفضل angle، أكثر اعتراض، متوسط دورة البيع.
8	opportunity_simulator	محاكي إلى الأمام: target_count → expected_replies/meetings/deals/pipeline_sar.
9	competitive_moves	رصد + رد على حركات المنافسين (price_change / new_offer / hire / funding / launch...).
10	board_brief	Founder Shadow Board — موجز أسبوعي: قرارات، فرص، مخاطر، علاقة، تجربة، مؤشر.

---

3. Growth Brain

build_growth_brain(payload) يبني سجل لكل عميل:

customer_id, sector, regions, channels_connected,
preferred_tone, growth_priorities,
learning_signal_count, accept_rate_30d

الجاهزية للأوتوبايلوت:

ready = (learning_signal_count ≥ 30)
      AND (accept_rate_30d ≥ 0.40)
      AND (≥ 1 قناة موصولة)

قبل الجاهزية → draft + approval فقط.

---

4. Command Feed (يومي)

بطاقات بالعربي مع ≤3 أزرار، 9 أنواع:

opportunity, revenue_leak, partner_suggestion,
meeting_prep, review_response, ai_visibility_alert,
competitive_move, customer_reactivation, action_required

build_command_feed_demo() يرجع 6 بطاقات تجريبية واقعية.

---

5. Action Graph

أنواع الحواف الـ10:

signal_created_opportunity, message_triggered_reply,
reply_led_to_meeting, meeting_led_to_proposal,
proposal_led_to_payment, partner_suggestion_taken,
review_response_recovered_customer, approval_allowed_send,
blocked_action_prevented_risk, content_generated_lead

what_works_summary(customer_id) يُرجع: مجموع الحواف + توزيعها بالنوع → "ما الذي يعمل فعلاً".

---

6. Mission Engine — 7 ميشنات

ID	الاسم	ملاحظات
first_10_opportunities ⭐	10 فرص في 10 دقائق	Kill Feature — يبدأ من 0 ويُسلم 10 leads بالعربي قبل أن يعتاد المستخدم على المنصة.
revenue_leak_rescue	استعادة الإيرادات المتسربة	عملاء توقفوا، فواتير معلقة.
partnership_sprint	سبرنت شراكات	Partner Graph — اقتراحات تكامل.
customer_reactivation	إعادة تنشيط عملاء	فترة سكون → رسالة دافئة.
meeting_booking_sprint	حجز اجتماعات	drafts للجدولة + اعتماد.
ai_visibility_sprint	Answer Engine Optimization	ظهور النشاط في Perplexity / ChatGPT / Gemini.
competitive_response	الرد على حركات المنافسين	يُفعّل عند رصد price_change / launch / funding.

recommend_missions(brain, limit=3) يرتّب بحسب توافق القطاع + القنوات + الأولويات.

---

7. Decision Memory

يتعلم من 4 قرارات: accept / skip / edit / block.

preferences() يُرجع:

accept_rate, samples,
preferred_channels, preferred_tones, preferred_sectors,
rejected_action_types

يستخدمها mission_engine لرفع/خفض ترتيب البطاقات → الـ "warm-up" loop.

---

8. Trust Score

نتيجة 0..100 + verdict (safe ≥70 / needs_review 40-69 / blocked <40).

العوامل:

• source_quality (customer / opt_in_lead / referral / cold / unknown).
• opt_in (boolean).
• channel risk (whatsapp risk أعلى من email).
• محتوى الرسالة (عبارات محظورة: "ضمان 100%", "آخر فرصة"...).
• frequency_count_this_week vs weekly_cap.
• approval_status.

تطبيق فوري: قبل أي tool_gateway.invoke_tool → بطاقة في الـCommand Feed بدلاً من الإرسال.

---

9. Revenue DNA

extract_revenue_dna(customer_id, won_deals, replies, objections) يُرجع:

best_channel, best_segment, best_message_angle,
common_objection, avg_cycle_days,
deals_observed, next_experiment_ar

استعمال: ميشن revenue_dna_demo يُري المالك "هذا ما يفوز فعلاً عندك".

---

10. Opportunity Simulator

simulate_opportunity(target_count, sector, avg_deal_value_sar, channel, cold_pct, quality_lift):

يُرجع:

expected_replies, expected_meetings, expected_deals,
expected_pipeline_sar, risk_score (0..100),
risks_ar, rates_used, approval_required=True

9 قطاعات سعودية مهيّأة (real_estate, saas, retail, food, education, healthcare, logistics, fintech, contracting).

استعمال حرج: تحاكِ قبل ما تنفّذ → "مع 100 جهة، النتيجة المتوقعة 6 صفقات بقيمة 300K، مخاطرة PDPL متوسطة لو 60% بارد".

---

11. Competitive Moves

8 أنواع حركات: price_change, new_offer, new_hire, funding, launch, partnership, layoffs, expansion.

analyze_competitive_move(competitor_name, move_type, payload) → urgency + Arabic recommended_action + approval_required.

مثال: price_change بـ-25% → urgency high + اقتراح بطاقة "أرسل عرض مضاد للعملاء المترددين".

---

12. Board Brief — Founder Shadow Board

build_board_brief() يُرجع موجز أسبوعي:

decisions_required_ar (3),
top_opportunities_ar (3),
top_risks_ar (3),
key_relationship_ar,
experiment_to_run_ar,
metric_to_watch_ar,
money_summary

استعمال: ميل أسبوعي يومي الأحد 7:00 ص → "هذا ما يحتاج قراركم هذا الأسبوع، وهذا ما يكشفه الذكاء الاصطناعي".

---

13. Endpoints (/api/v1/intelligence/...)

POST /growth-brain/build
GET  /command-feed/demo
GET  /missions
POST /missions/recommend
POST /trust-score
GET  /revenue-dna/demo
POST /revenue-dna
POST /simulate-opportunity
POST /competitive-move/analyze
GET  /board-brief/demo
POST /decisions/record
GET  /decisions/preferences

---

14. اختبارات

tests/unit/test_intelligence_layer.py — تغطية لكل الوحدات الـ10:

• growth brain autopilot threshold
• command feed Arabic + ≤3 buttons + critical types
• action graph add/summary + unknown edge type raises
• missions list + kill feature + recommend
• decision memory records/aggregates/empty/invalid
• trust score (cold blocked, safe, risky phrases, freq cap lowers)
• revenue DNA best channel + defaults
• simulator pipeline + cold_pct warning + unknown sector default
• competitive move urgency + unknown type + funding action
• board brief structure (3 من كل: قرار/فرصة/مخاطرة)

---

15. ما لا تفعله هذه الطبقة

• لا ترسل أي شيء فعلياً (تحت سقف tool_gateway).
• لا تتجاوز سياسات platform_services.
• لا تستخدم بيانات بدون consent.
• لا تنفذ ميشن بدون اعتماد المالك (إلا بعد is_ready_for_autopilot()).

---

16. الاندماج مع Platform Services

Platform Services        Intelligence Layer
────────────────         ────────────────────
event_bus           ←→   action_graph (يستهلك الأحداث)
identity            ←→   growth_brain (هوية → سياق)
channel_registry    ←→   simulator (rates_used per channel)
action_policy       ←→   trust_score (verdict → policy gate)
tool_gateway        ←→   command_feed (cards تُنفّذ عبر gateway)
unified_inbox       ←→   command_feed (نفس البنية، طبقة أعلى)
action_ledger       ←→   decision_memory (يقرأ الـledger)
proof_ledger        ←→   board_brief (money_summary مصدره proof)
service_catalog     ←→   mission_engine (الميشنات → خدمات قابلة للبيع)

---

17. الـ Kill Feature

"10 فرص في 10 دقائق" — first_10_opportunities:

1. عند بدء العميل، نسأل: قطاع + منطقة + قناة مفضلة.
2. خلال 10 دقائق نُسلم 10 بطاقات opportunity بالعربي مع recommended_action_ar.
3. كل بطاقة draft → اعتماد → تنفيذ.
4. إذا قبل المالك ≥4 → نزيد signal_count + accept_rate → نقترب من autopilot.

هذه الميزة تكسر "blank canvas problem" وتُري قيمة فورية قبل أن يفتح المستخدم WhatsApp Web.

---

18. ما يلي

• ربط command_feed بإشارات حقيقية (Gmail / WA Business / GBP / website forms).
• استبدال الـin-memory _MEMORY بـ Supabase.
• جدولة board_brief يوم الأحد 7 ص (Cron + email/WhatsApp).
• شحن أول 100 عميل تحت "Approval-First" لجمع أول 3,000 قرار → تدريب decision_memory الحقيقي.