# تسجيل نقاط Magma Index

يقيس Magma Index مدى اكتمال المبنى رقميًا. وهو ليس مجرد عدّاد ملفات — فهو يقيّم **جودة وأصل وملاءمة** كل قطعة بيانات تُسهَم بها في DTT® الخاص بالمبنى.

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

ينقسم Magma Index إلى خمسة مستويات، يغطي كل منها مجالًا مختلفًا من بيانات المبنى:

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

لكل مستوى نسبة اكتماله الخاصة. ويُشتَق **Magma Index العالمي** من جميع المستويات الخمسة مجتمعةً.

***

## كيف يُسجَّل كل مستند

لكل نوع مستند **قيمة جوهرية** — نتيجة أساسية — تُحدَّد بثلاثة عوامل:

1. **مستوى المؤشر** (Genesis، Structure، Architecture، Wired، Filled)
2. **نوع المبنى** (Hotel، Office، Residential، إلخ)
3. **نوع المستند المحدد** (مثل سند الملكية، الرسومات الإنشائية، اعتماد LEED)

ثم تُعدَّل هذه القيمة الجوهرية بخمسة عوامل:

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

من ساهم بالبيانات أمر مهم. فالمحترفون ذوو المسؤولية المباشرة عن ذلك المجال من البيانات يساهمون بأكثر:

* مهندس معماري يرفع رسومات إنشائية يحمل وزنًا أكبر من طرف معني عام يرفع المستند نفسه
* يستخدم النظام **فئة** الطرف المعني (Owner، Asset Manager، Service Provider، إلخ) و**نوعه** المحدد (Architect، Structural Engineer، إلخ) لتحديد هذا التعديل

### العامل 2 — مزيج الرافع/المدقق

يؤثر مزيج من رفع المستند ومن تحقق منه في النتيجة:

* المستند الذي يرفعه أكثر المحترفين صلة (مثل Diagnostician) ويتحقق منه أنسب جهة (مثل Asset Manager وCity Inspector) يحصل على أعلى نتيجة
* المستند الذي يرفعه ويتحقق منه أطراف أقل صلة لا يزال يساهم، لكن بمعامل أقل

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

المستندات التي اكتملت لها جميع مستويات المدققين الثلاثة تحصل على نتيجة أعلى من المستندات التي لها مدقق أساسي فقط:

* 3 مدققين: أقصى نتيجة اكتمال
* 2 مدقق: نتيجة معتدلة
* 1 مدقق: أدنى نتيجة اكتمال
* 0 مدقق: لم يُتحقَّق بعد، ولا يساهم

### العامل 4 — سمعة الطرف المعني

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

* تزداد السمعة بمقدار **+1 لكل 5 عمليات تحقق مسكوكة** (بحد أقصى 5)
* تُؤخَذ سمعة كل من الرافع وكل مدقق في الحسبان في القيمة النهائية
* يمكن أن تقلل الجزاءات السمعة (تُطبَّق عبر عملية مجدولة)

يضمن عامل السمعة الاعتراف بمرور الوقت بالمساهمين ذوي الخبرة والدقة المستمرة.

### العامل 5 — انتهاء صلاحية البيانات

المستندات ذات فترات الصلاحية (التأمين، الضرائب العقارية، تقارير التدقيق، إلخ) تفقد مساهمتها في المؤشر مع اقترابها من الانتهاء:

* يساهم المستند النشط غير منتهي الصلاحية بقيمته الكاملة
* يقلل المستند منتهي الصلاحية نتيجة المؤشر لفئته حتى تُرفَع نسخة مُجدَّدة ويُتحقَّق منها

***

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

يمثل **المؤشر الجزئي** (µI) مساهمة مستند واحد كنسبة مئوية في نتيجة مستواه. ويُعرَض كنسبة مئوية (مثل "2.3%") ويكون مرئيًا في:

* لوحة نتائج **Simulator** (قبل الرفع، لمعاينة التأثير)
* علامة تبويب **Value Contributions** (بعد الرفع، لإظهار المساهمة الفعلية)
* أكورديون **Building Index Details** (في وضع المطور)

يتيح لك µI مقارنة الأهمية النسبية للمستندات المختلفة وإعطاء الأولوية لعمليات الرفع التي سيكون لها أكبر تأثير في Magma Index الخاص بك.

***

## قراءة أداة Magma Index

تُظهر أداة Building Index في علامة تبويب Overview ثلاثة أنواع من التقدم لكل مستوى:

| اللون            | المعنى                                                                             |
| ---------------- | ---------------------------------------------------------------------------------- |
| **أزرق (أساسي)** | بيانات مسكوكة بالفعل على السلسلة — مثبَّتة في سجل البلوكتشين                       |
| **أخضر (نجاح)**  | بيانات تم التحقق منها والموافقة عليها لكن لم تُسَكّ بعد — ستُدرَج في السَكّ التالي |
| **المتبقي**      | بيانات بانتظار التحقق أو لم تُرفَع بعد — لا تساهم بعد                              |

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

يُظهر **العرض التفصيلي** (الأكورديون) كل مهمة مستند فردية وحالتها ومن رفعها، ويتيح النقر للوصول إلى ذلك المستند.

***

## ملخص معادلة التسجيل

```
Document contribution = 
  Intrinsic Value (level × building type × document type)
  × Actor Category Adjustment
  × Uploader/Validator Combination Adjustment  
  × Validator Completeness Adjustment
  × Reputation Factor (uploader + validators)
  × Expiry Adjustment (discount if expired)
```

يُنتج مجموع جميع مساهمات المستندات عبر جميع المستويات نسبة Magma Index الإجمالية للمبنى.

***

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

لتحقيق أعلى Magma Index ممكن:

1. **ارفع جميع أنواع المستندات المتوقعة** لنوع مبناك — يأخذ المؤشر في الحسبان ما هو متوقع، وليس ما لديك فقط
2. **استخدم المحترف المناسب** — تأكد من أن دور الرافع المخصص لكل مستند هو من يرفعه
3. **أسند جميع مستويات المدققين الثلاثة** — لا تتخطَّ المدققين الثانوي والثالثي
4. **حافظ على تحديث المستندات** — جدِّد المستندات منتهية الصلاحية قبل انقضائها
5. **ابنِ السمعة** — الأطراف المعنية ذوو السمعة الأعلى ينتجون مساهمات ذات قيمة أعلى
6. **ارفع نماذج BIM** لجميع المستويات — تساهم بيانات الأجسام ثلاثية الأبعاد بشكل منفصل عن المستندات
7. **استخدم Simulator** — عاين تأثير µI الدقيق قبل رفع أي مستند


---

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