# إدارة الاشتراك

يتيح قسم إدارة الاشتراك لملّاك المباني ومديري الحسابات عرض خطة اشتراك المبنى وإدارتها وتعديلها. ويوفّر رؤية كاملة لدورات الفوترة، والاستخدام الحالي مقابل حدود الخطة، وسجل الفواتير، وخيارات تغيير الخطة — بما في ذلك الإضافات عند بلوغ حدود الاستخدام.

***

## نظرة عامة

يخضع كل مبنى على Magma لاشتراكه الخاص. وهناك 3 خطط اشتراك:

| الخطة         | الوصف                                                                                                                   |
| ------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Essential** | خطة المستوى المبتدئ بحدود معتدلة على أصحاب المصلحة والتخزين وعمليات API وإشعارات البريد الإلكتروني. بدون دعم ذي أولوية. |
| **Premium**   | خطة من مستوى أعلى بحدود موسَّعة ودعم ذي أولوية مُضمَّن.                                                                 |
| **Infinity**  | الخطة من أعلى مستوى بحدود قصوى أو غير محدودة عبر جميع الأبعاد ودعم ذي أولوية.                                           |

***

## الوصول إلى إدارة الاشتراك

إدارة الاشتراك متاحة عبر:

* **إعدادات المبنى** ← علامة تبويب الاشتراك.
* قائمة الإجراءات السريعة (⋯) على بطاقة المبنى في لوحة المعلومات ← عرض الاشتراك.

يستطيع **الملّاك** و**مديرو الحسابات** فقط الوصول إلى إدارة الاشتراك.

***

## نافذة تفاصيل الاشتراك

تُنظَّم نافذة تفاصيل الاشتراك في 3 علامات تبويب:

***

### علامة التبويب 1: التفاصيل

توفّر علامة تبويب التفاصيل نظرة عامة كاملة على حالة الاشتراك الحالية والاستخدام.

#### الخطة والحالة

| الحقل            | الوصف                                                 |
| ---------------- | ----------------------------------------------------- |
| **الخطة**        | اسم الخطة الحالية (Essential أو Premium أو Infinity). |
| **الحالة**       | حالة الاشتراك الحالية (انظر الحالات أدناه).           |
| **فترة الفوترة** | تكرار الفوترة: شهري أو سنوي.                          |
| **تغيير الخطة**  | زر لبدء تغيير الخطة (يفتح علامة تبويب تغيير الخطة).   |

**حالات الاشتراك**

| الحالة       | الوصف                                                                               |
| ------------ | ----------------------------------------------------------------------------------- |
| **Active**   | الاشتراك ساري وجميع الميزات متاحة بالكامل.                                          |
| **Canceled** | أُلغي الاشتراك. ويبقى ساريًا حتى نهاية فترة الفوترة الحالية، وبعدها يُقيَّد الوصول. |
| **Paused**   | أُوقف الاشتراك مؤقتًا (مثلًا: بناءً على طلب المشترك).                               |
| **Expired**  | انتهت فترة فوترة الاشتراك دون تجديد.                                                |

#### الفترة الحالية

معلومات عن دورة الفوترة النشطة:

| الحقل               | الوصف                                                     |
| ------------------- | --------------------------------------------------------- |
| **رقم الدورة**      | الرقم التسلسلي لدورة الفوترة الحالية (مثلًا: "الدورة 7"). |
| **بداية الفترة**    | تاريخ بداية فترة الفوترة الحالية.                         |
| **نهاية الفترة**    | تاريخ نهاية فترة الفوترة الحالية.                         |
| **الأيام المتبقية** | عدد الأيام المتبقية في فترة الفوترة الحالية.              |

#### فترة الترخيص

فترة الترخيص الإجمالية للاشتراك (تاريخا البداية والنهاية)، التي قد تختلف عن دورة الفوترة الفردية إذا اشتُري ترخيص متعدد السنوات.

#### الحدود

تفصيل لحدود استخدام الخطة الحالية مقابل الاستخدام الفعلي الحالي:

| الحد                          | الوصف                                                             |
| ----------------------------- | ----------------------------------------------------------------- |
| **أصحاب المصلحة**             | العدد الحالي لأصحاب المصلحة مقابل الحد الأقصى للخطة.              |
| **عمليات API**                | العدد الحالي لعمليات API مقابل ما تسمح به الخطة.                  |
| **إشعارات البريد الإلكتروني** | العدد الحالي مقابل ما تسمح به الخطة.                              |
| **التخزين (GB)**              | استخدام التخزين الحالي مقابل سقف تخزين الخطة.                     |
| **الدعم ذو الأولوية**         | ما إذا كان الدعم ذو الأولوية مُضمَّنًا في الخطة الحالية (نعم/لا). |

تُظهر أشرطة التقدم أو مؤشرات النسبة المئوية مدى قرب كل بُعد من حده.

#### معلومات إضافية

| البند                              | الوصف                                                             |
| ---------------------------------- | ----------------------------------------------------------------- |
| **تحذير الإلغاء عند نهاية الفترة** | إذا ضُبط الاشتراك على الإلغاء عند نهاية الفترة، يُعرض شريط تحذير. |
| **تاريخ الإلغاء**                  | إذا أُلغي الاشتراك، يُعرض تاريخ الإلغاء.                          |

***

### علامة التبويب 2: الفواتير

