# Magma Index

Magma Index هو نظام التقييم الخاص بـ Magma لاكتمال التوثيق وجودته. فهو يقيس مدى جودة توثيق المبنى عبر جميع المستويات والأبعاد — من سجلات الملكية القانونية إلى بيانات IoT في الوقت الفعلي — ويوفر مقياسًا شفافًا وموضوعيًا للنضج الرقمي للمبنى.

***

## نظرة عامة

ينتج Magma Index درجة (معبّرًا عنها كنسبة مئوية) لكل مبنى. تعكس هذه الدرجة ليس فقط عدد المستندات المرفوعة، بل جودة وأهمية ومصداقية تلك المستندات والفاعلين الذين أنتجوها.

يُحسب المؤشر على مستوى المبنى (الإجمالي) وعلى المستوى الفردي (لكل مستوى Magma). كما يُفكّك إلى مستوى المستند عبر **المؤشر الجزئي (µI)** — النسبة المئوية لمساهمة مستند واحد في درجة مستواه.

***

## مستويات Magma الخمسة

ينظّم Magma Index جميع وثائق المبنى في 5 مستويات، يمثل كل منها بُعدًا متميزًا من المبنى:

| المستوى          | الرمز | الوصف                                                                                                                |
| ---------------- | ----- | -------------------------------------------------------------------------------------------------------------------- |
| **Genesis**      | G     | المستندات الأساسية: سجلات الملكية، الوثائق القانونية، الأدوات المالية، وتشخيصات المبنى.                              |
| **Structure**    | S     | وثائق الهندسة الإنشائية: الحسابات الإنشائية، المسوحات، التقارير الجيوتقنية.                                          |
| **Architecture** | A     | الوثائق المعمارية: المخططات، التصاريح، الشهادات (LEED، BREEAM، HQE، WELL).                                           |
| **Wired**        | W1–W5 | الأنظمة التقنية: HVAC ‏(W1)، السباكة (W2)، الكهرباء/الإضاءة (W3)، الأجهزة والمعدات (W4)، أنظمة الحياة والسلامة (W5). |
| **Filled**       | F     | التصميم الداخلي والمفروشات: مخططات التجهيز، مواصفات الأثاث، الصور الداخلية.                                          |

لكل مستوى مجموعة محددة من **مهام المستندات** — أنواع مستندات محددة يُتوقع وجودها لسجل مبنى كامل.

***

## عوامل التقييم

Magma Index ليس مجرد عدّ للمستندات. تُرجّح مساهمة كل مستند في المؤشر بواسطة 7 عوامل تقييم:

### العامل 1 — الكمية مقابل المتوقع

نسبة المستندات المرفوعة فعليًا مقابل عدد أنواع المستندات المتوقعة لهذا المبنى (استنادًا إلى نوع المبنى). يحصل المبنى الذي تكون فيه جميع أنواع المستندات المتوقعة مملوءة على درجة أعلى من المبنى الذي يحتوي على القليل منها فقط.

### العامل 2 — فئة الفاعل

فئة صاحب المصلحة الذي رفع المستند:

| الفئة     | الوصف                                                                  |
| --------- | ---------------------------------------------------------------------- |
| **محترف** | المحترفون المرخصون (المهندس المعماري، المهندس، الموثّق، المحامي، إلخ). |
| **هاوٍ**  | الأفراد غير المرخصين (المالك الذي يتصرف شخصيًا، إلخ).                  |

يساهم الفاعلون المحترفون في المؤشر أكثر من الفاعلين الهواة، حيث تحمل مستنداتهم مصداقية أعلى.

### العامل 3 — أهمية تركيبة الرافع / المدقق

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

### العامل 4 — اكتمال المدققين

ما إذا كان قد تم تعيين 1 أو 2 أو 3 مدققين للمستند:

| المدققون | المستوى             |
| -------- | ------------------- |
| 0 مدقق   | لا توجد مكافأة تحقق |
| 1 مدقق   | المستوى 1           |
| 2 مدقق   | المستوى 2           |
| 3 مدققين | المستوى 3 (الأقصى)  |

يزيد المزيد من المدققين مصداقية المستند وبالتالي مساهمته في المؤشر.

### العامل 5 — سمعة صاحب المصلحة

درجة السمعة (عدد صحيح 1–5، الافتراضي 3) للرافع والمدققين. السمعة الأعلى تعني ثقة أكبر في مساهمتهم.

* السمعة الافتراضية لجميع أصحاب المصلحة: **3**
* تزيد السمعة بمقدار **+1** لكل **5 تحققات مسكوكة** (بحد أقصى **5**).
* يمكن تخفيض السمعة بعقوبات تطبّقها مهمة cron مجدولة (مثل التحققات المرفوضة، الخمول، إلخ).

### العامل 6 — عقوبة انتهاء صلاحية البيانات

المستندات التي مرّ تاريخ انتهاء صلاحيتها تطبّق **عقوبة سلبية** على مساهمتها. تقلل المستندات منتهية الصلاحية درجة Magma Index لمستواها. يحفّز هذا على إبقاء المستندات الحساسة للوقت محدّثة.

