خاص بـ: الحزمة الكاملة · لوحة الوكالة · الواجهة البرمجية

المديرون والأدوار

المالك والمدير والوسيط، وما يستطيعه كل منهم، وإدارة الفريق.

الأدوار الثلاثة

الدور من هو ما يستطيعه
المالك الحساب الذي ينشئه أمر التعبئة من OWNER_EMAIL كل ما يستطيعه المدير، مع إعدادات الوكالة وإدارة المديرين. هناك مالك واحد.
المدير مدير المكتب أو مدير المبيعات كل العقارات والاستفسارات، وتوزيع العمل، وتمييز العقارات، والمناطق، وحسابات الوسطاء.
الوسيط وسطاء البيع والإيجار عقاراته واستفساراته ومعايناته فقط. ينشئ العقارات (وتكون له دائماً) ويحذف مسوداته.

الجدول الكامل في اللوحة ‹ الأدوار، ويُبنى من القواعد في src/lib/rules.ts:

الصلاحية المالك المدير الوسيط
العمل على عقاراته واستفساراته ومعايناته نعم نعم نعم
listings.all رؤية كل العقارات وتعديلها نعم نعم لا
listings.feature التمييز في الصفحة الرئيسية نعم نعم لا
listings.assign اختيار وسيط العقار نعم نعم لا
listings.delete حذف أي عقار نعم نعم مسوداته
leads.all رؤية كل الاستفسارات والمعاينات نعم نعم لا
leads.assign إسناد الاستفسارات والمعاينات نعم نعم لا
staff.manage إدارة حسابات الفريق نعم الوسطاء فقط لا
areas.manage المناطق نعم نعم لا
settings.edit إعدادات الوكالة نعم لا لا

التحقق على الخادم

تتحقق كل نقطة في الواجهة البرمجية من الدور من جديد (requireStaff({ permission }) في src/lib/api.ts)، ويُتحقق من ملكية كل سجل: الوسيط الذي يطلب عقار وسيط آخر أو استفساره يحصل على 404 كأنه غير موجود. إخفاء الأزرار في اللوحة للراحة فقط، وليس هو الحماية. القواعد مغطاة باختبارات الوحدات في tests/rules.test.ts وباختبار شامل في scripts/e2e_api.py.

إدارة الفريق (إدارة المديرين)

اللوحة ‹ الفريق:

  • الإضافة: الاسم باللغتين، والبريد، وكلمة مرور أولى (عشرة أحرف فأكثر)، والدور، والمسمى الوظيفي، والهاتف، وواتساب، واللغات التي يتحدثها، وخيار «أظهره على الموقع».
  • التعديل: كل ما سبق، ولا تتغير كلمة المرور إلا إذا مُلئ حقلها.
  • الإيقاف (إلغاء «الحساب مفعّل»): لا يستطيع الشخص الدخول من طلبه التالي حتى لو كانت جلسته مفتوحة، وتبقى عقاراته وسجله. استخدمه حين يغادر أحد الفريق.
  • الحذف: للحسابات التي لا عقارات لها فقط.

لا يستطيع أحد تغيير دوره بنفسه، ولا إنشاء مالك ثانٍ، ولا تعديل المالك من هذه الصفحة. والمدير لا ينشئ ولا يعدّل إلا الوسطاء.

الجلسات

يضع الدخول ملف ارتباط httpOnly صالحاً اثنتي عشرة ساعة، موقّعاً بـ AUTH_SECRET. يُقرأ الحساب من جديد مع كل طلب، فيسري الإيقاف أو تغيير الدور فوراً. ومحاولات الدخول محدودة بعشر في الدقيقة لكل عنوان IP، وثماني في كل خمس عشرة دقيقة لكل بريد.