يطبق Bedrud نظام أدوار من 5 مستويات للتحكم في الوصول. كل دور يرتبط بمجموعة من سلاسل الوصول المخزنة في سجل المستخدم ويتم تطبيقها على كل من طبقة API (الوسيط في الخلفية) وطبقة UI (حراس الواجهة الأمامية والعرض المشروط).

تسلسل الأدوار

التطبيق في الخلفية

يتم تطبيق مستويات الوصول عبر وسيط RequireAccess على كل مسار إداري. يتحقق الوسيط من مصفوفة وصول المستخدم مقابل الحد الأدنى المطلوب:

• المسارات التي تتطلب وصول superadmin ترفض المشرف والمراقب والمستخدم والضيف
• المسارات التي تتطلب وصول admin تسمح للمشرف العام والمشرف
• المسارات التي تتطلب وصول moderator تسمح للمشرف العام والمشرف والمراقب

يخزن الخلفية الوصول كسلسلة مفصولة بفواصل في قاعدة البيانات (عمود accesses في جدول users). نوع GORM StringArray يتولى التسلسل وإلغاء التسلسل.

تكامل الواجهة الأمامية

نوع المستخدم

تتضمن واجهة User في user.store.ts حقلين منطقيين مشتقين من مصفوفة الوصول:

interface User {
  // ...
  isSuperAdmin: boolean  // accesses.includes('superadmin')
  isAdmin: boolean       // accesses.includes('admin') || accesses.includes('superadmin')
  accesses: string[]     // raw access list from backend
}

حارس الإدارة

يسمح تخطيط الإدارة (/dashboard/admin) للمشرف العام والمشرف والمراقب بالمرور. يتلقى المراقبون متغير سياق isReadOnly=true:

// routes/dashboard/admin.tsx
const canAccess = user?.isSuperAdmin || accesses.includes('admin') || accesses.includes('moderator')

يوفر hook useAdminContext() علامة isReadOnly لجميع المسارات الفرعية:

const { isReadOnly } = useAdminContext()

ما يمكن للمراقبين رؤيته مقابل فعله

منتقي الدور

توفر واجهة الإدارة قائمة منسدلة <Select> في كل من جدول قائمة المستخدمين وصفحة تفاصيل المستخدم، لتحل محل مفتاح المشرف العام الثنائي السابق. الخيارات المتاحة:

ترسل القائمة المنسدلة طلب PUT /api/admin/users/:id/accesses مع مصفوفة الوصول الكاملة.

إدارة سطر الأوامر

تقبل أوامر bedrud user promote و bedrud user demote علامة --role:

# Promote to superadmin (default)
bedrud user promote --email user@example.com
 
# Promote to admin
bedrud user promote --email user@example.com --role admin
 
# Promote to moderator
bedrud user promote --email user@example.com --role moderator
 
# Demote specific role
bedrud user demote --email user@example.com --role admin

قيم --role الصالحة: superadmin، admin، moderator، user، guest.

مواقع الكود