# الدفع وقيود الوصول

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

***

## نظرة عامة

تُعالَج حالات فشل الدفع عبر 8 مراحل تصعيد، تبدأ بتحذير وتبلغ ذروتها بأرشفة المبنى بالكامل في اليوم 60. وفي كل مرحلة:

* تُحظَر ميزات محددة.
* تُرسَل إشعارات بريد إلكتروني إلى مالك المبنى ومدير الحساب وجميع أصحاب المصلحة.
* يعرض المبنى شريطًا داخل التطبيق يوضّح القيد والإجراء المطلوب.

***

## مراحل التصعيد

### المرحلة 1: INVOICE\_FAILED

**المُحفِّز:** فشل محاولة الدفع الأولية (اليوم 0).

**القيود:** لا شيء — هذه مرحلة تحذير فقط. تبقى جميع الميزات متاحة بالكامل.

**الإجراء المطلوب:** تحديث طريقة الدفع وإعادة محاولة الدفع عبر قسم إدارة الاشتراك.

**الإشعارات:** بريد إلكتروني يُرسَل إلى المالك ومدير الحساب يحذّر من فشل الفاتورة وضرورة الدفع.

***

### المرحلة 2: OVERDUE\_3\_DAYS

**المُحفِّز:** تأخّر الدفع لمدة 3 أيام.

**القيود:**

* **سكّ DTT محظور.** لا يمكنك بدء سكّ جديد أو تحديث DTT قائم حتى حل مشكلة الدفع.

**الميزات التي لا تزال متاحة:** Data Room وعارض BIM ثلاثي الأبعاد وعارض المسح وتقسيم القطع والمخطط التشغيلي للموائع والمعرض والمكافآت والمهام وموجز النشاط.

**الإشعارات:** بريد إلكتروني يُرسَل إلى المالك ومدير الحساب وجميع أصحاب المصلحة.

***

### المرحلة 3: OVERDUE\_7\_DAYS

**المُحفِّز:** تأخّر الدفع لمدة 7 أيام.

**القيود:**

* يبقى سكّ DTT محظورًا.
* **رفع الوثائق محظور.** لا يمكن رفع وثائق جديدة إلى Data Room.
* **التحقق من الوثائق محظور.** لا يمكن للمحققين الموافقة على الوثائق أو رفضها.

**الميزات التي لا تزال متاحة:** وصول للقراءة فقط إلى Data Room (العرض والتنزيل) وعارض BIM ثلاثي الأبعاد وعارض المسح وتقسيم القطع (للقراءة فقط) والمخطط التشغيلي للموائع (للقراءة فقط) والمعرض (العرض).

**الإشعارات:** بريد إلكتروني يُرسَل إلى المالك ومدير الحساب وجميع أصحاب المصلحة.

***

### المرحلة 4: OVERDUE\_14\_DAYS

**المُحفِّز:** تأخّر الدفع لمدة 14 يومًا.

**القيود:**

* تبقى جميع قيود المرحلة 3 سارية.
* **وصول عارض BIM ثلاثي الأبعاد محظور.** لم يعد بإمكان أصحاب المصلحة التفاعل مع النموذج ثلاثي الأبعاد.
* **وصول عارض المسح محظور.** لم يعد عرض مسح السحابة النقطية متاحًا.

**ملاحظة:** ‏`canScanAccess` علامة صلاحية منفصلة. تُضبط هذه العلامة صراحةً على false في هذه المرحلة لجميع أصحاب المصلحة.

**الميزات التي لا تزال متاحة:** وصول للقراءة فقط إلى Data Room (محدود) والمعرض (العرض فقط).

**الإشعارات:** بريد إلكتروني يُرسَل إلى المالك ومدير الحساب وجميع أصحاب المصلحة.

***

### المرحلة 5: OVERDUE\_30\_DAYS

**المُحفِّز:** تأخّر الدفع لمدة 30 يومًا.

