واجهة إدارة المنصة
نقاط نهاية خاصة بالمضيف وعابرة للمستأجرين: المستأجرون، وإعدادات المضيف، ولوحة المعلومات والمراقبة، والإصدارات والميزات.
النطاق
تقع نقاط النهاية في هذه الصفحة فوق طبقة المستأجر العادية. وهي تابعة للمستأجر المضيف المعروف وتعمل عبر كل مستأجر — إنشاء المستأجرين واستعادتهم، وتحديد الإعدادات الافتراضية على مستوى المنصة، ومراقبة النسخة، وتعريف الإصدارات والميزات التي تحدد ما يمكن للمستأجرين فعله.
هذه المسارات محمية بـ حارس المضيف (host guard) وتتطلب رمز مضيف — مستخدم مُصادَق عليه عضو في مستأجر المضيف ويحمل إذن Host.* واحداً على الأقل. وهي غير متاحة داخل مستأجر عادي. يحتاج المتصلون أيضاً إلى الإذن المحدد لكل مجال: Host.Tenants.*، وHost.Settings.*، وHost.Editions.*، وHost.Dashboard.Read.
المستأجرون
دورة حياة المستأجر، واستعادة المستخدمين، وأهلية الإصدار. خاضعة لبوابة Host.Tenants.* (Create، وRead، وUpdate، وDelete، وImpersonate، وManageUsers) — وقد صُمِّم ManageUsers عمداً ليكون متمايزاً عن Impersonate بحيث تُدقَّق إجراءات الاستعادة بشكل منفصل.
| الطريقة + المسار | الغرض |
|---|---|
GET · POST /api/tenants | سرد المستأجرين · إنشاء مستأجرين |
GET · PUT · DELETE /api/tenants/{id} | إدارة مستأجر |
POST /api/tenants/{id}/toggle | تفعيل / تعطيل مستأجر |
GET /api/tenants/{id}/features | الميزات الفعلية للمستأجر |
GET /api/tenants/{id}/users | سرد مستخدمي مستأجر |
POST /api/tenants/{id}/impersonate | انتحال هوية مستأجر من قبل المضيف |
POST /api/tenants/{id}/users/{user_id}/unlock · reset-mfa · reset-password | استعادة المستخدم من جانب المضيف |
GET /api/tenants/{id}/available-editions | الإصدارات التي يمكن للمستأجر الانتقال إليها |
إعدادات المضيف
الإعدادات الافتراضية على مستوى المنصة (عامة، وأمنية، وبريد إلكتروني، وفوترة) بالإضافة إلى تجاوزات يديرها المضيف لإعدادات مستأجر فردي. خاضعة لبوابة Host.Settings.{Read,Update}.
| الطريقة + المسار | الغرض |
|---|---|
GET · PUT /api/host-settings | قراءة / تحديث إعدادات المضيف |
GET · PUT /api/settings/host | إعدادات المضيف (وحدة الإعدادات) |
GET · PUT /api/settings/tenants/{id} | إعدادات يديرها المضيف لكل مستأجر |
لوحة المعلومات والمراقبة
العرض التشغيلي عبر جميع المستأجرين. خاضع لبوابة Host.Dashboard.Read.
| الطريقة + المسار | الغرض |
|---|---|
GET /api/host/dashboard | ملخّص على مستوى المنصة |
GET /api/host/tenants/monitoring | مؤشرات الأداء التشغيلية عبر المستأجرين |
GET /api/host/tenants/{id}/monitoring | مؤشرات الأداء التشغيلية لكل مستأجر |
الإصدارات
مستويات منتج مبنية على البيانات — استحقاقات الميزات، والحدود العددية، والرؤية. خاضعة لبوابة Host.Editions.{Create,Read,Update,Delete}.
| الطريقة + المسار | الغرض |
|---|---|
GET · POST /api/editions | سرد الإصدارات · إنشاء إصدارات |
GET · PUT · DELETE /api/editions/{id} | إدارة إصدار |
GET · PUT /api/editions/{id}/features | قراءة / تحديد قيم ميزات إصدار |
GET · PUT /api/editions/{id}/tenants | قائمة السماح لرؤية الإصدار |
GET /api/features | سرد كل تعريفات الميزات |
الميزات
تعريفات الميزات هي بيانات وصفية للقراءة فقط؛ وتُدار القيم على مستوى الإصدارات (لا توجد تجاوزات لكل مستأجر). خاضعة لبوابة Host.Features.* / Host.Editions.*.
| الطريقة + المسار | الغرض |
|---|---|
GET /api/features | سرد كل تعريفات الميزات |
GET · PUT /api/editions/{id}/features | قراءة / تحديد قيم الميزات على إصدار |
GET /api/tenants/{id}/features | الميزات الفعلية لمستأجر |
تحدد الميزات ما إذا كانت قدرة ما موجودة لإصدار مستأجر؛ وتحدد الأذونات ما إذا كان بإمكان مستخدم معيّن استخدامها. يجب أن يجتاز استدعاء المضيف حارس المضيف، وأن يحمل إذن Host.* المطلوب، وأن يستهدف — عند الاقتضاء — مستأجراً يتيح إصداره تلك القدرة.