system-prompts-and-models-o.../salesflow-saas/revenue-activation/deployment/ADMIN_SETUP_GUIDE.md
Claude 43058e68cb
feat(dealix): full execution plan + endpoint inventory + customer docs
FULL_NEXT_STEP_AND_STACK_EXPANSION_AR.md:
  Complete execution plan with 8 gates, 5 phases, stack additions
  (OTel, OIDC, attestations, OpenFGA now; Great Expectations, Unstructured,
  Airbyte next; OPA, Temporal, MCP in radar), backend/frontend upgrades,
  and avoid-now list.

docs/governance/endpoint-inventory.md:
  Trust classification for ALL ~70 endpoints:
  - ~45 Class A (safe auto, read-only)
  - ~15 Class B (approval-gated, side effects)
  - ~6 Class B+ (critical, financial/legal/irreversible)
  - 5 Class C (forbidden)
  With specific trust enforcement requirements per endpoint.

Customer docs:
  ADMIN_SETUP_GUIDE.md — 30-60min setup guide for client IT admin
    (accounts, channels, approvals, data import, compliance, verification)
  EXECUTIVE_QUICKSTART.md — 5-min guide for CEO
    (what you see, 3 daily actions, weekly pack, FAQ)

https://claude.ai/code/session_01W1rJthWDkasijTdXCfxVHs
2026-04-17 06:23:01 +00:00

121 lines
3.8 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.

# دليل إعداد المشرف — Dealix Admin Setup Guide
> **الجمهور**: مدير IT أو المسؤول التقني عند العميل
> **المدة**: 30-60 دقيقة
---
## 1. إنشاء الحسابات
### حساب المشرف (أنت)
- ادخل على `https://[your-domain]/`
- سجّل باسمك وإيميلك
- الدور: `admin`
- اللغة: `ar` (عربي) أو `en`
### حسابات الفريق
لكل عضو في الفريق:
1. اذهب إلى **الإعدادات****المستخدمون**
2. أضف مستخدم جديد
3. حدد الدور:
| الدور | الصلاحيات |
|-------|----------|
| `admin` | كل شيء — الإعدادات والمستخدمين والتقارير |
| `manager` | الموافقات + التقارير + الإدارة |
| `sales` | إدارة الصفقات والعملاء + WhatsApp |
| `viewer` | عرض فقط — لا تعديل |
---
## 2. إعداد القنوات
### WhatsApp Business
1. اذهب إلى **الإعدادات****القنوات****WhatsApp**
2. أدخل:
- WhatsApp API Token
- Phone Number ID
- Verify Token
3. اختبر بإرسال رسالة لرقمك
### البريد الإلكتروني
1. اذهب إلى **الإعدادات****القنوات****البريد**
2. أدخل إعدادات SMTP أو SendGrid API Key
3. اختبر بإرسال بريد تجريبي
---
## 3. إعداد الموافقات
### حدود SLA
| الإعداد | القيمة الافتراضية | التوصية |
|---------|------------------|---------|
| تحذير SLA | 8 ساعات | 4-8 ساعات |
| خرق SLA | 24 ساعة | 12-24 ساعة |
| التصعيد الحرج | 2× الخرق | الافتراضي |
### من يوافق؟
حدد لكل نوع قرار:
- **رسائل WhatsApp**: المدير المباشر
- **خصم >10%**: مدير المبيعات
- **خصم >25%**: VP
- **شراكة جديدة**: CEO
---
## 4. استيراد البيانات
### استيراد العملاء المحتملين
1. جهز ملف CSV بالأعمدة: `company_name, contact_phone, contact_email, source, status`
2. اذهب إلى **العملاء****استيراد**
3. ارفع الملف
4. تحقق من التطابق
### استيراد الصفقات
1. جهز ملف CSV: `title, value, stage, assigned_to`
2. المراحل المتاحة: `new`, `negotiation`, `proposal`, `closed_won`, `closed_lost`
---
## 5. إعداد الامتثال
### PDPL
- الموافقة **إلزامية** قبل أي رسالة صادرة
- النظام يتحقق تلقائياً — لا تحتاج إعداد
- الموافقة تنتهي تلقائياً بعد 12 شهر
### مراجعة الامتثال
1. اذهب إلى **الامتثال****المصفوفة**
2. اضغط "تشغيل الفحص"
3. راجع النتائج — أخضر (ممتثل) / أصفر (جزئي) / أحمر (غير ممتثل)
---
## 6. إعداد Executive Room
### للمدير التنفيذي
1. أنشئ حساب بدور `manager` أو `admin`
2. افتح **غرفة القيادة** من القائمة
3. سيرى:
- الإيرادات الفعلية مقابل التوقعات
- الموافقات المعلقة مع SLA
- حالة الامتثال
- حالة الموصلات
### للمراجعة الأسبوعية
استخدم `GET /api/v1/executive-room/weekly-pack` للحصول على تقرير أسبوعي مهيكل.
---
## 7. التحقق النهائي
- [ ] كل أعضاء الفريق سجلوا دخولهم
- [ ] WhatsApp يرسل ويستقبل
- [ ] البريد الإلكتروني يعمل
- [ ] SLA مُعدّ
- [ ] 5+ صفقات مُدخلة
- [ ] Executive Room تعرض بيانات
- [ ] فحص الامتثال نجح
**إذا كل شيء أخضر، النظام جاهز للاستخدام اليومي.**