**القيود:**

* تبقى جميع قيود المرحلة 4 سارية.
* تُطبَّق قيود وصول إضافية عبر الميزات المتبقية المتاحة.

**الإشعارات:** بريد إلكتروني يُرسَل إلى المالك ومدير الحساب وجميع أصحاب المصلحة.

***

### المرحلة 6: PRE\_ARCHIVE\_7\_DAYS

**المُحفِّز:** 7 أيام قبل الموعد النهائي للأرشفة (عادةً اليوم 53 من فترة التأخر).

**القيود:**

* تبقى جميع قيود المرحلة 5 سارية.
* يُعرض **شريط تحذير بارز** عبر واجهة المبنى بأكملها:

> "ستُؤرشَف هذه المبنى خلال 7 أيام بسبب عدم الدفع. ادفع الآن لاستعادة الوصول الكامل ومنع أرشفة البيانات."

هذه مرحلة تحذير نهائية تمنح أصحاب المصلحة 7 أيام للتصرف قبل أرشفة المبنى بالكامل.

**الإشعارات:** بريد إلكتروني يُرسَل إلى المالك ومدير الحساب وجميع أصحاب المصلحة برسائل تحثّ على الاستعجال.

***

### المرحلة 7: PRE\_ARCHIVE\_3\_DAYS

**المُحفِّز:** 3 أيام قبل الموعد النهائي للأرشفة (عادةً اليوم 57 من فترة التأخر).

**القيود:**

* تبقى جميع قيود المرحلة 6 سارية.
* يُحدَّث شريط التحذير ليعكس تبقّي 3 أيام.

**الإشعارات:** بريد إلكتروني يُرسَل إلى المالك ومدير الحساب وجميع أصحاب المصلحة برسائل استعجال نهائية.

***

### المرحلة 8: ARCHIVED

**المُحفِّز:** اليوم 60 من فترة التأخر.

**القيود:**

* **جميع الميزات معطَّلة.** يُؤرشَف المبنى بالكامل.
* كل وصول إلى Data Room ووصول عارض BIM ووصول عارض المسح وتقسيم القطع والمخطط التشغيلي للموائع والمعرض وسكّ DTT والمكافآت — كل شيء غير متاح.
* يبقى المبنى مرئيًا في لوحة المعلومات مع شارة حالة ARCHIVED، لكن النقر للدخول إليه يُظهر شاشة مقفلة.
* **بدء إجراء التحصيل.** تُحال الفاتورة المستحقة إلى عملية تحصيل.

**الاحتفاظ بالبيانات:** يُحتفَظ ببيانات المبنى لكنها غير متاحة. ولا تُحذَف البيانات فورًا — اتصل بالدعم لمناقشة خيارات استرجاع البيانات.

**الإشعارات:** بريد إلكتروني يُرسَل إلى المالك ومدير الحساب وجميع أصحاب المصلحة لإخطارهم بالأرشفة.

***

## ملخص القيود حسب المرحلة

| المرحلة               | أيام التأخر | السكّ     | الرفع/التحقق | BIM/المسح | جميع الميزات   |
| --------------------- | ----------- | --------- | ------------ | --------- | -------------- |
| INVOICE\_FAILED       | 0           | متاح      | متاح         | متاح      | متاح           |
| OVERDUE\_3\_DAYS      | 3           | **محظور** | متاح         | متاح      | متاح           |
| OVERDUE\_7\_DAYS      | 7           | **محظور** | **محظور**    | متاح      | متاح           |
| OVERDUE\_14\_DAYS     | 14          | **محظور** | **محظور**    | **محظور** | متاح (محدود)   |
| OVERDUE\_30\_DAYS     | 30          | **محظور** | **محظور**    | **محظور** | محدود          |
| PRE\_ARCHIVE\_7\_DAYS | \~53        | **محظور** | **محظور**    | **محظور** | الحد الأدنى    |
| PRE\_ARCHIVE\_3\_DAYS | \~57        | **محظور** | **محظور**    | **محظور** | الحد الأدنى    |
| ARCHIVED              | 60          | **محظور** | **محظور**    | **محظور** | **الكل محظور** |

