لوحة تحكم الوكالة
ما يفعله المكتب الخلفي: النظرة العامة مع خريطتها، والصفحات في الشريط الجانبي، وإعدادات الوكالة، والإشعارات، وتسجيل الدخول.
لحزمة الحزمة الكاملة
الصفحات
كل صفحة موجودة بالإنجليزية تحت /en وبالعربية تحت /ar. تفتح لوحة التحكم على /en/dashboard بعد تسجيل الدخول في /en/auth/login. لا يظهر كل عنصر في الشريط الجانبي إلا عندما يملك المسؤول المسجّل صلاحيته.
| عنصر الشريط الجانبي | المسار | الصلاحية | وظيفته |
|---|---|---|---|
| نظرة عامة | /en/dashboard | overview.view | العقارات والاستفسارات والمعاينات في لمحة، مع خريطة العقارات. |
| المساعد الذكي | /en/dashboard/ai-assistant | ai_chat.use | محادثة تقرأ العقارات والاستفسارات والمعاينات وتتصرف فيها، وترسم مخططات. |
| العقارات | /en/dashboard/properties | properties.view | القائمة مع تبويبات الحالة والبحث والمرشحات، ومحرر العقار. |
| الاستفسارات | /en/dashboard/leads | leads.view | الاستفسارات الواردة من الموقع، مع لوحة تفاصيل. |
| المعاينات | /en/dashboard/viewings | viewings.view | الزيارات المطلوبة والمؤكدة. |
| استوديو التأثيث | /en/dashboard/studio | staging.view | تأثيث الغرف الفارغة بمعاينات الذكاء الاصطناعي واعتمادها للموقع. |
| الإعدادات | /en/dashboard/settings | لا شيء (لكل تبويب صلاحياته) | الوكالة والصفحة الرئيسية والأحياء والملف الشخصي والأمان. |
| إدارة المسؤولين | /en/dashboard/admins-management | admins.view | حسابات الفريق وأدوارهم. |
| أدوار المسؤولين | /en/dashboard/admins-roles | roles.view | الأدوار والصلاحيات. |
لوحة بحث في الشريط العلوي تجد الصفحات والعقارات والاستفسارات والمعاينات، والجرس يحمل الإشعارات، و«عرض الموقع» يفتح NEXT_PUBLIC_SITE_URL. أما الصفحة التي تُفتح بعنوانها بدون الصلاحية فتعرض «هذه الصفحة ليست ضمن صلاحيات دورك»، وهو الرفض نفسه الذي تعطيه واجهة API.
النظرة العامة
- العقارات المنشورة، للبيع وللإيجار، والاستفسارات الواردة في آخر سبعة أيام، والمعاينات في الأيام السبعة القادمة وتلك التي ما زالت بانتظار التأكيد.
- آخر الاستفسارات، والمعاينات القادمة، وأحدث ثلاثة عقارات تحديثًا، وعقار مميز.
- خريطة للمنازل المنشورة التي لها إحداثيات، حتى 250، مرسومة ببلاطات OpenFreeMap.
الإعدادات
للإعدادات خمسة تبويبات. الملف الشخصي والأمان يخصان المسؤول المسجّل؛ أما الباقي فيحتاج إلى صلاحية للعرض وأخرى للحفظ.
| التبويب | الصلاحية | ما يضبطه |
|---|---|---|
| الوكالة | settings.view، وsettings.edit للحفظ | اسم الوكالة وبريد التواصل والمدينة، وعنوانها ووصفها المختصر بالإنجليزية والعربية. العملة هي AED والمنطقة الزمنية Asia/Dubai؛ ويصدر الموقع دائمًا باللغتين. |
| الصفحة الرئيسية | settings.view، وsettings.edit للحفظ | المنازل الثلاثة التي تعرضها الصفحة الرئيسية للموقع بالترتيب (المنازل المنشورة فقط)، والمنزل الواجهة الذي تعرض الصفحة الرئيسية غرفته المؤثثة المعتمدة. |
| الأحياء | neighborhoods.view، والإنشاء أو التعديل أو الحذف | اسم كل منطقة باللغتين، والمعرّف النصي (slug)، والمدينة، والوصف المختصر، وصورة الغلاف، وترتيب الفرز، وهل هي مميزة ومعروضة. تبقى منازلها موجودة عند حذف المنطقة. |
| الملف الشخصي | لا شيء: يحفظ كل مسؤول ملفه بنفسه | صورة المسؤول المسجّل واسمه الأول والأخير وبريده وهاتفه. |
| الأمان | لا شيء | بيانات تسجيل دخول المسؤول المسجّل. |
شعار العلامة لا يُرفع هنا: فهو يأتي من ملفات العلامة في المشروع.
الإشعارات
- يُشعِر الاستفسار الجديد كل مسؤول يستطيع عرض الاستفسارات، وطلب المعاينة كل مسؤول يستطيع عرض المعاينات. وتُشعِر معاينة التأثيث المنتهية أو الفاشلة المسؤول الذي بدأها.
- تصل مباشرة، مع رسالة قصيرة على الشاشة، ويسرد الجرس أحدث 30. يُحفظ كل إشعار 30 يومًا، إلى أن يُقرأ أو يُزال.
- لا يُرسل شيء بالبريد الإلكتروني: لا توجد خدمة بريد في القالب.
- يستخدم الاتصال المباشر
NEXT_PUBLIC_WEBSOCKET_BASE_URL، وهو عنوان واجهة API دون/api. تعرض إعادة التحميل دائمًا أحدث الصفوف؛ والتحديثات المباشرة فقط هي التي تعتمد على الاتصال.
تسجيل الدخول
- يبدأ نموذج تسجيل الدخول فارغًا. تذكرني يُبقي الجلسة بعد إغلاق المتصفح، إلى أن ينتهي رمز واجهة API (سبعة أيام افتراضيًا)؛ وإذا ألغيت تحديده تنتهي الجلسة بإغلاق المتصفح أو التبويب.
- يظهر البريد الخاطئ وكلمة المرور الخاطئة بالرسالة نفسها، «بريد إلكتروني أو كلمة مرور غير صحيحة»، فلا يخبر النموذج أحدًا أي العناوين لها حساب. وبعد عشر محاولات فاشلة في خمس عشرة دقيقة من عنوان واحد، يطلب النموذج المحاولة بعد بضع دقائق.
- عندما ترفض واجهة API جلسة (رمز منتهي أو ملغى)، تسجّل لوحة التحكم الخروج وتفتح صفحة تسجيل الدخول. ويصل تغيير أدوار المسؤول إليه وهو مسجّل الدخول.
كيف تترابط أجزاء كود لوحة الإدارة
مُضمَّن مع مشترياتك. سجّل الدخول لقراءته، أو افتحه في ملف التنزيل.
بنية الكود، وطريقة إضافة صفحة وترجمة وخدمة API.