# عارض BIM ثلاثي الأبعاد

يوفر BIM 3D Viewer تصورًا تفاعليًا ثلاثي الأبعاد لنموذج IFC (Industry Foundation Classes) الخاص بمبناك. مدعوم بـ **Speckle**، فهو يمكّن أصحاب المصلحة من استكشاف هندسة المبنى، وفحص الكائنات الفردية، وإدارة حقول البيانات المنظمة، والتعاون في إثراء البيانات — كل ذلك ضمن منصة Magma.

***

## الوصول إلى BIM 3D Viewer

يمكن الوصول إلى BIM 3D Viewer بطريقتين:

1. من **Data Room** — انتقل إلى مجلد IFC فرعي وانقر على **فتح في BIM**.
2. من **شريط التنقل الرئيسي للمبنى** — انقر على علامة التبويب **النموذج ثلاثي الأبعاد** أو **BIM** في قائمة المبنى.

***

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

| الخاصية            | القيمة                                                  |
| ------------------ | ------------------------------------------------------- |
| تنسيق الملف        | IFC (Industry Foundation Classes)                       |
| الحجم الأقصى للملف | حتى 10GB لكل ملف IFC                                    |
| طريقة الرفع        | رفع مقسّم (تُقسّم الملفات الكبيرة إلى أجزاء لنقل موثوق) |

***

## مستويات مبنى Magma

ينظّم BIM 3D Viewer بيانات المبنى عبر 7 مستويات هرمية، يتوافق كل منها مع تخصص أو طبقة من المبنى:

| الرمز | المستوى                   | الوصف                                                            |
| ----- | ------------------------- | ---------------------------------------------------------------- |
| S     | Structure                 | عناصر الهندسة الإنشائية (الأعمدة، العوارض، البلاطات، الأساسات).  |
| A     | Architecture              | العناصر المعمارية (الجدران، الأبواب، النوافذ، الأسقف، الأرضيات). |
| W1    | Wired 1 — ميكانيكي        | أنظمة HVAC، التهوية، تكييف الهواء.                               |
| W2    | Wired 2 — سباكة           | أنظمة السباكة، إمدادات المياه، الصرف.                            |
| W3    | Wired 3 — إضاءة           | الأنظمة الكهربائية، تجهيزات الإضاءة، توزيع الطاقة.               |
| W4    | Wired 4 — أجهزة ومعدات    | الأجهزة المثبتة، المعدات، الأدوات.                               |
| W5    | Wired 5 — الحياة والسلامة | السلامة من الحرائق، أنظمة الأمان، أنظمة الطوارئ.                 |
| F     | Filled                    | التصميم الداخلي، المفروشات، عناصر التجهيز غير الإنشائية.         |

> **مهم:** **Genesis** ليس مستوى BIM. توجد مستندات Genesis (الملكية، القانونية، المالية) فقط في Data Room ولا تُمثّل في النموذج ثلاثي الأبعاد.

***

## بنية بيانات الكائن

يمكن لكل كائن في نموذج BIM تخزين بيانات منظمة مرتبة في 12 قسمًا:

| القسم                          | الوصف                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------ |
| **INDEX\_LEVEL**               | مستوى Magma الذي ينتمي إليه هذا الكائن (S، A، W1–W5، F).                       |
| **OBJECT\_IDENTIFICATION**     | الاسم، IFC GUID، نوع الكائن، والمعرّفات الفريدة.                               |
| **OBJECT\_CREATION**           | الشركة المصنّعة، العلامة التجارية، مرجع الطراز، الرقم التسلسلي، تاريخ التركيب. |
| **SPATIAL\_DATA**              | مستوى الطابق، الغرفة، المنطقة، الإحداثيات، الأبعاد.                            |
| **CONDITION\_ASSESSMENT**      | تقييم الحالة الحالية، ملاحظات الفحص، سجل الصيانة.                              |
| **COMPLIANCE**                 | الشهادات، الامتثال للمعايير، الموافقات التنظيمية.                              |
| **LIFECYCLE\_DATA**            | معلومات الضمان، العمر الافتراضي المتوقع، جدول الاستبدال.                       |
| **SMART\_DATA**                | معرّفات مستشعرات IoT، الأجهزة المتصلة، روابط بيانات المبنى الذكي.              |
| **CONTRACT\_AND\_MAINTENANCE** | عقود الصيانة، مزودو الخدمة، تفاصيل اتفاقية مستوى الخدمة.                       |
| **FINANCIAL\_DATA**            | تكلفة الشراء، القيمة الحالية، الإهلاك، قيمة التأمين.                           |
| **OBJECT\_LIVE\_DATA**         | موجزات البيانات في الوقت الفعلي (قراءات المستشعرات، الحالة التشغيلية).         |
| **ADVANCED\_DATA**             | حقول مخصصة أو متخصصة لا تغطيها الأقسام الأخرى.                                 |

