# Data Room

تُعد Data Room المركز الرئيسي لإدارة المستندات في منصة Magma. فهي توفر تخزينًا آمنًا ومنظمًا لجميع المستندات المتعلقة بالمبنى، مع دعم لإصدارات المستندات، والتجزئة التشفيرية، ومشاركة أصحاب المصلحة، والتعليقات التوضيحية، وسير عمل التحقق، والسك على البلوكتشين.

***

## أوضاع التخطيط

تقدم Data Room وضعين للتخطيط، يمكن التبديل بينهما عبر شريط الأدوات:

### الوضع الموسّع (3 أعمدة)

العرض الافتراضي. تُعرض ثلاث لوحات جنبًا إلى جنب:

1. **اللوحة اليسرى** — التنقل في شجرة/قائمة المستندات.
2. **اللوحة الوسطى** — صفوف المستندات للفئة المختارة.
3. **اللوحة اليمنى** — لوحة معلومات المستند للمستند المختار.

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

### الوضع المضغوط

يتم طي لوحة المعلومات اليمنى. تُعرض المستندات بتنسيق قائمة/شبكة أوسع، مما يسهل تصفح المجموعات الكبيرة دون التركيز على مستند واحد. يؤدي النقر على صف مستند إلى فتح لوحة المعلومات كتراكب أو توسيع التخطيط مؤقتًا.

***

## بنية التنقل

تُنظّم المستندات في تسلسل هرمي صارم يُسمى **شجرة Magma Index**:

```
المستوى (Genesis / Structure / Architecture / Wired / Filled)
  └── الفئة (مثل الملكية، القانوني، التأمين)
        └── تعريف المستند (مثل سند الملكية، السجل العقاري)
              └── مجلد IFC الفرعي (لأنواع المستندات المعمول بها)
```

### عرض الشجرة

تعرض اللوحة اليسرى هذا التسلسل الهرمي كشجرة قابلة للتوسيع. يؤدي النقر على عقدة إلى توسيع أو طي العناصر الفرعية لها. يؤدي النقر على عقدة **تعريف المستند** إلى تحميل مستنداتها في اللوحة الوسطى.

### عرض القائمة

عرض مسطح بديل يعرض جميع المستندات عبر جميع الفئات في قائمة واحدة قابلة للتمرير، دون التجميع الهرمي. مفيد لتصفح جميع المستندات بسرعة بغض النظر عن المستوى أو الفئة.

### مجلدات IFC الفرعية

تدعم بعض تعريفات المستندات ملفات IFC (Industry Foundation Classes). تُظهر هذه التعريفات **مجلد IFC فرعي** داخل شجرة المستندات. داخل مجلد IFC الفرعي، يتوفر زرّان للإجراء:

* **فتح في BIM** — يفتح ملف IFC في [BIM 3D Viewer](/magma-documentation/ar/almyzat/bim-3d-viewer.md).
* **فتح في Scan** — يفتح المسح المرتبط في [Scan Viewer](/magma-documentation/ar/almyzat/scan-viewer.md).

***

## صف المستند

يُعرض كل مستند كصف في اللوحة الوسطى. يحتوي الصف على العناصر التالية:

| العنصر                 | الوصف                                          |
| ---------------------- | ---------------------------------------------- |
| أيقونة الحالة          | مؤشر مرئي للحالة الحالية للمستند (انظر أدناه). |
| اسم المستند            | الاسم القابل للقراءة لتعريف المستند.           |
| الإصدار                | رقم الإصدار الحالي (مثل v1، v2، v3).           |
| اسم الملف الأصلي       | اسم الملف الفعلي للملف المرفوع.                |
| الفئة                  | فئة المستند ضمن Magma Index.                   |
| حجم الملف              | حجم الملف المرفوع.                             |
| صورة المالك الرمزية    | الصورة الشخصية لرافع المستند (المالك).         |
| الصور الرمزية للمدققين | الصور الشخصية للمدققين المعينين (حتى 3).       |
| آخر تغيير              | الطابع الزمني النسبي أو المطلق لأحدث تغيير.    |

***

## حالة المستند

تنتقل المستندات عبر دورة حياة محددة، يُشار إليها بشارة حالة:

