system-prompts-and-models-o.../dealix/docs/EXECUTION_ROADMAP_AR.md
Sami Assiri b13cb389cc feat(dealix): sync full Dealix package to repo
- 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>
2026-05-01 21:01:17 +03:00

68 lines
4.5 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.

# خارطة تنفيذ — برج النمو (Growth Control Tower) — عربي
> مرجع تنفيذي يربط الكود الحالي بالخطوات التالية. **MVP الحالي: مسودات، سياسات، عروض deterministic — بدون إرسال حي أو شحن تلقائي.**
## المرحلة 0 — تثبيت (يوم 02)
1. `python -m compileall` على جذر `dealix`.
2. `pytest` (الريبو يفعّل `--cov` افتراضياً؛ للسرعة: `pytest --no-cov tests/test_growth_tower_stack.py`).
3. `python scripts/print_routes.py` للتحقق من تضمين الراوترات الجديدة.
4. نشر staging ثم `python scripts/smoke_staging.py` (المسارات موسّعة في السكربت).
## المرحلة 1 — دمج الواجهة والعرض (أسبوع 13)
| مخرج | إجراء |
|------|--------|
| Inbox و Command cards | ربط الواجهة بـ `GET /api/v1/platform/inbox/feed` و`GET /api/v1/intelligence/command-feed/demo` حسب التصميم. |
| Proof موحّد | `GET /api/v1/platform/proof/overview` + روابط demo من `innovation` و`business`. |
| Growth operator في الوثائق | استخدام `GET /api/v1/growth-operator/*` للعرض مع احترام `canonical_route` في الاستجابة. |
| Targeting OS | [`TARGETING_ACQUISITION_OS.md`](TARGETING_ACQUISITION_OS.md) و`POST /api/v1/targeting/*` لاستهداف الحسابات والقوائم بشكل متوافق. |
## المرحلة 2 — Curator + Security في مسار المراجعة (أسبوع 24)
1. **قبل** أي لصق diff من الوكيل: `POST /api/v1/security-curator/inspect-diff`.
2. **قبل** تخزين/إرسال نصوص طويلة: `POST /api/v1/security-curator/redact`.
3. رسائل الصادر: `POST /api/v1/growth-curator/messages/grade` كبوابة جودة (لا تستبدل المراجعة البشرية للبيتا).
4. تنقية traces قبل المراقبة: `POST /api/v1/security-curator/trace/sanitize`.
## المرحلة 3 — اجتماعات ومتابعة (أسبوع 36)
- تدفق: لصق transcript → `POST /api/v1/meeting-intelligence/transcript/summarize` → اعتراضات → `POST .../followup/draft`.
- Pre-call: `POST .../brief/pre-meeting` مع JSON منظّم (شركة، جهة، فرصة).
- لا ربط تقويم حي من هذه المسارات في MVP.
## المرحلة 4 — موجه النماذج والمزودين (متوازي)
- استخدام `POST /api/v1/model-router/route` كطبقة **تلميحات** فقط؛ التوجيه الحقيقي يبقى في `core/llm/router.py` عند التشغيل.
- توثيق المزودين في الكود: `GET /api/v1/model-router/providers`.
## المرحلة 5 — Connectors وبوابة الأدوات
1. عرض للعملاء: `GET /api/v1/connectors/catalog` (مخاطر و`blocked_actions` واضحة).
2. تنفيذ أدوات من الوكيل فقط عبر `POST /api/v1/platform/tools/execute` — راجع `tool_gateway` لحالات `blocked` و`approval_required`.
## المرحلة 6 — مراقبة وتقييم (staging → prod)
- تشغيل evals على عينات: `POST /api/v1/agent-observability/eval/safety` و`.../eval/saudi-tone`.
- بناء أحداث trace متوافقة مع Langfuse: `POST .../trace/build` ثم ربط SDK في التطبيق عند الجاهزية.
- راجع [`AI_OBSERVABILITY_AND_EVALS.md`](AI_OBSERVABILITY_AND_EVALS.md).
## المرحلة 7 — إطلاق بيتا خاص (قرار go/no-go)
- [`PRIVATE_BETA_LAUNCH_TODAY.md`](PRIVATE_BETA_LAUNCH_TODAY.md) و[`BETA_PRIVATE_GATES_CHECKLIST.md`](BETA_PRIVATE_GATES_CHECKLIST.md).
- صفحة عرض: [`landing/private-beta.html`](../landing/private-beta.html).
## المرحلة 8 — ما بعد البيتا (90 يوم)
OAuth كامل لـ Gmail/Calendar، Moyasar live خلف موافقة وتدقيق، واتساب إنتاجي مع `WHATSAPP_ALLOW_LIVE_SEND`، أحداث platform في DB، وتقارير PDF من الـ ledger — كما في [`DEALIX_100_PERCENT_LAUNCH_PLAN.md`](DEALIX_100_PERCENT_LAUNCH_PLAN.md) القسم 3 و21.
## تتبع المهام المقترح
| أسبوع | تركيز |
|-------|--------|
| 1 | smoke + ربط UI للـ inbox وproof |
| 23 | security + growth curator في workflow المراجعة |
| 46 | meeting intelligence + نماذج أولى من pilot |
| 710 | connectors أولوية pilot (whatsapp, gmail, moyasar) مع OAuth |
| 11+ | Langfuse، SLOs، PDPL تشغيلية |