### أنواع الحقول

تُصنّف الحقول داخل كل قسم حسب النوع:

| النوع       | الوصف                              |
| ----------- | ---------------------------------- |
| **TEXT**    | سلسلة نصية حرة الشكل.              |
| **NUMBER**  | قيمة رقمية عشرية.                  |
| **INTEGER** | عدد صحيح.                          |
| **BOOLEAN** | مفتاح صحيح/خطأ.                    |
| **FILE**    | مرفق ملف (مستند، صورة، PDF).       |
| **SELECT**  | قائمة منسدلة بخيارات محددة مسبقًا. |

***

## لوحة تفاصيل الكائن

يؤدي النقر على كائن في العارض ثلاثي الأبعاد إلى فتح **لوحة تفاصيل الكائن** على الجانب الأيمن من الشاشة. تُنظّم هذه اللوحة في علامات تبويب:

### علامة التبويب OVERVIEW

ملخص للمعلومات التعريفية الرئيسية للكائن:

* اسم الكائن ونوعه
* IFC GUID
* تعيين مستوى Magma
* درجة اكتمال البيانات الحالية

### علامة التبويب BIM\_DATA

واجهة إدخال البيانات وعرضها الرئيسية، منظمة في علامات تبويب فرعية:

| علامة التبويب الفرعية | المحتويات                                                                                |
| --------------------- | ---------------------------------------------------------------------------------------- |
| **Basic**             | الحقول الأساسية من OBJECT\_IDENTIFICATION و SPATIAL\_DATA والأقسام الأساسية الأخرى.      |
| **Smart Queries**     | استعلامات متقدمة تسحب بيانات محسوبة أو مشتقة من أقسام متعددة.                            |
| **Live Basic**        | حقول OBJECT\_LIVE\_DATA التي تعرض بيانات المستشعرات والبيانات التشغيلية في الوقت الفعلي. |
| **Advanced**          | حقول قسم ADVANCED\_DATA للبيانات المتخصصة أو المخصصة.                                    |

### علامة التبويب BIM\_ORIGINAL\_DATA

تعرض الخصائص الخام غير المعالجة المستخرجة مباشرة من ملف IFC الأصلي كما رُفع. هذه هي بيانات المصدر قبل أي إثراء من Magma. مفيدة للمقارنة بين ما كان في النموذج الأصلي مقابل ما تمت إضافته عبر المنصة.

### علامة التبويب CF\_DATA

بيانات العقد والبيانات المالية، منظمة في علامتي تبويب فرعيتين:

| علامة التبويب الفرعية | المحتويات                                                         |
| --------------------- | ----------------------------------------------------------------- |
| **Contract**          | حقول قسم CONTRACT\_AND\_MAINTENANCE (عقود الخدمة، جداول الصيانة). |
| **Financial**         | حقول قسم FINANCIAL\_DATA (التكاليف، القيم، الإهلاك).              |

***

## اللوحة الجانبية

يتضمن العارض شريطًا جانبيًا قابلاً للطي على الجانب الأيسر من الشاشة:

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

***

## أدوات العارض

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

### العروض (Alt + رقم)

التبديل بين عروض الكاميرا المعدّة مسبقًا:

| الاختصار | العرض     |
| -------- | --------- |
| Alt+1    | عرض علوي  |
| Alt+2    | عرض أمامي |
| Alt+3    | عرض أيسر  |
| Alt+4    | عرض خلفي  |
| Alt+5    | عرض أيمن  |

### أوضاع العرض (Shift + رقم)

تغيير وضع العرض المرئي للنموذج:

| الاختصار | الوضع   | الوصف                              |
| -------- | ------- | ---------------------------------- |
| Shift+1  | Default | عرض مظلل قياسي.                    |
| Shift+2  | Edges   | عرض حواف بنمط شبكي.                |
| Shift+3  | Shaded  | تظليل سلس دون حواف.                |
| Shift+4  | Pen     | عرض مصمّم بنمط القلم/الحبر.        |
| Shift+5  | Arctic  | عرض أبيض/فاتح بسيط للتوثيق النظيف. |
| Shift+6  | Colors  | ترميز لوني قائم على نوع الكائن.    |