### العامل 7 — ترجيح نوع المبنى

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

**أنواع المباني التسعة وملفات الترجيح الخاصة بها:**

* فندق
* عام
* صناعي
* تخزين
* استخدام مختلط
* تجاري
* سكني
* مكتبي
* طبي

***

## المؤشر الجزئي (µI)

يمثل **المؤشر الجزئي** (المختصر **µI**) النسبة المئوية لمساهمة مستند واحد في درجة Magma Index الإجمالية لمستواه.

* يُعبّر عن µI كنسبة مئوية (مثلاً، قد يساهم مستند بنسبة 3.4% في درجة مستوى Architecture).
* يكون µI مرئيًا في لوحة معلومات المستند في Data Room.
* يكون µI مرئيًا أيضًا في قسم [مساهمات القيمة](/magma-documentation/ar/almyzat/value-contributions.md)، حيث تُدرج مساهمة كل مستند.
* يُستخدم µI في [المحاكي](/magma-documentation/ar/almyzat/simulator.md) لمعاينة تأثير مستند جديد قبل رفعه.

يساعد فهم µI أصحاب المصلحة على تحديد أولويات المستندات التي يجب رفعها أو تحديثها لزيادة درجة المؤشر الإجمالية للمبنى إلى أقصى حد.

***

## أداة مؤشر المبنى

توفر أداة مؤشر المبنى نظرة عامة مرئية على Magma Index للمبنى. يمكن الوصول إليها من الصفحة الرئيسية لملف المبنى.

### العرض البسيط

**حلقة تقدم دائرية** لكل من المستويات الخمسة، تعرض:

* **تعبئة باللون الأساسي** — النسبة المئوية للمستندات المتحقق منها.
* **تعبئة بلون النجاح** — النسبة المئوية للمستندات المعلقة للتحقق (المستندات المرفوعة ولكن لم يتم التحقق منها بعد).

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

### العرض المفصّل

بدّل إلى العرض المفصّل لرؤية تفصيل كامل:

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

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

***

## شهادات مستوى Architecture

يتتبع مستوى Architecture في Magma Index على وجه التحديد شهادات الاستدامة وأداء المبنى. تشمل أنواع الشهادات المدعومة:

* **LEED** ‏(Leadership in Energy and Environmental Design)
* **BREEAM** ‏(Building Research Establishment Environmental Assessment Method)
* **HQE** ‏(Haute Qualité Environnementale)
* **WELL** ‏(WELL Building Standard)

تُعترف بمستندات الشهادات المرفوعة تحت مستوى Architecture بنوع المستند المناسب وتُرجّح وفقًا لذلك في حساب المؤشر.

***

## كيف يؤثر Magma Index على الميزات الأخرى

تُستخدم درجة Magma Index عبر المنصة بعدة طرق:

| الميزة             | كيف يُستخدم المؤشر                                                         |
| ------------------ | -------------------------------------------------------------------------- |
| **سك DTT**         | تُعرض درجة المؤشر على بطاقة DTT وتُضمّن في البيانات الوصفية للرمز المسكوك. |
| **المكافآت**       | تُحدد مبالغ مكافآت المستندات جزئيًا بمساهمة المستند في المؤشر.             |
| **لوحة المعلومات** | يُعرض المؤشر على كل بطاقة مبنى كمؤشر أداء رئيسي.                           |
| **المحاكي**        | يعاين مساهمة المؤشر (µI) لعملية رفع مستند افتراضية قبل حدوثها.             |
| **مساهمات القيمة** | يدرج مساهمة كل مستند وكائن BIM الفردية في المؤشر.                          |

***

## نصائح لتعظيم Magma Index الخاص بك

* ابدأ بمستندات **مستوى Genesis** — سند الملكية والصك والسجل العقاري هي مستندات دائمة تساهم من اليوم الأول ولا تنتهي صلاحيتها أبدًا.
* أعطِ الأولوية لـ **الرافعين المحترفين** — تحصل المستندات التي يرفعها محترفون مرخصون (المهندسون المعماريون، المهندسون، المحامون) على مكافأة فئة فاعل أعلى.
* عيّن دائمًا **3 مدققين** عند رفع المستندات الحرجة — تعزز مكافأة اكتمال مدققي المستوى 3 مساهمة المستند بشكل كبير.
* ابنِ **سمعة صاحب المصلحة** بمرور الوقت — التحققات المتسقة عالية الجودة تزيد درجات السمعة، مما يضخّم مساهمة كل مستند لاحق في المؤشر.
* حدّث بانتظام **المستندات الحساسة للوقت** (التأمين، الضرائب العقارية، تقارير التدقيق) قبل انتهاء صلاحيتها لتجنب جر عقوبة انتهاء صلاحية البيانات لدرجتك للأسفل.
* استخدم **المحاكي** قبل رفع المستندات الباهظة أو المعقدة لمعاينة مقدار مساهمتها في المؤشر بالضبط.


---

# 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/magma-index.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.