b13cb389cc
- API routers, ACA modules, integrations (draft operators) - Docs, landing pages, scripts (launch readiness, scorecard) - Tests and CI workflow updates for Dealix Co-authored-by: Cursor <cursoragent@cursor.com>
4.2 KiB
استراتيجية Platform Services — Growth Control Tower
الهدف
طبقة موحّدة تحت /api/v1/platform/* تجمع: أحداث موحّدة، سياسة قنوات، بوابة أدوات بدون إرسال حي، Inbox موحّد (بطاقات عربية)، سجل قرارات، وتلخيص Proof متوافق مع auto_client_acquisition/innovation/proof_ledger.py — دون تكرار «مصدر الحقيقة» للأحداث الدائمة في DB.
مكوّنات الكود
| وحدة | مسؤولية |
|---|---|
event_bus |
أنواع أحداث + تحقق من الحقول الإلزامية (يشمل أنماطاً موسّعة مثل email.received, payment.paid, review.created) |
channel_registry |
قدرات القناة، beta_status, allowed_actions, blocked_actions, risk_level |
action_policy |
قواعد deterministic: إرسال خارجي → موافقة؛ واتساب بارد → محظور؛ دفع → تأكيد؛ مصدر غير معروف → مراجعة |
tool_gateway |
لا شبكة ولا live — draft_created / blocked / approval_required / unsupported |
unified_inbox |
تحويل حدث → بطاقة (title_ar, summary_ar, أزرار ≤ 3)؛ يمكن دمج لمسات من build_demo_command_feed كمرجع عرض |
action_ledger |
سجل قرارات in-memory في MVP (قابل للاستبدال بـ DB) |
proof_summary |
تلخيص يستند إلى build_demo_proof_ledger() |
service_catalog |
خدمات قابلة للبيع كبيانات ثابتة + metadata |
ما يُنفَّذ الآن مقابل مؤجل
الآن (MVP): مسارات read-only / مسودات؛ WHATSAPP_ALLOW_LIVE_SEND يبقى افتراضياً false في core/config/settings.py.
مؤجل: OAuth، توقيع webhook إنتاجي كامل، قاعدة أحداث دائمة لـ platform خارج نموذج الابتكار، تنفيذ فعلي لـ Gmail/Calendar/Moyasar.
Inbox و Command Cards
- كل بطاقة: عنوان عربي، ملخص، ثلاثة أزرار كحد أقصى (
label_ar+action_id). - مصادر الحدث: نماذج leads موثّقة، أحداث داخلية، لاحقاً قنوات مسجّلة فقط.
امتثال PDPL / opt-in
- لا تخزين بيانات حساسة في سجل الـ MVP بدون سياسة موثّقة.
- أي إرسال جماعي أو بارد يمر عبر
action_policy+ موافقة بشرية؛ راجعPRIVATE_BETA_RUNBOOK.mdوBETA_PRIVATE_GATES_CHECKLIST.md.
العلاقة بـ Innovation
innovation يبقى مسار العرض والـ Kill features (ten-in-ten, command feed demo/live). Platform تلتف على الدوال التجريبية للـ Proof حيث يلزم، ولا تعيد تعريف أحداث الـ ledger الدائمة.
طبقات «برج التحكم» الإضافية (كود حالي)
| طبقة | مجلد | مسارات API رئيسية |
|---|---|---|
| Security curator | auto_client_acquisition/security_curator/ |
/api/v1/security-curator/* — redact، inspect-diff |
| Growth curator | auto_client_acquisition/growth_curator/ |
/api/v1/growth-curator/* — grade، تقرير أسبوعي demo |
| Meeting intelligence | auto_client_acquisition/meeting_intelligence/ |
/api/v1/meeting-intelligence/* — تلخيص نص، متابعة، brief |
| Model router | auto_client_acquisition/model_router/ |
/api/v1/model-router/* — tasks، route، providers |
| Connectors | auto_client_acquisition/connectors/ |
GET /api/v1/connectors/catalog |
| Agent observability | auto_client_acquisition/agent_observability/ |
/api/v1/agent-observability/* — evals، trace shape |
| Growth operator (aliases) | api/routers/growth_operator.py |
/api/v1/growth-operator/missions، .../proof-pack/demo |
Growth operator لا يضاعف المنطق: يضيف canonical_route للإشارة إلى مصدر الحقيقة في innovation وbusiness.
لخطة تنفيذ بالعربية: EXECUTION_ROADMAP_AR.md.