🛡 دليل مدير البرنامج

1. تسجيل الدخول والصلاحيات

مدير البرنامج يدخل عبر /auth/login ببريده الإلكتروني وكلمة المرور التي يحدّدها أعلى مدير (مدير المشروع — L1). يوجد ثلاث رتب إدارية:

• مدير المشروع (L1) — صلاحية كاملة بما فيها إنشاء المديرين الآخرين وتعديل الإعدادات الأساسية.
• مدير مساعد (L2) — مراجعة وإدارة المحتوى، لا يستطيع تعديل المستخدمين الإداريين أو إعدادات النظام.
• مدير الإعلانات (Ad Manager) — متخصّص بمراجعة إعلانات العقارات + اعتماد الوكلاء فقط.

بعد الدخول تظهر بطاقة «🛡 لوحة الإدارة» في لوحة المستخدم.

2. لوحة الإدارة الرئيسية

الرابط: /admin/

تحتوي على:

• 📊 أرقام لحظية — عدد العقارات النشطة، المستخدمين، الوكلاء، الشركات، الشركاء التجاريين.
• 🔔 تنبيهات الموافقات — أي عقار أو وكيل أو شركة بانتظار اعتمادك يظهر بشارة لونيّة.
• 🛠 اختصارات سريعة — موافقات العقارات، الوكلاء، الشركات العقارية، الشركاء، التغذية المرئية للسوق.

3. مراجعة العقارات الجديدة

الرابط: /admin/moderation

لكل عقار قيد المراجعة، يُعرض لك:

• الصور + العنوان + الوصف.
• الناشر (مستخدم عادي / وكيل معتمد).
• إقرار البائع بصدق المعلومات + تاريخ الإقرار + الـ IP.
• كشف اوتوماتيكي بـ درجة احتيال مبدئية مبنيّة على مقارنة السعر مع متوسط الحي + التحقّق من تطابق الموقع مع المدينة المختارة.

زرّان أساسيّان: ✅ موافقة أو ❌ رفض (مع كتابة سبب — يصل إلى الناشر تلقائياً).

4. اعتماد الوكلاء العقاريين

الرابط: /admin/agent-applications

كل طلب يضمّ:

• اسم الوكيل، الهاتف، المدينة المختارة، الوكالة، رقم الترخيص (إن وُجد).
• نبذة عن خبرته (≥ 20 حرفاً).
• محفظة العقارات — قائمة الـ 20+ عقار التي قدّمها كدليل على جاهزيته. شارة خضراء «≥ 20» / صفراء «أقل من 20».
• تاريخ توقيعه الإلكتروني على عقد الوكيل (10 بنود).

عند الموافقة، يصبح بإمكان الوكيل:

• نشر العقارات مباشرةً بدون مراجعة (في مدينته فقط).
• الظهور في قسم «الوكلاء العقاريون» على الصفحة الرئيسية.
• إصدار عقد عمل رسمي مطبوع — انظر القسم التالي.

5. إصدار عقد عمل ورقي للوكيل

من قائمة الوكلاء، اضغط زر 📄 إصدار عقد.

سيُولَّد مستند مطبوع يحتوي على:

• هويّتك (الطرف الأول) + هويّة الوكيل (الطرف الثاني).
• بيانات الدخول التي ستسلّمها للوكيل (اسم المستخدم + كلمة مرور مؤقتة يجب أن يغيّرها عند أول دخول).
• دليل عمل يومي مختصر.
• كامل البنود العشرة القانونية للعقد.
• سطور للتوقيع.

اطبعه على ورق رسمي ووقّعا الطرفان نسخة لكل منهما.

6. الشركات العقارية

الرابط: /admin/companies

كل شركة تمرّ بحالات: قيد المراجعة → نشطة → موقوفة/مرفوضة. عند الاعتماد يصبح المدير قادراً على:

• دعوة وكلاء للعمل تحت اسم الشركة.
• متابعة كل العروض على عقارات وكلائه.
• الرد نيابةً عن الفريق.

7. الشركاء التجاريون

الرابط: /admin/partners

أنت وحدك من يضيف شريكاً جديداً (بنك، تأمين، موثّق، شركة نقل، …). كل شريك له:

• صفحة عامة في قسم «🤝 الخدمات».
• باقة اشتراك (Free / Bronze / Silver / Gold / Sponsored).
• سجلّ بـ Leads المُحوَّلة إليه + العمولات.

صفحة الشريك تشمل تفاصيل الاشتراك، إحصاءات الزيارات، وعدد العملاء الذين وصلوا منه إلى صفقة فعلية.

8. الـ Leads والعمولات

الرابط: /admin/leads

كل ضغطة من مستخدم على شريك تُسجَّل كـ Lead. حالات الـ Lead:

• قيد المتابعة — الشريك لم يحوّله إلى صفقة بعد.
• مُحوَّل — الصفقة تمّت، تظهر العمولة المستحقّة.
• مفقود — لم يصل إلى تحويل خلال فترة معقولة.

9. مراقبة الأمان

الرابط: /admin/security

• قائمة الحوادث الأمنية (محاولات حقن SQL، XSS، طلبات مشبوهة).
• قائمة الـ IP المحظورة + إمكانية فكّ الحظر يدوياً.
• تحليل ذكي للأنماط المتكرّرة.

10. سجلّ التغييرات

الرابط: /admin/audit

كل عملية يقوم بها أي إداري تُسجَّل: من، متى، ماذا، من أي IP. هذا سجلّ غير قابل للتعديل — مرجعك القانوني في حال أي خلاف.

11. أسئلة شائعة