| الحالة                 | الوصف                                                      |
| ---------------------- | ---------------------------------------------------------- |
| **Draft**              | تم رفع المستند ولكن لم يُقدّم للتحقق بعد.                  |
| **Pending Validation** | تم تقديم المستند وهو في انتظار مراجعة المدقق.              |
| **Validated**          | وافق جميع المدققين المعينين على المستند.                   |
| **Minted**             | تم تضمين المستند في عملية سك DTT على البلوكتشين.           |
| **Requiring Action**   | يتطلب المستند انتباهًا — عادةً لأنه رُفض أو انتهت صلاحيته. |

***

## لوحة معلومات المستند

يؤدي اختيار صف مستند إلى فتح لوحة معلومات المستند على الجانب الأيمن من الشاشة (أو كتراكب في الوضع المضغوط). توفر هذه اللوحة تفاصيل كاملة عن المستند المختار:

### معلومات الرافع

* **الصورة الرمزية** للرافع و**الاسم الكامل** و**الدور على المنصة** (مثل المهندس المعماري، المالك).

### شارات الحالة

تظهر شارات حالة خاصة عند الاقتضاء:

* **REPLACED** — يحل إصدار المستند هذا محل إصدار أقدم عبر استبدال بالتحديث الكامل.
* **CORRECTED** — يحل إصدار المستند هذا محل إصدار أقدم عبر استبدال بالتصحيح.

### البيانات الوصفية

| الحقل                 | الوصف                                                                                                            |
| --------------------- | ---------------------------------------------------------------------------------------------------------------- |
| حجم الملف             | حجم ملف المستند الحالي.                                                                                          |
| تاريخ الرفع           | تاريخ ووقت رفع الملف.                                                                                            |
| تاريخ التحقق          | التاريخ الذي وصل فيه المستند إلى حالة Validated (إن وُجد).                                                       |
| تاريخ انتهاء الصلاحية | التاريخ الذي تنتهي بعده صلاحية المستند (يختلف حسب نوع المستند — انظر فترات الصلاحية).                            |
| تجزئة المستند         | تجزئة تشفيرية لمحتويات الملف. تُخزّن هذه التجزئة أيضًا على البلوكتشين أثناء السك ويمكن استخدامها لإثبات الأصالة. |

### سجل أحدث نشاط

موجز زمني لجميع الأحداث المتعلقة بهذا المستند، بما في ذلك:

* رفع الملف
* إرسال للتحقق
* موافقة / رفض المدقق
* استبدال أو تصحيح المستند
* سك المستند
* منح / إلغاء الوصول

### قائمة المستخدمين المصرح لهم

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

* الصورة الرمزية للمستخدم واسمه
* دوره أو نوع وصوله (صاحب مصلحة في المبنى، ضيف غير مسجل، ضيف مستخدم Magma)
* زر **إلغاء** لإزالة وصوله فورًا

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

قائمة بجميع الإصدارات السابقة لهذا المستند، بترتيب زمني عكسي. كل إدخال إصدار قابل للنقر ويحمّل البيانات الوصفية والملف لذلك الإصدار. تعرض الإصدارات:

* رقم الإصدار
* تاريخ الرفع
* الحالة وقت الاستبدال
* نوع الاستبدال (تحديث كامل أو تصحيح)

***

## التصفية والفرز

### البحث

حقل بحث بالنص الكامل أعلى قائمة المستندات. يبحث عبر أسماء المستندات وأسماء الملفات والفئات.

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

تصفية المستندات حسب حالتها الحالية:

* Draft
* Pending Validation
* Validated
* Minted
* Requiring Action

يمكن اختيار حالات متعددة في وقت واحد.

### تصفية المستوى

تصفية المستندات حسب مستوى Magma Index الخاص بها:

* Genesis
* Structure
* Architecture
* Wired (من W1 إلى W5)
* Filled

### تصفية الدور

التبديل بين:

* **دوري** — يعرض فقط المستندات ذات الصلة بدورك المعين (مثل المستندات المعين لك التحقق منها أو التي رفعتها).
* **الكل** — يعرض جميع المستندات بغض النظر عن تعيين الدور.

### خيارات الفرز

