الشاشات والأدوار والصلاحيات
كل شاشة في لوحة التحكم، وما تقرؤه وتحفظه، وكيف تحدد الأدوار والصلاحيات ما يستطيع كل مشرف فعله.
لحزمة واجهة + خلفية
الشاشات
كل شاشة تحت /en/dashboard و/ar/dashboard، خلف تسجيل الدخول، وهي مدرجة في الشريط الجانبي.
| الشاشة | العنوان | وظيفته |
|---|---|---|
| تسجيل الدخول | /en/auth/login | البريد الإلكتروني وكلمة المرور، مع «تذكرني». أزرار Google وApple و«نسيت كلمة المرور؟» عناصر نائبة تذكر أنها غير مُعدّة: يضبط المسؤول كلمة مرور جديدة من «إدارة المشرفين». |
| نظرة عامة | /en/dashboard | تحية مع الطقس المحلي، وأرقام رئيسية، ورؤى، وأداء، ومخطط رادار، ومخطط إيرادات، وخريطة للعالم، وتقويم، وآخر المشاريع، ومهامك السريعة. يحفظ «تصدير» الصفحة كصورة PNG. |
| المساعد الذكي | /en/dashboard/ai-assistant | تحدّث عن بياناتك بكلمات بسيطة. يجيب بأرقام وبطاقات ومخططات وقوائم، ويستطيع إنشاء المستخدمين وتعديلهم وحذفهم واستعادتهم وتغيير إعدادات التطبيق، ضمن صلاحياتك أنت. |
| المستخدمين | /en/dashboard/users/all | ابحث في المستخدمين وصفِّهم وأنشئهم وعدّلهم، وغيّر كلمة المرور، وعلّم البريد متحققًا منه أو لا، واحذف. لكل مستخدم صفحة خاصة به. |
| المستخدمون المحذوفون | /en/dashboard/users/deleted | المستخدمون المحذوفون من القائمة، ويُحتفظ بهم ليمكن استعادتهم. |
| المشاريع | /en/dashboard/projects/all | مشاريع لها حالة (قيد التنفيذ، جاهز، محظور)، وبيئة، وإصدار، وصورة، واسم ووصف بالإنجليزية والعربية. لكل مشروع صفحة خاصة به. |
| المشاريع المحذوفة | /en/dashboard/projects/deleted | المشاريع المحذوفة، ويُحتفظ بها ليمكن استعادتها. |
| إدارة المسؤولين | /en/dashboard/admins-management | المشرفون الذين يستطيعون تسجيل الدخول: أنشئ وعدّل وامنح أدوارًا واحذف. لكل مشرف صفحة خاصة به. |
| أدوار المسؤولين | /en/dashboard/admins-roles | أنشئ الأدوار وأعد تسميتها واختر الصلاحيات التي يمنحها كل دور. |
| الإعدادات | /en/dashboard/settings | الملف الشخصي (اسمك وبريدك وهاتفك وبلدك وصورتك)، والأمان (كلمة مرورك)، وإعدادات التطبيق (إعدادات التطبيق نفسه، مثل اسم الموقع وبريد الدعم ووضع الصيانة). |
| مكون واجهة المستخدم | /en/dashboard/ui-component | كل مكون قابل لإعادة الاستخدام في لوحة التحكم مع مثال حي: أزرار، وحقول إدخال، وجداول، ونوافذ حوارية، وألواح جانبية، ومخططات، ومحرر نصوص منسق، وحقل هاتف، وخريطة للعالم، وغيرها. |
ما هو حي وما هو نموذجي
- المستخدمون والمشاريع والمشرفون والأدوار والصلاحيات وإعدادات التطبيق ومهامك السريعة ومحادثات المساعد تُقرأ من واجهة API وتُحفظ فيها، أو في واجهة API التجريبية المدمجة في متصفحك.
- في النظرة العامة، تأتي أعداد المستخدمين الإجمالية وأعداد المشاريع الإجمالية وجدول المشاريع من واجهة API. أما الأرقام والمخططات الأخرى (الرؤى والأداء والرادار والإيرادات وخريطة العالم وأحداث التقويم) فبيانات نموذجية في الكود، جاهزة للربط بمصادرك أنت.
- حذف مستخدم أو مشروع حذف ناعم: يُحتفظ بالصف ويُدرج تحت «المحذوفة»، ومنه يمكن استعادته.
- «إعادة إرسال رسالة التحقق» على مستخدم تجيب بأن الرسالة أُرسلت، لكن واجهة API لا ترسل أي بريد: فهي المكان الذي تربط فيه خدمة البريد الخاصة بك.
فاتح وداكن
يبدّل الرأس بين الوضع الفاتح والداكن، ويتذكر المتصفح الاختيار. كل لون متغير CSS معرَّف للمظهرين.
الأدوار
يمكن أن يحمل المشرف عدة أدوار، ويحصل على كل صلاحية يمنحها أي منها. ينشئ الـ seed خمسة أدوار يمكنك تغييرها من صفحة أدوار المشرفين:
| الدور | ما يمكنه فعله |
|---|---|
| المدير العام (Super Admin) | كل شيء |
| لوحة الإدارة | كل شيء عدا حذف المشرفين وإنشاء الأدوار أو تعديلها أو حذفها أو تغيير ما تمنحه |
| المدير (Manager) | المستخدمون والمشاريع بالكامل، والمساعد، والاطلاع على المشرفين والأدوار والإعدادات |
| محرر | الاطلاع على المستخدمين والمشاريع وإنشاؤهم وتعديلهم، واستخدام المساعد |
| المشاهد (Viewer) | يرى كل القوائم (المشرفين والأدوار والإعدادات والمستخدمين والمشاريع)، من دون إنشاء أو تعديل أو حذف ومن دون المساعد؛ وتبقى كلمة مروره ومهامه السريعة تعمل |
admin@example.com هو Super Admin. وكل مشرف آخر في الـ seed، مثل john.smith@admin.com، هو Viewer.
الصلاحيات
هناك 25 صلاحية، أسماؤها بصيغة module.action:
| الوحدة | الصلاحيات |
|---|---|
| المسؤولون | admins.view, admins.create, admins.edit, admins.delete, admins.assign_roles |
| الأدوار | roles.view, roles.create, roles.edit, roles.delete, roles.assign_permissions |
| المستخدمين | users.view, users.create, users.update, users.delete, users.restore, users.verify |
| المشاريع | projects.view, projects.create, projects.edit, projects.delete, projects.restore |
| الإعدادات | settings.view, settings.edit |
| المساعد الذكي | ai_chat.use, ai_chat.view_models |
- تفحص واجهة API الصلاحية في كل مسار، ويفحصها المساعد في كل أداة يشغّلها. أما لوحة التحكم فتقرر ما تعرضه فقط: الزر الذي لا يحق للمشرف استخدامه يُخفى.
- يحتاج حفظ ملفك الشخصي إلى
admins.edit. أما تغيير كلمة مرورك ومهامك السريعة فلا يحتاجان إلى صلاحية: فلكل مشرف مهامه وكلمة مروره. - عندما تتغير صلاحيات دور، تُبلَّغ لوحة تحكم كل مشرف مسجّل الدخول عبر اتصال مباشر، فتتبعها قوائمها وأزرارها من دون إعادة تحميل.
كيف يترابط الكود
مُضمَّن مع مشترياتك. سجّل الدخول لقراءته، أو افتحه في ملف التنزيل.
أين يوجد كود كل شاشة، وكيف تحصل الشاشة على بياناتها، وفحص الصلاحية، وإضافة صفحة.