# دورة حياة المستند

يمر كل مستند على Magma بمجموعة محددة من الحالات منذ الرفع الأول وحتى السجل الدائم على البلوكتشين.

## تدفق الحالات

```
Upload
  └─ DRAFT
       └─ Submit for validation
              └─ PENDING_VALIDATION
                    ├─ All validators approve
                    │      └─ VALIDATED ──────────────── Minting ──► MINTED
                    │                                             └─ Time passes ──► EXPIRED
                    │                                             └─ New version ──► REPLACED
                    └─ Any validator rejects
                           └─ REQUIRING_ACTION
                                  └─ Uploader corrects & resubmits
                                         └─ CORRECTED → PENDING_VALIDATION (cycle repeats)
```

### حالات خاصة

* **DUPLICATED**: اكتشف النظام أن الملف المرفوع مطابق لملف تم التحقق منه بالفعل في نوع المستند نفسه
* **REVERTED\_TO\_DRAFT**: فقد المدققون المسندون لمستند مُرسَل وصولهم إلى المبنى (مثلًا، بسبب إلغاء اتفاقيتهم). يعود المستند إلى المسودة حتى يمكن إسناد مدققين جدد قبل إعادة الإرسال

***

## أوصاف الحالات

| الحالة                 | اللون   | المعنى                                                             | ما يجب فعله                                                                |
| ---------------------- | ------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------- |
| **Draft**              | رمادي   | مرفوع لكن لم يُرسَل بعد. أنت وحدك من يمكنه رؤيته.                  | أرسله عندما يكون جاهزًا — اختر مدققيك وانقر على إرسال                      |
| **Pending Validation** | برتقالي | مُرسَل وبانتظار أصوات المدققين                                     | انتظر المدققين. ستُبلَّغ عند تصرفهم.                                       |
| **Validated**          | أخضر    | وافق عليه جميع المدققين المهيَّئين                                 | مؤهل للسَكّ. لا حاجة لأي إجراء.                                            |
| **Requiring Action**   | أحمر    | رفضه مدقق واحد على الأقل                                           | تحقق من سبب الرفض في لوحة المستند، صحِّح الملف، وأعد إرساله                |
| **Corrected**          | —       | استبدلت نسخة مصححة مستندًا مرفوضًا سابقًا                          | تدخل النسخة المصححة حالة Pending Validation                                |
| **Duplicated**         | —       | محتوى الملف يطابق مستندًا تم التحقق منه بالفعل                     | ارفع ملفًا مختلفًا أو اتصل بالدعم إذا كان هذا خطأً                         |
| **Reverted to Draft**  | رمادي   | تمت إزالة المدققين من المبنى بعد الإرسال                           | أسند مدققين جددًا وأعد الإرسال                                             |
| **Minted**             | أزرق    | مسجَّل على البلوكتشين. تُخزَّن بصمة المستند (hash) في HashStorage. | لا حاجة لأي إجراء إضافي. المستند موجود بشكل دائم على السلسلة.              |
| **Expired**            | أحمر    | انقضت فترة صلاحية المستند                                          | ارفع نسخة جديدة. ستُسنَد إليك مهمة لذلك.                                   |
| **Replaced**           | —       | تم التحقق من نسخة أحدث وهي تحلّ محل هذه                            | النسخة الأحدث هي المستند النشط الآن. تبقى النسخة القديمة في سجل الإصدارات. |

***

## التحقق متعدد المستويات

يمكن أن يحتوي كل نوع مستند على ما يصل إلى **ثلاثة مستويات للمدققين**:

| المستوى        | مطلوب؟              | ملاحظات                     |
| -------------- | ------------------- | --------------------------- |
| المدقق الأساسي | نعم (إن كان مهيَّأ) | يجب أن يوافق ليتقدم المستند |
| المدقق الثانوي | إن كان مهيَّأ       | يجب أن يوافق أيضًا          |
| المدقق الثالثي | إن كان مهيَّأ       | تأكيد إضافي اختياري         |

**يجب أن يوافق جميع المدققين المهيَّئين.** يؤدي رفض واحد من أي مدقق إلى إعادة المستند إلى Requiring Action، بصرف النظر عن عدد من وافق غيره.

عندما يرفض مدقق، يجب أن يقدم سببًا. يرى الرافع هذا السبب ويمكنه التصرف وفقًا له قبل إعادة الإرسال.

***

## استبدال المستند

عندما تحتاج إلى تحديث مستند سبق إرساله أو التحقق منه، فإنك ترفع **بديلًا** بدلًا من ملف جديد. وهناك نوعان:

| النوع            | متى تستخدمه                                                    | الأثر                                                                                   |
| ---------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **Total Update** | تغيَّر المستند جوهريًا — محتوى جديد، إصدار جديد، مراجعة جوهرية | تُعلَّم النسخة القديمة بـ REPLACED. تدخل النسخة الجديدة Pending Validation بدورة جديدة. |
| **Correction**   | إصلاح بسيط — خطأ مطبعي، تنسيق، خطأ صغير                        | تُعلَّم النسخة القديمة بـ CORRECTED. تدخل النسخة الجديدة Pending Validation.            |

يتطلب كلا النوعين **سببًا** (5 أحرف كحد أدنى) يوضح سبب إجراء الاستبدال. يُخزَّن هذا السبب في سجل النشاط لأغراض التدقيق.

***

## فترات صلاحية المستندات

تنتهي صلاحية بعض أنواع المستندات تلقائيًا بعد فترة محددة. عند انتهاء صلاحية مستند:

1. تتغير حالته إلى **Expired**
2. تنخفض نتيجة Magma Index لفئة ذلك المستند
3. تُسنَد مهمة **UPDATE\_EXPIRED\_DOCUMENT** إلى الرافع الأصلي
4. تبرز نظرة المبنى العامة ومركز المهام المستند منتهي الصلاحية

| فترة الصلاحية         | المستندات                                                                                    |
| --------------------- | -------------------------------------------------------------------------------------------- |
| **سنة واحدة**         | تأمين المبنى، حالة الرهن العقاري، بيانات الأرباح والخسائر، اتفاقية خدمات الأمن، السجل الأمني |
| **شهر واحد**          | الضرائب العقارية، تقارير التدقيق، تقدير الميزانية/التكلفة التشغيلية، خطة الأمن               |
| **عند اكتمال المبنى** | شهادة الإشغال، تقدير تكلفة البناء                                                            |
| **دائم**              | سند الملكية، الصك، السجل العقاري، ومعظم المستندات القانونية والتشخيصية والفنية               |

***

## سجل الإصدارات

يحتفظ كل مستند بسجل إصدارات كامل يمكن الوصول إليه من لوحة معلومات المستند. يمكنك:

* عرض جميع الإصدارات السابقة مع تواريخ رفعها وحالاتها
* النقر على أي إصدار للتبديل إلى عرض ذلك الإصدار
* معرفة أي إصدار نشط حاليًا (مُعلَّم كإصدار أساسي)
* رؤية شارات حالة REPLACED وCORRECTED على الإصدارات المُستبدَلة

تكون البصمة التشفيرية (hash) لكل إصدار مرئية في لوحة المستند وتُسجَّل على السلسلة بعد السَكّ. وهذا يجعل من الممكن التحقق من المحتوى الدقيق لأي إصدار تاريخي في أي وقت في المستقبل.


---

# 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/almrja/document-lifecycle.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.