المسؤولون والأدوار والصلاحيات
من يستطيع تسجيل الدخول إلى لوحة التحكم، والدوران الأوليان، وكل صلاحية تفحصها واجهة API، وكيف تمنح عضو الفريق ما يحتاجه بالضبط.
لحزمة الحزمة الكاملة
كيف يعمل الوصول
- المسؤولون وحدهم يسجّلون الدخول، إلى لوحة التحكم. ليس للموقع حسابات.
- يملك المسؤول دورًا واحدًا أو أكثر، والدور مجموعة صلاحيات اسمها
<area>.<action>، مثلproperties.publish. يملك المسؤول كل صلاحية من كل دور لديه. - تفحص واجهة API الصلاحية في كل مسار من مسارات لوحة التحكم، مهما عرضت الشاشة. وتخفي لوحة التحكم عناصر الشريط الجانبي والتبويبات والأزرار التي لا تشملها أدوار المسؤول، وتقول الصفحة التي تُفتح بعنوانها «هذه الصفحة ليست ضمن صلاحيات دورك».
- يصل تغيير أدوار المسؤول، أو صلاحيات دور، إلى ذلك المسؤول وهو مسجّل الدخول.
الدوران والحسابان الأوليان
| الدور | الصلاحيات | الحساب الأولي |
|---|---|---|
| المدير العام (Super Admin) | كلها 31 | admin@velra.example |
| الوكيل | overview.view وproperties.* وleads.view وleads.edit وviewings.view وviewings.edit وstaging.* وneighborhoods.view: العقارات والاستفسارات والمعاينات واستوديو التأثيث، بدون المساعد أو الإعدادات أو المسؤولين أو الأدوار | agent@velra.example |
تضبط البيانات الأولية الدورين على هاتين القائمتين بالضبط في كل مرة تُشغَّل، ولا تعيد ضبط أي كلمة مرور موجودة. غيّر بيانات الدخول للحسابين، أو احذف الحسابين الأوليين، قبل أن تصبح الوكالة متاحة من الإنترنت. يسرد دليل التثبيت بيانات الدخول التجريبية.
كل الصلاحيات
| المجال | الصلاحيات |
|---|---|
| نظرة عامة | overview.view |
| العقارات | properties.view, properties.create, properties.edit, properties.publish, properties.delete |
| الاستفسارات | leads.view, leads.edit |
| المعاينات | viewings.view, viewings.edit |
| استوديو التأثيث | staging.view, staging.create, staging.approve |
| الأحياء | neighborhoods.view, neighborhoods.create, neighborhoods.edit, neighborhoods.delete |
| المسؤولون | admins.view, admins.create, admins.edit, admins.delete, admins.assign_roles |
| الأدوار | roles.view, roles.create, roles.edit, roles.delete, roles.assign_permissions |
| إعدادات الوكالة | settings.view, settings.edit |
| المساعد الذكي | ai_chat.use, ai_chat.view_models |
القائمة معرَّفة مرة واحدة في back-end/src/database/seeders/permission.seeder.ts؛ وتضيف البيانات الأولية الأسماء الجديدة وتزيل ما لم تعد واجهة API تفحصه.
إدارة المسؤولين
- يسرد
/en/dashboard/admins-managementالفريق، عشرة في الصفحة، مع بحث بالبريد والاسم والهاتف، ويضيف الحسابات ويعدّلها ويحذفها (admins.viewوadmins.createوadmins.editوadmins.delete). - يحتاج المسؤول الجديد إلى اسم أول وأخير وبريد وكلمة مرور من ست خانات على الأقل، تُكتب مرتين؛ والهاتف اختياري.
- تعيّن صفحة كل مسؤول أدواره (
admins.assign_roles). - كل مسؤول، مهما كان دوره، يعدّل صورته واسمه وبريده وهاتفه تحت الإعدادات ثم الملف الشخصي، ويغيّر بيانات دخوله تحت الإعدادات ثم الأمان، بإدخال الحالية. ولا يحتاج أي منهما إلى صلاحية.
أدوار المسؤولين
ينشئ /en/dashboard/admins-roles الأدوار ويعيد تسميتها ويحذفها (roles.create وroles.edit وroles.delete)، ويمنح صلاحياتها من شبكة مجمعة حسب المنطقة (roles.assign_permissions). ولتعطي عضو الفريق أقل من دور الوكيل، أنشئ دورًا بالصلاحيات التي يحتاجها فقط وعيّنه بدلًا منه.
ما يصل إليه المساعد
ai_chat.use تفتح المساعد الذكي ولا تمنح شيئًا آخر. لا يقرأ المساعد ولا يغيّر إلا ما تسمح به صلاحيات المسؤول الأخرى، وهي نفسها التي تفحصها صفحات لوحة التحكم: بدون settings.edit لا يستطيع تغيير إعداد، وبدون leads.view لا يستطيع قراءة استفسار. ويتحقق مرة أخرى قبل كل إجراء، فتسري الصلاحية المزالة أثناء محادثة على المحادثة التالية.