| الفرز     | الوصف                                            |
| --------- | ------------------------------------------------ |
| أبجدي     | يفرز المستندات من أ إلى ي حسب اسم تعريف المستند. |
| الأحدث    | المستندات المرفوعة مؤخرًا أولاً.                 |
| الأقدم    | المستندات المرفوعة الأقدم أولاً.                 |
| آخر تعديل | المستندات المعدّلة أو المحدّثة مؤخرًا أولاً.     |

***

## شريط الإشارات المرجعية الجانبي

**شريط الإشارات المرجعية** الجانبي هو لوحة بعرض 312 بكسل تنزلق من الجانب الأيمن من الشاشة (مستقلة عن لوحة المعلومات). يتيح لك حفظ المستندات المستخدمة بشكل متكرر والوصول إليها بسرعة.

* **وضع إشارة مرجعية على مستند** — انقر على أيقونة الإشارة المرجعية على أي صف مستند لإضافته إلى إشاراتك المرجعية.
* **فتح الإشارات المرجعية** — انقر على أيقونة الإشارة المرجعية في شريط أدوات Data Room لفتح الشريط الجانبي.
* **إزالة إشارة مرجعية** — انقر على أيقونة الإشارة المرجعية مرة أخرى على مستند مُشار إليه، أو أزله من داخل الشريط الجانبي.

الإشارات المرجعية شخصية ولا تُشارك مع أصحاب المصلحة الآخرين.

***

## خزنتي

يقوم مفتاح **خزنتي** بتصفية Data Room لعرض المستندات التي رفعتها أو تملكها أو لديك حقوق وصول محددة إليها فقط. هذا مفيد للعثور بسرعة على مساهماتك الخاصة دون التمرير عبر قائمة المستندات الكاملة.

***

## رفع المستندات

### المتطلبات

* **الحجم الأقصى للملف:** 150MB لكل ملف.
* **الملفات لكل عملية رفع:** بين 1 و6 ملفات لكل تعريف مستند (اعتمادًا على تكوين التعريف).
* **طريقة الرفع:** اسحب الملفات وأفلتها على منطقة الرفع، أو انقر لتصفح نظام الملفات الخاص بك.

### حقول نموذج الرفع

| الحقل                 | الوصف                                                                                                                            |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| الملف (الملفات)       | اختر من 1 إلى 6 ملفات. السحب والإفلات مدعوم.                                                                                     |
| المدققون              | عيّن حتى 3 مدققين. المدققون الذين يحملون شارة **موصى به** هم من تتطابق أدوارهم بشكل أفضل مع نوع المستند.                         |
| تاريخ انتهاء الصلاحية | عيّن تاريخ انتهاء صلاحية اختياريًا. بعض أنواع المستندات لها فترات صلاحية ثابتة (انظر أدناه) وقد يُملأ هذا الحقل مسبقًا تلقائيًا. |

### شارة موصى به

بجوار كل خانة اختيار مدقق، تظهر شارة **موصى به** بجوار أصحاب المصلحة الذين يكون دورهم المهني هو الأنسب للتحقق من نوع المستند هذا. يساعد هذا الرافعين على اختيار أكثر المدققين مصداقية، مما يؤثر إيجابًا على درجة Magma Index.

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

تحدد المنصة فترات صلاحية ثابتة لبعض أنواع المستندات:

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

***

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

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

### أنواع الاستبدال

| النوع             | الوصف                                                                              |
| ----------------- | ---------------------------------------------------------------------------------- |
| **TOTAL\_UPDATE** | استبدال كامل للمستند. يُستخدم عندما يتغير المحتوى جوهريًا (مثل وثيقة تأمين جديدة). |
| **CORRECTION**    | تصحيح طفيف لمستند موجود (مثل إصلاح خطأ مطبعي، تحديث توقيع).                        |

### سير عمل الاستبدال

1. افتح لوحة معلومات المستند.
2. انقر على زر **استبدال**.
3. اختر نوع الاستبدال: **تحديث كامل** أو **تصحيح**.
4. أدخل **سببًا** للاستبدال (5 أحرف كحد أدنى — مطلوب).
5. ارفع الملف الجديد.
6. أرسل.

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

***

## مشاركة المستندات

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

### أنواع المشاركة