قائمة كاملة بجميع الفواتير التاريخية لاشتراك هذا المبنى.

يتضمن كل صف فاتورة:

| العمود           | الوصف                                       |
| ---------------- | ------------------------------------------- |
| **رقم الفاتورة** | رقم المرجع الفريد للفاتورة.                 |
| **التاريخ**      | تاريخ توليد الفاتورة.                       |
| **وسم الدفع**    | شارة "Paid" خضراء إذا دُفعت الفاتورة بنجاح. |
| **المبلغ**       | إجمالي المبلغ المُحمَّل.                    |
| **التنزيل**      | زر لتنزيل الفاتورة كملف PDF.                |

تُدرج الفواتير بترتيب زمني عكسي (الأحدث أولًا).

***

### علامة التبويب 3: تغيير الخطة

تتيح لك علامة تبويب تغيير الخطة الترقية أو التخفيض لخطة الاشتراك.

#### جدول اختيار الخطة

جدول مقارنة يعرض جميع الخطط المتاحة (Essential وPremium وInfinity) مع ميزاتها وأسعارها. ويُبرز الخطة الحالية.

#### معاينة التناسب

عند اختيارك خطة جديدة، تُعرض **معاينة تناسب** قبل التأكيد. وتُظهر بدقة ما سيُحمَّل:

| البند                         | الوصف                                                                 |
| ----------------------------- | --------------------------------------------------------------------- |
| **رصيد الخطة القديمة**        | الرصيد المتناسب للأيام غير المستخدمة المتبقية على الخطة الحالية.      |
| **رسم الخطة الجديدة**         | الرسم المتناسب للخطة الجديدة من اليوم حتى نهاية دورة الفوترة الحالية. |
| **صافي المبلغ المستحق اليوم** | الفرق بين الرسم الجديد والرصيد القديم (قد يكون موجبًا أو سالبًا).     |
| **السعر المتكرر الجديد**      | السعر الكامل الذي سيُحمَّل بدءًا من دورة الفوترة التالية.             |

#### تحذير المخالفات

إذا كانت حدود الخطة الجديدة أقل من استخدامك الحالي في أي بُعد، يُعرض **تحذير مخالفات** قبل التأكيد. على سبيل المثال:

> "يتجاوز عدد أصحاب المصلحة الحالي لديك (12) حد خطة Essential (8). سيؤدي التغيير إلى هذه الخطة إلى تقييد القدرة على إضافة أصحاب مصلحة جدد حتى ينخفض العدد دون 8."

يمنع هذا التحذير عمليات التخفيض العرضية التي قد تقيّد عمليات المبنى فورًا.

#### مربع تأكيد الاختيار

يجب تحديد مربع تأكيد إلزامي قبل إمكانية إرسال تغيير الخطة. ويلخّص نص المربع التغيير الجاري إجراؤه وصافي المبلغ الذي سيُحمَّل.

***

## نافذة بلوغ الحد

عند بلوغ أي حد للخطة (أصحاب المصلحة أو التخزين أو عمليات API أو إشعارات البريد الإلكتروني)، تُرشدك **نافذة بلوغ الحد** خلال إضافة سعة دون الحاجة إلى ترقية كاملة للخطة. وتتبع النافذة تدفّقًا من 4 خطوات:

### الخطوة 1: عرض الحدود المبلوغة

ملخص واضح للحدود التي بُلغت وبأي مقدار. على سبيل المثال:

> "لقد بلغت حد أصحاب المصلحة (8/8 مستخدَمة)."

### الخطوة 2: اختيار نوع الإضافة

اختر نوع السعة المراد إضافتها:

| نوع الإضافة                   | الوصف                                                                   |
| ----------------------------- | ----------------------------------------------------------------------- |
| **أصحاب المصلحة**             | إضافة سعة لمزيد من حسابات أصحاب المصلحة.                                |
| **تخزين GB**                  | إضافة سعة تخزين وثائق إضافية.                                           |
| **إشعارات البريد الإلكتروني** | إضافة حصة إشعارات بريد إلكتروني إضافية.                                 |
| **عمليات API**                | إضافة حصة عمليات API إضافية.                                            |
| **الدفع حسب الاستخدام**       | للفوترة القائمة على الاستهلاك — ادفع فقط مقابل ما تستخدمه فوق حد الخطة. |

### الخطوة 3: اختيار الحزمة

اختر من أحجام الحزم المتاحة لنوع الإضافة المحدد. تُقدَّم الحزم بكميات محددة مسبقًا (مثلًا: +10 أصحاب مصلحة، +50GB تخزين). ويُعرض السعر لكل حزمة.

### الخطوة 4: المعاينة قبل التأكيد

شاشة ملخص نهائية تُظهر:

| العنصر      | الوصف                                           |
| ----------- | ----------------------------------------------- |
| **قبل**     | الحدود والاستخدام الحاليان.                     |
| **بعد**     | الحدود الجديدة بعد تطبيق الإضافة.               |
| **التسعير** | التكلفة الإضافية لكل فترة فوترة للحزمة المحددة. |

يُنهي زر **Confirm** شراء الإضافة. وتُعالَج الدفعة فورًا باستخدام البطاقة المسجّلة.

***

## نصائح لإدارة الاشتراك

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mymagma.com/magma-documentation/ar/almyzat/subscription-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.