***

## استعادة الوصول

لاستعادة الوصول الكامل في أي مرحلة قبل ARCHIVED:

1. انتقل إلى قسم **إدارة الاشتراك** (متاح حتى أثناء فشل الدفع).
2. اذهب إلى علامة تبويب **الفواتير**.
3. انقر على الفاتورة الفاشلة وحدّث أو أكّد طريقة الدفع الخاصة بك.
4. أكمل الدفع.

بمجرد تأكيد الدفع:

* تُزال قيود الوصول فورًا (خلال دقائق).
* تعود شارة حالة المبنى إلى **Active**.
* يُعاد تفعيل جميع الميزات المحظورة.
* يُرسَل بريد إلكتروني تأكيدي إلى المالك ومدير الحساب.

> **مهم:** حل الدفع قبل اليوم 60 يمنع الأرشفة. وإذا كان المبنى قد أُرشِف بالفعل (المرحلة 8)، فاتصل بدعم Magma لمناقشة خيارات الاستعادة.

***

## إشعارات البريد الإلكتروني

في كل مرحلة تصعيد، تُرسَل إشعارات بريد إلكتروني إلى:

* **مالك المبنى** — يستلم جميع الإشعارات في كل مرحلة.
* **مدير الحساب** — يستلم جميع الإشعارات في كل مرحلة.
* **جميع أصحاب المصلحة** — يستلمون الإشعارات من المرحلة 2 فصاعدًا.

صُمِّم تصاعد إلحاح رسائل البريد الإلكتروني لضمان أن يصبح طرف مسؤول واحد على الأقل على دراية ويتّخذ إجراءً قبل وقوع الأرشفة.

***

## علامة canScanAccess

تتحكم علامة صلاحية مخصصة في إمكانية الوصول إلى عارض المسح: ‏`canScanAccess`. تُدار هذه العلامة باستقلالية عن صلاحيات الوصول العامة للمبنى.

* في المرحلة 4 (OVERDUE\_14\_DAYS)، تُضبط `canScanAccess` على **false** لجميع أصحاب المصلحة.
* عند استعادة الدفع، تُعاد `canScanAccess` إلى **true** لجميع أصحاب المصلحة.

تنطبق هذه العلامة أيضًا في سياقات أخرى — فعلى سبيل المثال، قد تُضبط `canScanAccess` على false لأدوار أصحاب مصلحة محددة من قِبل مديري المبنى بغض النظر عن حالة الدفع، إذا كانت بيانات المسح تُعدّ حساسة بالنسبة لدورهم.

***

## نصائح لتجنّب فشل الدفع

* **أعدّ الفوترة التلقائية** مع طريقة دفع صالحة مسجّلة — فهذه أكثر الطرق موثوقيةً لمنع حالات فشل الدفع.
* **عيّن مدير حساب** مسؤولًا عن الفوترة يراقب إشعارات الفواتير.
* **تفاعل مع INVOICE\_FAILED فورًا** — فحل المشكلة في المرحلة 1 يمنع أي قيود على الميزات ويُحَل الوضع قبل تصعيده.
* **تجنّب مرحلة OVERDUE\_7\_DAYS** — فحظر رفع الوثائق والتحقق منها في هذه المرحلة يعني توقّف تقدّم Magma Index، وعدم إمكانية كسب المكافآت، وتعطّل سير عمل فريقك.
* **لا تدع المبنى يصل أبدًا إلى حالة ARCHIVED** — فاسترجاع البيانات من مبنى مؤرشَف يتطلب تدخّل الدعم وقد ينطوي على إجراءات استرداد إضافية.


---

# 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/payment-failure.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.