| النوع                    | الوصف                                                                                    |
| ------------------------ | ---------------------------------------------------------------------------------------- |
| **صاحب مصلحة في المبنى** | المشاركة مع صاحب مصلحة موجود في المبنى. اختر من قائمة أصحاب المصلحة الحاليين.            |
| **ضيف غير مسجل**         | المشاركة مع شخص ليس لديه حساب Magma. أدخل عنوان بريده الإلكتروني؛ سيتلقى رابط وصول.      |
| **ضيف مستخدم Magma**     | المشاركة مع مستخدم Magma ليس صاحب مصلحة في هذا المبنى. ابحث بالاسم أو البريد الإلكتروني. |

الوصول المشترك خاص بكل مستند. يظهر المستخدمون المشاركون في قائمة المستخدمين المصرح لهم في لوحة المعلومات، ويمكن إلغاء وصولهم في أي وقت.

***

## التعليقات التوضيحية

تتيح التعليقات التوضيحية لأصحاب المصلحة ترك تعليقات أو طلبات أو حجب مباشرة على صفحات المستندات داخل عارض Data Room.

### إنشاء تعليق توضيحي

1. افتح مستندًا في العارض.
2. انقر واسحب على منطقة الصفحة لتحديد منطقة التعليق التوضيحي.
3. تظهر نافذة منبثقة للتعليق.

### تعليقات توضيحية بالتعليقات

* اكتب نص تعليقك.
* أضف **تفاعلات الرموز التعبيرية** للإقرار أو الرد بسرعة.
* استخدم **@الإشارات** لإخطار أصحاب مصلحة محددين.
* **أرفق ملفات** (صور أو مستندات) بالتعليق.
* **الردود المتسلسلة** — يمكن لأصحاب المصلحة الآخرين الرد مباشرة ضمن نفس سلسلة التعليق التوضيحي.

### تعليقات الحجب التوضيحية

تتيح لك عمليات الحجب رسم مربعات سوداء فوق المحتوى الحساس على صفحات المستندات:

1. اختر أداة **حجب** في شريط أدوات التعليقات التوضيحية.
2. ارسم مربعات سوداء فوق أي محتوى تريد حجبه.
3. انقر على **حفظ**.

يؤدي حفظ الحجب إلى إنشاء **إصدار جديد** من المستند مع تطبيق المحتوى المحجوب بشكل دائم. يُحفظ الإصدار الأصلي (غير المحجوب) في سجل الإصدارات للمستخدمين المصرح لهم بالصلاحيات المناسبة.

### أنواع التعليقات التوضيحية

| النوع | الوصف                                                                            |
| ----- | -------------------------------------------------------------------------------- |
| تعليق | تعليق عام أو سؤال أو ملاحظة مرفقة بمنطقة محددة من المستند.                       |
| حجب   | حجب بمربع أسود مرسوم فوق محتوى حساس. يؤدي الحفظ إلى إنشاء إصدار جديد من المستند. |

***

## تدفق طلب الوصول

إذا حاول صاحب مصلحة أو مستخدم خارجي عرض مستند ليس لديه حق الوصول إليه، يمكنه تقديم **طلب وصول**:

1. ينقر المستخدم على **طلب وصول** على المستند المقيد.
2. اختياريًا يضيف رسالة تشرح سبب حاجته للوصول.
3. يتلقى مالك المستند ومسؤولو المبنى إشعارًا في [موجز النشاط](/magma-documentation/ar/almyzat/activity-feed.md) مع زر إجراء **مراجعة الطلب**.
4. يوافق المراجع على الطلب أو يرفضه.
5. في حالة الموافقة، يُضاف المستخدم الطالب إلى قائمة المستخدمين المصرح لهم ويتلقى إشعار وصول.

***

## التجزئة التشفيرية للمستند

يتلقى كل مستند مرفوع إلى Data Room **تجزئة تشفيرية** (SHA-256 أو ما يعادلها) محسوبة من المحتويات الثنائية للملف. هذه التجزئة:

* تُعرض في لوحة معلومات المستند من أجل الشفافية.
* تُخزّن على البلوكتشين أثناء سك DTT (عبر العقد الذكي HashStorage).
* يمكن التحقق منها بشكل مستقل من قبل أي طرف لتأكيد أصالة المستند واكتشاف العبث.

التجزئة غير قابلة للتغيير — إذا تغير محتوى الملف (حتى ببايت واحد)، تتغير التجزئة، ويجب إنشاء إصدار جديد.

***

## نصائح وأفضل الممارسات

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


---

# 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/data-room.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.