الأدوار الثلاثة
| الدور | من هو | ما يستطيعه |
|---|---|---|
| المالك | الحساب الذي ينشئه أمر التعبئة من 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، وثماني في كل خمس عشرة دقيقة لكل بريد.