### أدوات إضافية (Shift + حرف)

| الاختصار    | الأداة       | الوصف                                                |
| ----------- | ------------ | ---------------------------------------------------- |
| Shift+R     | القياسات     | تفعيل أداة القياس.                                   |
| Shift+F     | الطوابق      | فتح محدد مستوى الطابق.                               |
| Shift+P     | الإسقاط      | التبديل بين الإسقاط المنظوري والمتعامد.              |
| Shift+B     | صندوق المقطع | تفعيل صندوق قطع لقطع النموذج وكشف المساحات الداخلية. |
| Shift+Space | تكبير ملائم  | التكبير والتحريك لملاءمة النموذج بالكامل في العرض.   |
| Shift+M     | النماذج      | فتح أداة إدارة النماذج.                              |
| Shift+S     | بحث / تصفية  | فتح لوحة البحث والتصفية.                             |
| Shift+E     | المستكشف     | فتح مستكشف الكائنات (شجرة التسلسل الهرمي).           |
| Shift+N     | الإشعارات    | فتح لوحة الإشعارات.                                  |
| Shift+T     | المهام       | فتح لوحة المهام (تعرض شارة عدد المهام).              |

***

## أداة القياس

تُفعّل عبر **Shift+R**. تتيح أداة القياس قياس المسافة بدقة بين النقاط في النموذج ثلاثي الأبعاد.

### أنواع القياس

| النوع                | الوصف                                                        |
| -------------------- | ------------------------------------------------------------ |
| **من نقطة إلى نقطة** | انقر على نقطتين في النموذج لقياس مسافة الخط المستقيم بينهما. |
| **متعامد**           | قياس المسافة المتعامدة من نقطة إلى سطح أو حافة.              |

### الالتقاط

تلتقط الأداة **رؤوس الكائنات** للقياس الدقيق، مما يضمن التقاط المسافات الدقيقة من حافة إلى حافة أو من ركن إلى ركن.

### الوحدات

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

`mm` | `cm` | `m` | `km` | `in` | `ft` | `yd` | `mi`

***

## أداة النماذج (Shift+M)

تدير أداة النماذج ملفات IFC المحمّلة في العارض.

### رفع ملف IFC جديد

1. افتح أداة النماذج (Shift+M).
2. انقر على **رفع نموذج**.
3. اختر ملف IFC الخاص بك (حتى 10GB). تُرفع الملفات الكبيرة على أجزاء تلقائيًا.
4. يظهر النموذج في القائمة بحالة **PENDING** وشريط تقدم.

### حالات معالجة النموذج

| الحالة        | الوصف                                        |
| ------------- | -------------------------------------------- |
| **PENDING**   | تم رفع الملف وهو في قائمة الانتظار للمعالجة. |
| **FAILED**    | فشلت المعالجة. يُعرض زر **حاول مرة أخرى**.   |
| **AVAILABLE** | اكتملت المعالجة. النموذج محمّل في العارض.    |

### حذف نموذج

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

***

## أداة أصحاب المصلحة

توفر أداة أصحاب المصلحة، التي يمكن الوصول إليها من داخل BIM 3D Viewer، وظائف إدارة أصحاب المصلحة الكاملة دون مغادرة سياق العارض. يمكنك:

* عرض قائمة أصحاب المصلحة الحاليين مع أدوارهم.
* دعوة أصحاب مصلحة جدد.
* تعديل أدوار أصحاب المصلحة الحاليين.
* إزالة أصحاب المصلحة.

يعكس هذا لوحة إدارة أصحاب المصلحة الكاملة المتاحة في إعدادات المبنى.

***

## أداة التصفية (Shift+S)

تصفية الكائنات المرئية في المشهد ثلاثي الأبعاد بناءً على قيم حقول BIM الخاصة بها.

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

1. افتح أداة التصفية (Shift+S).
2. اختر **حقلاً** من القائمة المنسدلة (من أي من أقسام البيانات الـ12).
3. اختر **عاملاً** (يساوي، يحتوي، أكبر من، أصغر من، إلخ).
4. أدخل **قيمة** للتصفية بها.
5. انقر على **تطبيق**.

تُميّز الكائنات المطابقة لعامل التصفية أو تُعزل في منطقة العرض. يمكن دمج عوامل تصفية متعددة بمنطق AND/OR.

***

## معالج التهيئة

للمباني الجديدة أو ملفات IFC المرفوعة حديثًا، يرشدك **معالج التهيئة** خلال إدخال البيانات الأولي لجميع الأقسام الـ12 عبر جميع الكائنات.

