# توثيق: إضافة البيجات إلى منصّة "مندوب"

> مرجع يوضّح كيف تُدمج فئة "البيجات" (أصحاب صفحات المنتجات على إنستغرام/فيسبوك) في المنصّة: التصوّر، الشاشات المنفّذة، منطق العمل، والأثر على بقية الأطراف.

---

## ١. لماذا البيجات؟ (الأساس الاستراتيجي)

البيجات هي **محرّك الحجم** في المنصّة. بيج نموذجي يرسل عشرات الطلبات شهرياً، بينما المستخدم العادي يرسل طرداً من وقت لآخر. ضمّ البيجات:

- يجلب حجم طلبات كبير يجبر **شركات التوصيل** على التسجيل في المنصّة (يحلّ مشكلة "البيضة والدجاجة" في المنصّات ثنائية الجانب).
- يحوّل مندوب من "تطبيق توصيل" إلى **نظام تشغيل** لعمل البيج اليومي (طلبات، تحصيل، زبائن).

**الوجع الذي نحلّه للبيج:** فوضى الدفع عند الاستلام (COD)، مطاردة الطلبات يدوياً، الإدخال المتكرّر، المرتجعات، وغياب البيانات.

---

## ٢. المبدأ الحاكم: مندوب وسيط تنظيمي — لا يلمس الأموال

هذا القرار المعماري الأهم، ويحكم كل تصميم متعلّق بالبيج:

- الأموال (تحصيل COD) تمشي **نقداً** بين السائق/الشركة والبيج، **خارج المنصّة**.
- مندوب **يسجّل ويعرض ويوثّق** فقط — يوفّر "الحقيقة الواحدة المشتركة" (single source of truth) للتسوية بين البيج والشركة.
- **اللغة المعتمدة:** "كشف / مطابقة / تسوية / مستحقّات" — **لا** "محفظة / سحب / رصيد محصّل".
- **حماية قانونية:** بند في الشروط والأحكام أن مندوب لا يضمن الأموال ولا يتحمّل مسؤولية نزاعات التحصيل، بل يوفّر أداة تنظيم فقط.

**نموذج الدخل:** اشتراكات الشركات (SaaS) + أجرة خدمة رمزية على الطلب (مقترح: ١٬٠٠٠ دينار/طلب = ٥٠٠ من الزبون + ٥٠٠ من الشركة). الإيراد شبه صافٍ لأن المنصّة لا تلمس أموال COD.

---

## ٣. نموذج الحساب: حساب واحد بوضعين

البيج **ليس** نوع مستخدم منفصل بتطبيق مستقلّ. بل هو **وضع أعمال** داخل تطبيق المستخدم نفسه:

- المستخدم العادي يملك حساباً عادياً (إرسال طرود من وقت لآخر).
- إذا كان صاحب بيج، **يفعّل حساب الأعمال** بضغطة → يظهر له وضع البيج بأدواته الأقوى.
- نفس تسجيل الدخول، نفس التطبيق — أدوات مختلفة حسب الوضع.

هذا يقلّل الاحتكاك (لا تطبيق جديد) ويسمح للمستخدم العادي بالترقّي طبيعياً.

---

## ٤. الشاشات المنفّذة (وضع البيج داخل تطبيق المستخدم)

الملف: `mandoub-user-bij-mode.html` — ٦ شاشات بهوية مندوب، بلون تاجر مميّز (ذهبي‑فيوزي) يفرّق تجربة البيج عن المستخدم العادي.

### ٤.١ رئيسية البيج
رأس ذهبي باسم البيج وشارته (مثال: "تاجر ذهبي")، ومؤشّراته (طلبات اليوم، قيد التوصيل، نسبة النجاح). تحته **كشف المستحقّات** من كل شركة (بلغة تسوية)، وإجراءات سريعة (طلب جديد / رفع دفعة / الزبائن)، وآخر الطلبات مع مبالغ تحصيلها.

### ٤.٢ تتبّع الطلبات
فلاتر بالحالة (الكل / محصّل / بالطريق / معلّق / مرتجع)، وقائمة الطلبات — كلٌّ بزبونه وسائقه ومبلغ تحصيله وحالته. هنا يرى البيج **حالات طلباته وحجمها**.

### ٤.٣ إنشاء طلب مفرد
نموذج: اسم الزبون · هاتفه · العنوان · المنتج · **مبلغ التحصيل (COD)** بلون التاجر. ثم "نشر الطلب للشركات".

### ٤.٤ رفع دفعة (جملة)
- رفع ملف Excel/CSV (أعمدة: الاسم · الهاتف · العنوان · المنتج · مبلغ التحصيل) + قالب جاهز.
- بديل: لصق قائمة نصية (سطر لكل زبون) يفكّكها النظام.
- **مراجعة الدفعة:** ملخّص (إجمالي / جاهزة / تحتاج مراجعة)، مع تمييز الصفوف الناقصة بالأحمر قبل النشر.
- أزرار ذكية: "نشر X طلب جاهز" (السليم فقط) + "إصلاح الناقص أولاً" — يمنع نشر بيانات ناقصة.

### ٤.٥ سجلّ الزبائن (CRM مصغّر)
كل زبون بعدد طلباته و**نسبة استلامه**، مع علم أحمر تلقائي للزبون كثير الرفض. يقلّل مرتجعات البيج.

### ٤.٦ تفعيل حساب الأعمال
شاشة تحويل المستخدم العادي إلى حساب بيج، تشرح المزايا وتبرز "مجاناً ٦ أشهر · بدون التزام".

---

## ٥. شارة التاجر الموثّق (Verified Merchant Badge)

هوية معزّزة تغيّر كيف تتعامل الشركات مع البيج:

- عند طلب التوصيل، يظهر البيج للشركات كتاجر بحجم (عدد طلباته، متوسّطه الشهري، نسبة نجاحه، مدّة نشاطه).
- الشركة ترى الحجم بالأرقام، فتقدّم **عرضاً تنافسياً** يناسب حجمه (سعر أفضل طمعاً بولائه).

**طريقة الاكتساب (الاثنان معاً):**
- **تلقائي:** بعد تجاوز حدّ من الطلبات المكتملة (دليل حجم حقيقي من داخل المنصّة).
- **توثيق يدوي:** رابط البيج على إنستغرام/فيسبوك + المتابعين (للبيج الجديد ذي الحجم الخارجي).

**مستويات:** موثّق / ذهبي حسب الحجم.

**الحرِج:** الأرقام الظاهرة للشركة يجب أن تكون حقيقية من داخل المنصّة — لحماية مصداقية النظام كله ومنع ادّعاء "أنا بيج" للحصول على سعر أرخص.

---

## ٦. مساران لطلب البيج

- **مفرد معزّز:** طلب لزبون واحد، يظهر بشارة التاجر وأرقام الحجم.
- **بالجملة:** عدّة طلبات دفعة واحدة، تُسعَّر كحزمة (سعر جملة أرخص لكل طلب).

الشارة تعمل في الحالتين؛ الجملة تضيف خصماً إضافياً.

---

## ٧. الأثر على بقية الأطراف

### ٧.١ تطبيق السائق (منفّذ — `mandoub-driver-app.html`)
- طلبات البيجات تظهر بشارة مميّزة (⚡ طلب بيج).
- كل مهمة تعرض **مبلغ التحصيل (COD)** المطلوب — في بطاقة المهمة، وأثناء التنفيذ.
- عند التسليم: خطوة تأكيد **"تم استلام المبلغ نقداً من الزبون"** — تُسجَّل بالمنصّة لتسوية البيج مع الشركة.

### ٧.٢ لوحة الشركة (مطلوب تنفيذه)
- قسم "**البيجات التي نتعامل معها**": كل بيج وعدد طلباته وحجمه.
- تبويب "طلبات البيجات" منفصل عن الطلبات العادية.
- "تسويات COD": المبالغ التي حصّلها سائقو الشركة وعليها تحويلها للبيجات (كشف مطابقة).
- خيار "تسعير خاص للتجّار" أو قوائم أسعار جملة.

### ٧.٣ لوحة السوبر أدمن (مطلوب لاحقاً)
- إدارة أجرة الخدمة / العمولة التنظيمية على الطلب.
- متابعة نمو البيجات كمؤشّر صحّة للمنصّة.

### ٧.٤ لوحة البيج المستقلّة (ويب سطح مكتب — مطلوب تنفيذه)
نسخة مكتبية أوسع من وضع البيج، للبيج الكبير الذي يدير حجماً عالياً من شاشة كبيرة.

---

## ٨. دورة حياة طلب البيج (من البداية للتسوية)

1. **البيج ينشئ الطلب** (مفرد أو ضمن دفعة) مع مبلغ التحصيل COD.
2. **النشر:** يظهر للشركات بشارة التاجر وأرقام الحجم (أو يُوجَّه لشركة مفضّلة).
3. **الشركة تقدّم عرضاً** يناسب الحجم، والبيج يقبل.
4. **تعيين سائق:** يرى السائق مبلغ التحصيل المطلوب.
5. **التوصيل:** السائق يوصّل، **يحصّل COD نقداً**، ويؤكّد الاستلام النقدي + رمز التسليم.
6. **التسجيل:** المنصّة تسجّل الطلب "محصّل" بالمبلغ.
7. **التسوية:** كشف مطابقة بين البيج والشركة (كم حُصّل، كم أجور، الصافي المستحقّ) — يتّفقان ويسوّون **نقداً خارج المنصّة**، ويعلّمون التسوية "تمّت".

طوال هذه الدورة، **مندوب يسجّل ويعرض فقط** — لا يمرّ المال عبره.

---

## ٩. حالة التنفيذ

| العنصر | الحالة |
|---|---|
| وضع البيج داخل تطبيق المستخدم (٦ شاشات) | ✅ منفّذ |
| تحديث تطبيق السائق (COD + شارة البيج + تأكيد نقدي) | ✅ منفّذ |
| قسم البيجات في لوحة الشركة | ⏳ مطلوب |
| لوحة البيج المستقلّة (ويب سطح مكتب) | ⏳ مطلوب |
| إدارة العمولة في لوحة السوبر أدمن | ⏳ لاحقاً |

---

## ١٠. ملاحظات للتنفيذ التقني (Laravel/Flutter)

- **قاعدة البيانات:** إضافة `account_type` (individual/merchant) على `users`، وجداول `merchant_profiles` (الشارة، المستوى، رابط السوشيال، إحصائيات)، `merchant_orders`/توسعة `orders` بحقول (cod_amount, cod_status, merchant_id, batch_id)، و`settlements` (كشوف التسوية بين بيج وشركة).
- **حالات COD:** `pending / collected / settled` — منفصلة عن حالة توصيل الطلب.
- **الرفع بالجملة:** استيراد CSV/Excel مع تحقّق (validation) صفّاً صفّاً، وإرجاع الصفوف الناقصة للمراجعة قبل الإنشاء.
- **الشارة:** Job مجدول يحدّث مستوى التاجر تلقائياً حسب عدد الطلبات المكتملة.
- **التزم بمبدأ الوسيط:** لا حقول تمثّل "رصيد المنصّة" أو "محفظة تحمل أموال البيج" — فقط سجلّات وكشوف.

---

*آخر تحديث: يوليو ٢٠٢٦ — ملف حيّ، يُحدَّث مع تقدّم التنفيذ.*