system-prompts-and-models-o.../docs/LIVE_DEPLOYMENT_GUIDE_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

118 lines
4.2 KiB
Markdown

---
version: "1.0"
owner: "Platform + Release"
status: "canonical"
review_cadence: "مع كل pilot أو تغيير بيئة عميل"
last_updated: "2026-04-16"
related:
- "GO_LIVE_REVENUE_ACTIVATION_SYSTEM_AR.md"
- "TIER1_REAL_PRODUCTION_PLAYBOOK_AR.md"
- "LAUNCH_CHECKLIST (salesflow-saas/docs)"
---
# دليل النشر الحي عند عميل (Pilot / Prod)
دليل **خطوة بخطوة** لتركيب Dealix في بيئة عميل (staging أو إنتاج محدود) مع الإشارة إلى الملفات القائمة في المستودع. لا يغني عن runbooks الداخلة لدى العميل.
---
## 0) نطاق الـ pilot (قبل أي أمر)
| بند | قرار |
|-----|------|
| Tenant / حسابات | من يملك المستخدم الإداري؟ |
| موصلات مفعّلة | بريد، WhatsApp، CRM، توقيع — **قائمة صريحة** |
| بيانات حساسة | نعم/لا → تفعيل حقول PDPL على المسارات الخارجية |
| نافذة الصيانة | تاريخ + تراجع إن لزم |
---
## 1) المتطلبات والتحقق المحلي (Repo)
من **جذر المستودع**:
```bash
python scripts/architecture_brief.py
python scripts/check_docs_links.py
```
من **`salesflow-saas/backend`**:
```bash
py -3 -m pytest tests -q
```
من **`salesflow-saas`** (موصى به):
```powershell
.\verify-launch.ps1
```
المرجع الكامل: [`salesflow-saas/docs/LAUNCH_CHECKLIST.md`](../salesflow-saas/docs/LAUNCH_CHECKLIST.md).
---
## 2) الخادم (API)
* نسخ البيئة: [`salesflow-saas/backend/.env.phase2.example`](../salesflow-saas/backend/.env.phase2.example) → `backend/.env` وملء الحقول حسب [`INTEGRATION_MASTER_AR.md`](../salesflow-saas/docs/INTEGRATION_MASTER_AR.md).
* **PostgreSQL** للإنتاج (ليس SQLite الاعتماد الدائم) — انظر قسم قاعدة البيانات في قائمة الإطلاق.
* التشغيل:
```bash
cd salesflow-saas/backend
py -3 -m uvicorn app.main:app --host 0.0.0.0 --port 8000
```
* فحص جاهزية التكامل التجاري:
```bash
cd salesflow-saas
py -3 scripts/check_go_live_gate.py
```
توقع **403** مع `blocked_reasons` حتى اكتمال المتغيرات — هذا سلوك **بوابة** لا خللًا بالضرورة.
---
## 3) الواجهة (Next.js)
* [`salesflow-saas/frontend/.env.example`](../salesflow-saas/frontend/.env.example): `NEXT_PUBLIC_API_URL` يطابق أصل الـ API الفعلي (HTTPS).
* الباكند: `FRONTEND_URL` و`CORS_EXTRA_ORIGINS` في الإعدادات — انظر [`LAUNCH_CHECKLIST.md`](../salesflow-saas/docs/LAUNCH_CHECKLIST.md) §3.
---
## 4) الأمن والوصول
* رموز داخلية / JWT حسب نموذجكم؛ لا تُخزَّن أسرار في الوثائق.
* حدود معدل الطلبات (إن وُجدت) على مسارات الـ outreach عند التفعيل.
---
## 5) المراقبة والاسترجاع
* صحة: `GET /api/v1/health` و`GET /api/v1/ready`.
* بعد أي تغيير على أسرار الطرف الثالث: إعادة `go-live-gate`.
* سياسة التراجع: راجع [`salesflow-saas/memory/runbooks/production-deployment-guide.md`](../salesflow-saas/memory/runbooks/production-deployment-guide.md)؛ وإلا وثّقوا خطوة rollback (صورة سابقة + تعطيل flags).
---
## 6) تسليم للعميل (Handoff)
| المخرج | الوصف |
|--------|--------|
| قائمة متغيرات مملوءة | بدون قيم سرية في البريد — استخدم قنوات آمنة |
| مستخدم إداري | بيانات الدخول عبر قناة آمنة |
| مسار demo مسجّل | روابط + خطوات من [`golden-path-partner-intake-runbook.md`](golden-path-partner-intake-runbook.md) |
| جهة اتصال دعم | SLA من الاتفاق |
---
## 7) بعد Go-Live
* [`salesflow-saas/docs/DEALIX_POST_LAUNCH_OPS_AR.md`](../salesflow-saas/docs/DEALIX_POST_LAUNCH_OPS_AR.md) إن وُجد.
* إعادة فحص [`RELEASE_READINESS_MATRIX_AR.md`](RELEASE_READINESS_MATRIX_AR.md) لصف RC التالي.
---
*الدليل تقني؛ الالتزامات القانونية والتعاقدية مع العميل خارج نطاق هذا الملف.*