مفاهيم المنصة والهويات

تصف هذه المصطلحات نطاقات ثقة مختلفة. لا تدمج دور الإنسان ودور موظف المنصة ونطاق التطبيق في نموذج صلاحيات واحد.

التجارة والمستأجر

• المستأجر Tenant: حد البيانات المفروض لمؤسسة تاجر واحدة.
• التاجر Merchant: المؤسسة التي تشغل متجراً داخل المستأجر.
• المتجر Store: سطح التجارة وإعداداته الخاصة بالتاجر داخل ذلك المستأجر.
• المستخدم User: هوية بشرية مصادق عليها؛ ويظل الوصول معتمداً على العضوية أو تفويض موظف المنصة.

أدوار البشر لدى التاجر

• المالك Owner: أعلى دور للتاجر داخل المستأجر، ويستطيع تثبيت التطبيقات أو إلغاءها.
• المدير Admin: مدير مفوض من التاجر يستطيع أيضاً تثبيت التطبيقات أو إلغاءها.
• الموظف Staff: عضو فريق بصلاحيات تجارية أضيق، وليس مثبت تطبيق في دورة الحياة الحالية.

أدوار موظفي المنصة

• الدعم Support: موظف منصة يملك اطلاعاً للقراءة فقط على مراجعة السوق.
• المشرف الأعلى Super Admin: موظف منصة مخول بقرارات المراجعة والنشر. هذا الدور ليس اعتماد تاجر ولا نطاق تطبيق.

كائنات المطور والتطبيق

• المطور Developer: هوية ناشر خارجي مستقلة عن عضوية التاجر.
• التطبيق App: هوية السوق وقائمة العرض الثابتة التي يملكها حساب المطور.
• إصدار التطبيق App Version: هدف مراجعة محدد يضم إصداراً دلالياً وعناوين إعادة توجيه مطابقة ونطاقات مطلوبة وتصريحات Webhook وملاحظات إصدار.
• التثبيت Installation: منحة خاصة بمستأجر مرتبطة بتطبيق وإصدار منشور محدد.
• النطاق Scope: صلاحية محدودة مسماة يطلبها الإصدار ويمنحها التاجر صراحة.

بيانات الاعتماد والأحداث

• رمز الوصول Access token: اعتماد قصير العمر مرتبط بتثبيت نشط ومنحه.
• رمز التحديث Refresh token: اعتماد دوار يستخدمه الخادم للحصول على زوج رموز جديد.
• Webhook: محاولة تسليم HTTPS موقعة إلى نقطة نهاية التطبيق.
• الحدث Event: معرف ثابت ونوع ووقت وقوع وحمولة توضع في الطابور للاشتراكات المطابقة.

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

• إصدار API: نسخة عقد HTTP العام الموجودة في المسار؛ النسخة الحالية /api/v1.
• مراجعة السوق: عملية موافقة لكل إصدار تطبيق يجريها موظفو المنصة قبل النشر. خط المراجعة الحالي جزئي وستضاف إليه عمليات تحقق أقوى لاحقاً.