# 08 — KEFHA (`كيفها`) Master API, Social Automation & Full-Funnel Growth Execution Plan

- **تاريخ الاعتماد:** `2026-10-16`
- **المالك وصاحب الصلاحية:** مينا عبدالمسيح (Mina Abdelmassih)
- **نطاق العزل التشغيلي (`Tenant Isolation`):** `tenantId: "kefha"` (معزول بالكامل عن براندات GM Group السبعة)
- **المحرك البرمجي للـ API:** [`src/services/kefhaApiControlService.ts`](file:///F:/Work/GM%20Group%20Workspace/GM%20Control/src/services/kefhaApiControlService.ts) + [`scripts/kefha-api-master-sync.ts`](file:///F:/Work/GM%20Group%20Workspace/GM%20Control/scripts/kefha-api-master-sync.ts)
- **لوحة التحكم الحية (1-Click Browser API Console):** `https://kefha.com/social.html#kefha-api-console`

---

## 1. خريطة تكامل الـ API الحية لبراند كيفها (`Live API Integration Matrix`)

| المنصة (Platform) | المعرّف الرسمي (ID / Endpoint) | حالة الاتصال الفعلية (`Truth State`) | ما يتم تنفيذه تلقائياً عبر الـ API |
| :--- | :--- | :--- | :--- |
| **EasyOrders Storefront API** | Store ID: `4f6e22f8-581b-4c18-9f11-07ae7c436664` (`www.kefha.com`) | `CONNECTED (HTTP 200)` — مفتاح `kefha.easyordersApiKey` محفوظ في `vault.enc` | سحب الـ 50 منتجاً الفعليين، مطابقة الأسعار والمخزون لموديلات `PJ001`–`PJ007`، وتحديث لوجو الهيدر والأيقونة والـ SEO |
| **Bosta Shipping API** | `POST https://app.bosta.co/api/v2/deliveries/search` | `CONNECTED (HTTP 200)` — مفتاح `kefha.bostaApiKey` محفوظ في `vault.enc` | استعلام الشحنات الحية، متابعة المرتجعات والتأخيرات، ومطابقة التحصيل النقدي (`COD Reconciliation`) |
| **ClickUp Operations API** | Tasks: `1249d35af5k`, `1249d35g23z`, `1249d35af5d`, `1249d35af5g`, `1249d35af66` | `CONNECTED (HTTP 200)` | توثيق المخرجات والروابط الحية على المهام الخمس الخاصة بفريق كيفها (مي يوسف وبيشوي ريمون) |
| **Meta Graph API (FB Page + IG + Ads)** | Business: `931129269119272` · Page: `399573636566497` (`Riona`) · Ad Account: `act_2373035036391271` · Pixel: `945458640859436` | `READY_FOR_1CLICK_EXECUTION` عبر `kefhaApiControlService.ts` ولوحة `social.html` | رفع صورة البروفايل (`kefha-social-avatar-dark.png`)، رفع وتثبيت الكفر (`kefha-fb-cover-transition.png`)، تحديث الـ About والوصف والرابط (`www.kefha.com`)، نشر البوست المثبت للتحول (`Riona → Kefha`) على فيسبوك وإنستجرام، وإنشاء 3 حملات إعلانية في وضع `PAUSED` |

---

## 2. خطوات تنفيذ تحديث صفحة فيسبوك وإنستجرام بضغطة واحدة (`1-Click Meta Sync`)

بمجرد منح صلاحية الصفحة (`399573636566497`) للـ System User (`122106624039347104`) أو وضع Page Access Token داخل لوحة **`https://kefha.com/social.html#kefha-api-console`** (أو تمريره للسكريبت `npx tsx scripts/kefha-api-master-sync.ts --meta-token=<TOKEN> --execute-meta-sync`)، يقوم المحرك بتنفيذ الـ 5 عمليات التالية بالتتابع خلال أقل من 10 ثوانٍ:

1. **`POST /v22.0/399573636566497` (Page Metadata):**
   - تحديث `about` إلى النص المعتمد: *«كيفها | KEFHA (ريونا سابقاً) — أزياء منزلية، بيجامات مضلعة، وأساسيات لانجيري وعروسة بخامات فائقة النعومة وتغليف سري ١٠٠٪. تسوقي الآن: www.kefha.com»*
   - تحديث `description` و`website` إلى `https://www.kefha.com`.
2. **`POST /v22.0/399573636566497/picture` (Profile Avatar):**
   - رفع الختم الملكي المعتمد بدقة `1080×1080` (`https://kefha.com/brand-pack/social/kefha-social-avatar-dark.png`).
3. **`POST /v22.0/399573636566497/photos` + `cover` (Page Cover Banner):**
   - رفع كفر التحول الرسمي بدقة `1640×624` (`https://kefha.com/brand-pack/social/kefha-fb-cover-transition.png`) وتعيينه كغلاف رسمي للصفحة.
4. **`POST /v22.0/399573636566497/photos` (Pinned Rebrand Announcement Post):**
   - نشر بوست إعلان التحول من Riona إلى كيفها (`https://kefha.com/brand-pack/social/kefha-post-01-rebrand.png`) بالرسالة الترويجية الكاملة ورابط المتجر.
5. **`POST /v22.0/{ig_user_id}/media` + `media_publish` & `POST /v22.0/act_2373035036391271/campaigns`:**
   - نشر بوست الانطلاق على حساب إنستجرام المربوط، وإنشاء الـ 3 حملات الإعلانية (`KEFHA_Q4_COLD_PROSPECTING_CBO`, `KEFHA_Q4_WARM_RETARGETING_ABO`, `KEFHA_Q4_BRIDAL_VIP_BUNDLES`) في وضع `PAUSED`.

---

## 3. الخطة التنفيذية للنمو والتشغيل خلال 30 يوماً (`30-Day Master Growth Roadmap`)

### الأسبوع الأول (الأيام 1–7): تثبيت التحول (`Riona → Kefha`) وإطلاق البيجامات البطلة
- تثبيت الهوية الجديدة على فيسبوك وإنستجرام (`Avatar` + `Transition Cover` + `6 Story Highlights`).
- نشر سلسلة إطلاق الموديلات السبعة الجديدة (`PJ007` بسعر `850 ج.م` بدلاً من `1,050 ج.م`، و`PJ001`–`PJ006` بسعر `480–500 ج.م`).
- استلام تأكيد الـ 4 بنود المعلقة من العميلة سارة (`GSM/Fabric %`, `CM Size Chart`, `Exact Stock/COGS`, `Shipping SLA/WhatsApp`) عبر مهمة مي يوسف (`1249d35af5d`).

### الأسبوع الثاني (الأيام 8–14): تفعيل محرك المقاس بالوزن (`45–90 kg`) وضمان الخصوصية (`100% Discreet`)
- إطلاق حملة `KEFHA_Q4_COLD_PROSPECTING_CBO` بعد المراجعة والاعتماد، مع التركيز على زاويتين إعلانيتين:
  1. **زاوية القياس المضمون بالوزن (`45–90 kg`)** لتقليل تردد الشراء أونلاين.
  2. **زاوية التغليف السري المصمت (`100% Discreet Packaging`)** لبناء ثقة فورية مع العميلة المصرية.

### الأسبوع الثالث (الأيام 15–21): إطلاق بوكسات جهاز العروسة (`Bridal Boxes — AOV Booster`)
- تفعيل العروض المجمعة الثلاثة لرفع متوسط قيمة السلة (`AOV`) من `~415 ج.م` إلى أكثر من `1,100 ج.م`:
  - **باقة راحة البيت (`Home Comfort Duo`):** طقم بيجامة مضلعة + طقم مطبوع (`1,220 ج.م`).
  - **باقة الأساسيات اليومية (`7-Piece Daily Pack`):** 7 قطع قطنية وسيملس (`920 ج.م`).
  - **بوكس جهاز العروسة الملكي (`Royal Bridal Box`):** بيجامة `PJ007` + 2 طقم سهرة + 3 قطع سيملس (`1,790 ج.م`).

### الأسبوع الرابع (الأيام 22–30): إعادة الاستهداف (`Retargeting`) والربط اللوجستي مع Bosta
- تشغيل حملة `KEFHA_Q4_WARM_RETARGETING_ABO` على زوار الموقع ومتفاعلي إنستجرام وفيسبوك خلال آخر 14 يوماً.
- مطابقة تقارير شحن Bosta (`kefha.bostaApiKey`) مع طلبات EasyOrders (`kefha.easyordersApiKey`) أسبوعياً لضبط نسبة التسليم فوق `88%`.