وثائق المطورين

حزمة رسمية للـ TypeScript وأخرى لـ PHP. نفس العقد، نفس المسارات، نفس الصلاحيات التي يفحصها تطبيق قُرب نفسه.

TypeScript1.7.0PHP1.7

الصلاحيات

كل كتابة تستخدم نفس الصلاحية التي يفحصها تطبيق قُرب نفسه لذلك الإجراء — لا أشد ولا أخف. مدير يمنح blogs:create من لوحة التحكم يتوقعها تعني الشيء نفسه عبر التكامل، وأي انحراف يجعل شاشة الصلاحيات كذبة.

القسمإنشاءتعديلحذف
tweetsposts:manage | posts:createتلك, أو صاحبهتلك, أو صاحبه
eventscalendar:manage | calendar:createتلك, أو صاحبهتلك, أو صاحبه
blogsblogs:manage | blogs:createتلك, أو صاحبهتلك, أو صاحبه
albumsalbums:manage | albums:createتلك, أو صاحبهتلك, أو صاحبه
groupsgroups:manage | groups:create+ groups:moderate, أو صاحبهgroups:manage | groups:moderate — بلا استثناء للمؤلف
consultantsconsultants:manageنفسهانفسها — بلا استثناء للمؤلف
projects / projects2*:manage | *:create | *:moderate+ *:edit, أو صاحبه*:manage | *:moderate | *:edit, أو صاحبه
awardsawards:manageنفسهانفسها — بلا استثناء للمؤلف
taskstasks:manageنفسهانفسها — بلا استثناء للمؤلف
comments / likesلا شيءالمؤلف خلال ١٥ دقيقةالمؤلف خلال ٣٠ دقيقة، أو مدير/مشرف

العضو العادي لا يملك أياً منها

الدور MEMBER يُحل إلى مجموعة صلاحيات فارغة في قُرب — النشر قدرة يمنحها المدير، لا شيء تمنحه العضوية. فمفتاح لم يُمنح صاحبه شيئاً يقرأ كل شيء ولا ينشر شيئاً. هذا سلوك صحيح لا خلل، وإعادة إصدار المفتاح لن تغيره.
ts
const perms = await gurb.members.getPermissions('mem_2')
// { memberId: 'mem_2', userId: 'usr_9', role: 'MEMBER',
//   effective: [], granted: [], revoked: [] }

// Let one member run events without making them a moderator
await gurb.members.updatePermissions('mem_2', { grant: ['CREATE_EVENT'] })

await gurb.members.setRole('mem_2', 'MODERATOR')

effective: []الدور MEMBER يُحل إلى مجموعة صلاحيات فارغة في قُرب — النشر قدرة يمنحها المدير، لا شيء تمنحه العضوية. فمفتاح لم يُمنح صاحبه شيئاً يقرأ كل شيء ولا ينشر شيئاً. هذا سلوك صحيح لا خلل، وإعادة إصدار المفتاح لن تغيره.

كل الصلاحيات، لكل دور

ثمان وأربعون صلاحية في ست وعشرين فئة، بالعربي والإنجليزي. النقطة الداكنة تعني أن الدور يملكها فعلياً — بعد توسيع manage لا كما هي مخزّنة.

المخزّن مقابل الفعلي

33 مخزّنة 34 فعلية

صلاحية manage لأي وحدة تشمل create وmoderate الخاصتين بها — كل حارس في قُرب يقبل الثلاث. لهذا يُخزَّن للمدير عدد أقل من المشرف بينما قدرته الفعلية أوسع. أي جدول يقارن الأدوار بطول القائمة المخزّنة يقول عكس الحقيقة.

إدارة المستخدمين

  • إدارة المستخدمين

    التحكم الكامل - إضافة وتعديل وحذف المستخدمين وتعيين الصلاحيات

    users:manage
    للمدير فقط
  • إدارة المستخدمين

    تعليق أو حذف أو تجميد حسابات المستخدمين

    users:moderate

منشورات الصفحة الرئيسية

  • إدارة المنشورات

    التحكم الكامل في جميع منشورات الصفحة الرئيسية

    posts:manage
    للمدير فقط
  • إنشاء منشورات

    إنشاء منشورات جديدة + تعديل/حذف منشوراتك

    posts:create
  • إدارة المنشورات

    تعديل/حذف/إخفاء منشورات الآخرين

    posts:moderate

