system-prompts-and-models-o.../docs/AUTOMATED_REVENUE_ENGINE_AR.md
Sami Assiri 1ceeea9004 feat(tier1): finalize production activation and revenue execution pack
Complete Tier-1 closure follow-through by wiring docs governance gates, RC release readiness checks, source-of-truth enforcement, executive weekly contract surface, and go-live severity notes.
Add full go-live revenue execution documentation set (production activation, real production playbook, trust expansion, first 3 clients, live deployment, and automated revenue engine) and register all canonical paths.

Made-with: Cursor
2026-04-17 14:13:57 +03:00

4.6 KiB

version owner status review_cadence last_updated related
1.0 Growth + Platform canonical عند إضافة قناة inbound جديدة أو تغيير سياسة الـ outreach 2026-04-16
GO_LIVE_REVENUE_ACTIVATION_SYSTEM_AR.md
FIRST_THREE_CLIENTS_PLAN_AR.md
outreach_engine API (backend)

محرك إيراد آلي (حدود واقعية + تنفيذ كامل)

«محرك إيراد آلي» هنا يعني: تسلسلًا مُهيكلًا من التقاط الاهتمام → التأهيل → جدولة → متابعة، مع بوابات بشرية حيث القانون أو المخاطرة يقتضيان ذلك — وليس إرسالًا جماعيًا بلا رقابة في السعودية أو أي سوق خاضع لـ PDPL/اشتراك.


1) المبادئ (غير قابلة للتفاوض)

  1. الموافقة والاشتراك: لا رسائل بلا opt-in حيث يلزم القانون.
  2. PDPL: أي مسار يعرّض بيانات شركة/أشخاص يمرّ بتصنيف وحقول حوكمة — انظر proposals.py وpdpl-nca-ai-control-matrices.md.
  3. الحد من الإزعاج: حدود يومية/أسبوعية + قائمة عدم الاتصال.
  4. أثر قابل للقياس: كل خطوة تُسجَّل (CRM أو جدول) لربط الإنفاق بالإيراد لاحقًا.

2) مخطط التدفق (منطقي)

flowchart LR
  inbound[Inbound_capture] --> qualify[Qualify_score]
  qualify --> route[Route_owner]
  route --> humanGate{Human_approval_for_send}
  humanGate -->|yes| outreach[Outreach_API]
  humanGate -->|no| nurture[Nurture_queue]
  outreach --> log[Audit_log]
  nurture --> log

3) مصادر الإدخال (Capture)

المصدر تنفيذ
نماذج ويب / landing توجيه إلى CRM أو جدول leads مع timestamp ومصدر
استيراد قائمة تنظيف + إزالة تكرار + عدم إرسال لمن لم يوافق
حدث يدوي (معرض، مكالمة) تسجيل في نفس النموذج

4) التأهيل (Qualify)

  • استخدام حقول Lead (حجم، قطاع، نضج شراكة) إن وُجدت في النموذج.
  • عتبة: فقط من يمرّ بعتبة الدخول إلى قائمة اتصال بشري أو إلى قالب رسالة معتمد.

5) التنفيذ الآلي المسموح (Outreach API)

الكود المرجعي: outreach_engine.py — مسارات مثل:

  • POST .../outreach-engine/send
  • POST .../outreach-engine/campaign/launch
  • GET .../outreach-engine/log

قاعدة: أي إرسال جماعي يمرّ بـ:

  1. مراجعة نص القالب (إصدار ثابت).
  2. حد أعلى لعدد المستلمين لكل دفعة.
  3. تسجيل النتيجة في log / مراقبة.

6) البوابة البشرية (Human-in-the-loop)

قبل أول إرسال لقائمة جديدة:

  • موافقة داخلية (Slack/email مسجّل) أو موافقة Class B حيث السياسة تفرض ذلك على «التزام خارجي».

7) المتابعة (Cadence)

بعد الإرسال فعل
يوم 2 متابعة قصيرة
يوم 5 قيمة إضافية (رابط case أو مقياس)
يوم 10 إغلاق المحاولة أو تحويل لـ nurture

استخدم نفس النصوص المرجعية في FIRST_THREE_CLIENTS_PLAN_AR.md.


8) القياس (Funnel)

  1. Lead captured
  2. Qualified
  3. Meeting booked
  4. Pilot offered
  5. Pilot signed
  6. Paid

اربط كل مرحلة بمصدر حقيقة (CRM field أو log id).


9) ما لا يُسمى «أتمتة» هنا

  • شراء قوائم بريدية غير موافَق عليها.
  • إرسال مخفي عبر قنوات تخرق سياسة المنصة.
  • «AI يغلق الصفقة» بدون إنسان — خارج النطاق التشغيلي الآمن.

10) التوسع التقني (لاحقًا)

  • Webhooks من نماذج إلى طابور (queue) ثم عامل workers — عند الحاجة للحجم.
  • مزامنة ثنائية مع CRM — بعد أول عميل مدفوع.

هذا المستند يحدّ السلوك الآمن والقابل للقياس؛ يلتزم فريق المنتج والقانون بتعديله عند تغيير السياسات.