### كيف يعمل

1. يقدم المعالج **نموذجًا لكل قسم** لكل كائن (أو مجموعات من الكائنات).
2. لكل قسم، تملأ الحقول ذات الصلة.
3. يتوفر **مساعد بيانات BIM الأصلية** كلوحة مساعدة — فهو يعرض خصائص IFC الخام المستخرجة من الملف المرفوع، والتي تكون **قابلة للبحث** ويمكن استخدامها كمرجع أو ربطها مباشرة لملء حقول النموذج.
4. يعرض **مؤشر تقدم WebSocket** حالة المعالجة في الوقت الفعلي أثناء حفظ البيانات ومزامنتها.

يمكن إيقاف المعالج مؤقتًا واستئنافه. تُحفظ الكائنات المكتملة جزئيًا تلقائيًا.

***

## سير عمل طلب تغيير الحقل

عندما يريد صاحب مصلحة تعديل قيمة حقل على كائن BIM، يقدم **طلب تغيير حقل** بدلاً من تعديل القيمة مباشرة. يضمن هذا سلامة البيانات عبر عملية موافقة المدقق.

### تقديم طلب تغيير

1. في لوحة تفاصيل الكائن، انقر على **تعديل** على الحقل الذي تريد تغييره.
2. أدخل القيمة الجديدة المقترحة.
3. أضف ملاحظة اختيارية تشرح سبب التغيير.
4. أرسل الطلب.

### تصويت المدققين

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

### نافذة التغييرات المعلقة المنبثقة

يرى المدققون نافذة **التغييرات المعلقة** المنبثقة عند فتحهم الكائن المتأثر. تعرض هذه النافذة:

* **القيمة الحالية** — قيمة الحقل الموجودة.
* **القيمة المقترحة** — القيمة الجديدة المطلوبة.
* **حالة التصويت** — من صوّت، ومن لا يزال معلقًا.
* زرّا **موافقة** و**رفض** (مع حقل سبب إلزامي للرفض).

### دمج المهام

تولّد طلبات تغيير الحقول مهام **VALIDATE\_3D\_MODEL\_FIELD** تلقائيًا، تكون مرئية في لوحة [المهام](/magma-documentation/ar/almyzat/tasks.md) (Shift+T).

***

## الربط العميق بالكائنات

يمكن ربط أي كائن في عارض BIM مباشرة. سيؤدي إلحاق معلمة عنوان URL ‏`?objectId=` بعنوان URL للعارض إلى فتح العارض مع تحديد ذلك الكائن المحدد مسبقًا والتركيز عليه.

**مثال:**

```
https://app.mymagma.com/buildings/[building-id]/bim?objectId=abc123
```

يمكن مشاركة هذا الرابط مع أصحاب المصلحة — يؤدي النقر عليه إلى فتح العارض وتحديد الكائن المحدد فورًا. تُستخدم الروابط العميقة أيضًا بواسطة ميزة [مساهمات القيمة](/magma-documentation/ar/almyzat/value-contributions.md)، حيث يؤدي النقر على صف كائن نموذج ثلاثي الأبعاد في جدول المساهمات إلى فتح العارض عند ذلك الكائن بالضبط.

***

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

* استخدم **Shift+B (صندوق المقطع)** لتقطيع الجدران والأرضيات عند فحص أنظمة MEP (الميكانيكية والكهربائية والسباكة) المخفية داخل البنية.
* استخدم **Shift+F (الطوابق)** لعزل مستوى طابق واحد وتقليل الفوضى المرئية عند العمل على العناصر الداخلية.
* **أداة التصفية** قوية لمراقبة الجودة — صفِّ الكائنات حسب حقول `CONDITION_ASSESSMENT` لتحديد العناصر في حالة سيئة بسرعة.
* أكمل دائمًا **معالج التهيئة** للنماذج المرفوعة حديثًا قبل دعوة أصحاب المصلحة لمراجعة البيانات — البيانات الجزئية تقلل درجة Magma Index.
* استخدم **الروابط العميقة** (`?objectId=`) عند التنسيق مع أصحاب المصلحة في رسائل البريد الإلكتروني أو أوصاف المهام لتوجيههم إلى الكائن المحدد المعني.
* ارفع ملفات IFC متعددة خاصة بكل تخصص (واحد لكل مستوى: S، A، W1–W5، F) بدلاً من نموذج مدمج واحد لأداء أفضل وتنظيم بيانات أفضل.


---

# 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/bim-3d-viewer.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.