منشورات المجموعات

  • إدارة منشورات المجموعات

    التحكم الكامل في جميع المجموعات

    group_posts:manage
    للمدير فقط
  • إنشاء منشورات المجموعات

    إنشاء منشورات في المجموعات المنضم إليها + تعديل/حذف منشوراتك

    group_posts:create
  • إدارة منشورات المجموعات

    إدارة منشورات الآخرين في المجموعات المنضم إليها

    group_posts:moderate

التقويم / الفعاليات

  • إدارة التقويم

    التحكم الكامل في جميع الفعاليات

    calendar:manage
    للمدير فقط
  • إنشاء فعاليات

    إنشاء فعاليات جديدة + تعديل/حذف فعالياتك

    calendar:create
  • إدارة التقويم

    تعديل/حذف/إخفاء فعاليات الآخرين

    calendar:moderate

الألبومات

  • إدارة الألبومات

    التحكم الكامل في جميع الألبومات

    albums:manage
    للمدير فقط
  • إنشاء ألبومات

    إنشاء ألبومات جديدة + تعديل/حذف ألبوماتك

    albums:create
  • إدارة الألبومات

    تعديل/حذف/إخفاء ألبومات الآخرين

    albums:moderate

المدونات

  • إدارة المدونات

    التحكم الكامل في جميع المدونات

    blogs:manage
    للمدير فقط
  • إنشاء مدونات

    إنشاء مدونات جديدة + تعديل/حذف مدوناتك

    blogs:create
  • إدارة المدونات والأقسام

    تعديل/حذف/إخفاء مدونات الآخرين + إدارة أقسام المدونات

    blogs:moderate

المجموعات

  • إدارة المجموعات

    التحكم الكامل + إدارة جميع أعضاء المجموعات

    groups:manage
    للمدير فقط
  • إنشاء مجموعات

    إنشاء مجموعات جديدة + إدارة مجموعاتك

    groups:create
  • إدارة المجموعات

    إدارة المحتوى في المجموعات

    groups:moderate

المشاريع

  • إدارة المشاريع (مدير)

    التحكم الكامل في جميع المشاريع + إدارة طلبات المشاريع

    projects:manage
    للمدير فقط
  • إنشاء مشاريع

    إنشاء مشاريع جديدة + تعديل/حذف مشاريعك الخاصة فقط (لا يمكن تعديل/حذف مشاريع الآخرين)

    projects:create
  • إدارة المشاريع (مشرف)

    التحكم الكامل للمشرف: إنشاء وتعديل وحذف المشاريع + إدارة طلبات المشاريع

    projects:moderate
  • تعديل المشاريع

    تعديل/حذف المشاريع فقط (لا يمكن إنشاء مشاريع أو إدارة طلبات المشاريع)

    projects:edit

المشاريع 2

  • إدارة المشاريع 2 (مدير)

    التحكم الكامل في جميع المشاريع 2 + إدارة طلبات المشاريع 2

    projects2:manage
    للمدير فقط
  • إنشاء مشاريع 2

    إنشاء مشاريع 2 جديدة + تعديل/حذف مشاريعك 2 الخاصة فقط (لا يمكن تعديل/حذف مشاريع 2 الآخرين)

    projects2:create
  • إدارة المشاريع 2 (مشرف)

    التحكم الكامل للمشرف: إنشاء وتعديل وحذف المشاريع 2 + إدارة طلبات المشاريع 2

    projects2:moderate
  • تعديل المشاريع 2

    تعديل/حذف المشاريع 2 فقط (لا يمكن إنشاء مشاريع 2 أو إدارة طلبات المشاريع 2)

    projects2:edit

الإشعارات

  • إدارة الإشعارات

    إنشاء وإرسال الإشعارات للمستخدمين

    notifications:manage

الإعلانات

  • إدارة الإعلانات

    التحكم الكامل في لوحات الإعلانات

    ads:manage
    للمدير فقط

الإعدادات والتخصيص

  • إدارة الإعدادات

    إعدادات المجتمع، النطاق المخصص، البريد الإلكتروني المخصص

    settings:manage
  • تخصيص الصفحة الرئيسية

    تخصيص الودجات والتخطيط والمحتوى المميز

    homepage:customize

الجلسات الاستشارية

  • إدارة الجلسات الاستشارية

    التحكم الكامل في الجلسات الاستشارية - إنشاء وتعديل وحذف وإعادة ترتيب

    consultants:manage

المهام

  • إدارة المهام

    التحكم الكامل في جميع المهام والأقسام والعناوين والتعيينات والتحليلات

    tasks:manage

الاكتشاف

  • إدارة الاكتشاف

    التحكم في ظهور المجتمع في صفحة استكشاف المجتمعات بتطبيق الجوال

    discovery:manage

النطاق والبريد المخصص

  • إدارة النطاق المخصص

    إضافة وتحقق وإزالة النطاق المخصص للمجتمع

    custom_domain:manage
  • إدارة البريد المخصص

    إعداد وتحقق وإزالة نطاق البريد المخصص للمجتمع

    custom_email:manage

دردشة الدعم

  • الرد على دردشة الدعم

    عرض والرد على محادثات الدعم من أعضاء المجتمع

    support_chat:respond

القوالب

  • استخدام القوالب

    تصفح سوق القوالب واستخدام القوالب لإنشاء المحتوى

    templates:use

الشجرة العائلية

  • إدارة الشجرة العائلية

    التحكم الكامل في الشجرة العائلية - إضافة وتعديل وحذف وإعادة ترتيب الأفراد

    tree:manage

مركز المساعدة

  • الوصول إلى مركز المساعدة

    عرض صفحة مركز المساعدة الخاصة بالمجتمع (المقالات وقنوات الدعم)

    help_center:access

المساعد الذكي

  • استخدام المساعد الذكي

    استخدام المساعد الذكي (الدردشة وتوليد المحتوى) في هذا المجتمع

    ai_assistant:use
    يمكن منحها

خريطة النشاط

  • عرض خريطة النشاط

    عرض تفاصيل خريطة نشاط الأعضاء (التصنيف حسب نوع النشاط)

    activity_heatmap:view

الأوسمة

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

    التحكم الكامل في الأوسمة - إنشاء وتعديل وحذف وإدارة التصنيفات ومنح الأوسمة وسحبها

    awards:manage
  • الإشراف على الأوسمة

    إخفاء وإظهار الأوسمة دون صلاحية إنشائها أو تعديلها أو منحها

    awards:moderate

الويب هوك

  • إدارة الويب هوك

    إنشاء وتعديل وحذف نقاط الويب هوك وتدوير المفاتيح السرية وعرض سجلات التسليم

    webhooks:manage
    للمدير فقط

متجر التطبيقات

  • إدارة متجر التطبيقات

    تثبيت وإلغاء تثبيت التطبيقات — يترتب عليه اشتراكات متكررة

    app_store:manage
    للمدير فقط

مفاتيح الواجهة البرمجية

  • إدارة مفاتيح الواجهة البرمجية

    إنشاء وعرض وإلغاء مفاتيح الواجهة البرمجية لهذا المجتمع

    api_keys:manage
    للمدير فقط

التعليق والإعجاب استثناء — وهما عكس القاعدة

لا يحتاجان أي صلاحية إطلاقاً، لأن الرد هو ما يفعله العضو العادي. العضوية وحدها هي البوابة.

تعديل محتوى غيرك

حيث يقول الجدول «أو صاحبه»، تُفحص الملكية أولاً — وصاحب المحتوى على هذا السطح هو صاحب المفتاح. فمفتاحك يعدّل دائماً ما نشره هو، ويحتاج manage أو moderate لمحتوى غيره. توقّع 403 على محتوى لم ينشئه مفتاحك.

بوابات الميزات ليست صلاحيات

حين يكون القسم محجوباً بالخطة، فالمجتمع الذي لا تشمله خطته يحصل على 403 FEATURE_NOT_AVAILABLE على كل نداء في ذلك القسم — القراءات ضمناً. لا منحة تصلح ذلك؛ إنها مسألة فوترة لا إدارة.