# سَكّ DTT®

**Digital Twin Token (DTT)** هو آلية البلوكتشين في Magma لربط السجل الرقمي للمبنى بدفتر أستاذ عام غير قابل للتغيير. يمثل كل DTT الحالة الموثّقة والمختومة زمنيًا لوثائق المبنى ونموذجه ثلاثي الأبعاد في لحظة السك. وهو الرفيق الرقمي للمبنى المادي، يتطور إلى جانبه مع كل تحديث.

***

## ما هو DTT؟

يُنفّذ DTT كـ **عقد ذكي متعدد الرموز ERC-1155** (وليس NFT/ERC-721). الخصائص الرئيسية:

* **عقد واحد لكل مبنى** — لكل مبنى عقده الذكي المخصص على البلوكتشين.
* **معرّفات رموز متعددة داخل عقد واحد** — يتلقى كل إصدار مستند وكل إصدار كائن BIM معرّف الرمز الخاص به داخل عقد المبنى.
* **سجل التجزئة محفوظ** — يحتفظ كل معرّف رمز بمصفوفة لا تقبل إلا الإلحاق من التجزئات التشفيرية عبر عقد HashStorage. عند تحديث مستند، تُلحق تجزئة جديدة بمصفوفة معرّف الرمز نفسه — يُحفظ السجل الكامل على السلسلة.
* **البلوكتشين:** VeChain (الأساسي)، مع إدارة محفظة المبنى عبر مزود محافظ Venly.

***

## العقود الذكية

ثلاثة عقود ذكية تشغّل نظام DTT:

| العقد                       | الوصف                                                                                                                                         |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **DTT Factory**             | ينشر عقد DTT جديدًا لكل مبنى جديد. مصنع واحد يتعامل مع جميع المباني على المنصة.                                                               |
| **DTT Contract (ERC-1155)** | العقد الخاص بالمبنى. يحتفظ بجميع معرّفات الرموز لمستندات ذلك المبنى وكائنات BIM.                                                              |
| **HashStorage**             | عقد تخزين لا يقبل إلا الإلحاق. لكل معرّف رمز، يخزن مصفوفة من التجزئات. يلحق كل تحديث مستند تجزئة جديدة بالمصفوفة، مع الحفاظ على السجل الكامل. |

***

## أدوار المسؤول

ثلاثة أدوار مسؤول تتحكم في جوانب مختلفة من عقد DTT:

| الدور                  | الوصف                                                         |
| ---------------------- | ------------------------------------------------------------- |
| **tokenAdministrator** | يمكنه سك معرّفات رموز جديدة وإدارة الصلاحيات على مستوى الرمز. |
| **levelAdministrator** | يتحكم في صلاحيات مستوى مبنى محدد (النطاق 0–255).              |
| **hashAdministrator**  | مصرح له بإلحاق تجزئات جديدة بعقد HashStorage.                 |

***

## عملية السك

يبدأ السك من علامة التبويب **DTT** داخل المبنى. يتبع عملية تسلسلية مكوّنة من 13 خطوة:

| الخطوة | الاسم                                     | الوصف                                                                           |
| ------ | ----------------------------------------- | ------------------------------------------------------------------------------- |
| 1      | CREATE\_PROCESS                           | يهيئ جلسة السك ويتحقق من المتطلبات المسبقة.                                     |
| 2      | MINTING\_STARTED                          | يؤكد أن العملية قد بدأت ويقفل حالة بيانات المبنى.                               |
| 3      | VALIDATE\_PAYMENTS                        | يتحقق من أن اشتراك المبنى نشط والمدفوعات محدّثة.                                |
| 4      | REWARD\_TOKEN\_MINTING                    | يحسب ويعدّ رموز مكافآت MRT للتوزيع على أصحاب المصلحة.                           |
| 5      | STAKEHOLDER\_PAYMENTS                     | يوزع رموز مكافآت MRT على محافظ أصحاب المصلحة المؤهلين.                          |
| 6      | SYNC\_LEVEL                               | يزامن درجات مستوى Magma Index لتضمينها في البيانات الوصفية للرمز.               |
| 7      | MINTING\_ENDED                            | يضع علامة على اكتمال جلسة السك من جانب المنصة.                                  |
| 8      | CREATE\_DTT\_BUILDING                     | ينشر عقد DTT للمبنى (السك الأول فقط) أو يشير إلى العقد الموجود.                 |
| 9      | CREATE\_DTT\_DOCUMENT\_DTT\_CREATION      | ينشئ معرّفات رموز لجميع إصدارات المستندات الجديدة منذ آخر سك.                   |
| 10     | CREATE\_DTT\_MODEL\_DTT\_CREATION         | ينشئ معرّفات رموز لإصدارات نموذج BIM.                                           |
| 11     | CREATE\_DTT\_MODEL\_OBJECT\_DTT\_CREATION | ينشئ معرّفات رموز لإصدارات كائنات BIM الفردية.                                  |
| 12     | ADD\_HASHES\_DOCUMENT\_DTT\_CREATION      | يلحق التجزئات التشفيرية لجميع المستندات بمعرّفات رموزها المعنية في HashStorage. |
| 13     | ADD\_HASHES\_MODEL\_OBJECT\_DTT\_CREATION | يلحق التجزئات التشفيرية لجميع حالات كائنات BIM بمعرّفات رموزها المعنية.         |

يعرض **مؤشر تقدم** في علامة تبويب السك الحالة في الوقت الفعلي لكل خطوة.

***

## واجهة علامة التبويب DTT

### بطاقة DTT

العنصر المرئي الرئيسي لعلامة التبويب DTT هو **بطاقة DTT**، التي تعرض:

* **صورة غلاف المبنى** — معروضة بأسلوب بطاقة مدوّرة ثلاثية الأبعاد للتأثير المرئي.
* **نسبة Magma Index** — درجة التوثيق الإجمالية الحالية للمبنى.
* **اسم المبنى** — الاسم الرسمي للمبنى.
* **رمز QR** — رمز QR قابل للمسح يربط بعنوان عقد البلوكتشين للمبنى، مما يتيح لأي شخص التحقق من الرمز على السلسلة.

### التقدم لكل مستوى

أسفل بطاقة DTT، يعرض تفصيل حالة السك لكل مستوى Magma ‏(Genesis، Structure، Architecture، W1–W5، Filled):

* كم عدد المستندات/الكائنات في كل مستوى التي تم سكها.
* كم عددها المعلق (المتحقق منه ولكن لم يُسك بعد).

### أزرار الإجراء

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

***

## السك الأول مقابل التحديثات

### السك الأول (سك)

* ينشر العقد الذكي ERC-1155 الفريد للمبنى عبر DTT Factory.
* يسند للمبنى **عنوان بلوكتشين فريدًا**.
* يسك معرّفات رموز لجميع المستندات وكائنات BIM المتحقق منها.
* يلحق تجزئاتها التشفيرية بعقد HashStorage.
* يطلق توزيع مكافآت MRT على جميع أصحاب المصلحة المؤهلين.

### السك اللاحق (تحديث)

* لا يعيد نشر العقد — يُحدّث العقد الموجود.
* ينشئ معرّفات رموز جديدة فقط للمستندات وكائنات BIM الجديدة أو التي تم تحديثها منذ آخر سك.
* بالنسبة للمستندات المحدّثة، تُلحق تجزئة جديدة بمصفوفة تجزئة معرّف الرمز الموجود (السجل محفوظ).
* يوزع مكافآت MRT للمحتوى المتحقق منه حديثًا.

***

## آلية التجزئة

تضمن آلية التجزئة التشفيرية أن يكون كل إصدار مستند وكائن BIM مرتبطًا بشكل دائم وقابل للتحقق بالبلوكتشين:

1. عند رفع مستند، تُجزّأ محتويات ملفه (SHA-256 أو ما يعادلها).
2. أثناء السك، تُلحق هذه التجزئة بمصفوفة معرّف الرمز في عقد HashStorage.
3. عند تحديث المستند (الاستبدال)، تُحسب تجزئة جديدة وتُلحق بمصفوفة معرّف الرمز نفسه.
4. تنمو مصفوفة التجزئة بمرور الوقت، مما يوفر سجلاً كاملاً على السلسلة لكل إصدار من كل مستند.

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

***

## نافذة النجاح

عند الإكمال الناجح لجميع خطوات السك الـ13، تُعرض نافذة نجاح:

> "تم سك DTT® الخاص بك! إنه الرفيق الرقمي لمبناك الذي سيتطور معه."

تعرض النافذة:

* عنوان البلوكتشين الفريد للمبنى.
* رابطًا إلى صفحة DTT العامة لهذا المبنى.
* رمز QR للتحقق على السلسلة.

***

## صفحة DTT العامة

لكل مبنى مسكوك صفحة DTT يمكن الوصول إليها علنًا في:

```
/dtt/[blockchain-address]
```

هذه الصفحة متاحة لأي شخص — لا يلزم حساب Magma. تعرض:

### رسم بياني عقدي React Flow

رسم بياني تفاعلي مبني بـ **React Flow** يصوّر تسلسل DTT الهرمي الكامل:

* **عقدة المبنى** في الأعلى.
* **عقد المستويات** المتفرعة من المبنى (Genesis، Structure، Architecture، إلخ).
* **عقد المستندات** و**عقد كائنات BIM** تحت كل مستوى.
* ترتبط كل عقدة بحواف تظهر العلاقة.

### عناصر تخزين التجزئة

لكل عقدة (مستند أو كائن)، تُعرض عناصر تخزين التجزئة المرتبطة:

* رقم الإصدار.
* قيمة التجزئة.
* الطابع الزمني للسك.

### روابط مستكشف البلوكتشين

تتضمن كل عقدة وعنصر تجزئة زر **"عرض على البلوكتشين"** الذي يفتح سجل المعاملة أو الرمز في مستكشف بلوكتشين VeChain، مما يتيح التحقق المستقل دون أي اعتماد على البنية التحتية لـ Magma.

***

## حالة المستند بعد السك

تعرض المستندات التي تم سكها بنجاح شارة حالة **Minted** في Data Room. هذه هي الحالة النهائية في دورة حياة المستند:

```
Draft → Pending Validation → Validated → Minted
```

تظل المستندات المسكوكة في Data Room قابلة للوصول والعرض والتنزيل بالكامل. تعمل تجزئتها على السلسلة كدليل غير قابل للتغيير على الأصالة.

***

## المتطلبات المسبقة للسك

قبل بدء السك، تأكد من:

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

***

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

* **اسك بانتظام** — كلما سككت بشكل أكثر تكرارًا، كان السجل على السلسلة أكثر تفصيلاً. فكّر في السك بعد كل رفع مستند مهم أو تحديث بيانات BIM.
* **تحقق قبل السك** — تُضمّن فقط المستندات وكائنات BIM المتحقق منها. يُستبعد المحتوى المعلق أو المرفوض من السك.
* **راقب الخطوات الـ13** — إذا فشلت خطوة، دوّن اسم الخطوة وتحقق من صفحة حالة المنصة أو اتصل بالدعم قبل استخدام زر إعادة المحاولة.
* **شارك صفحة DTT العامة** مع المستثمرين والمقرضين وفرق العناية الواجبة — فهي توفر دليلاً مستقلاً ومتحققًا منه بالبلوكتشين على حالة توثيق المبنى دون الحاجة إلى الوصول إلى المنصة.
* **حافظ على تحديث مدفوعات الاشتراك** — يمكن لدفعة فائتة واحدة أن تحظر السك (في مرحلة OVERDUE\_3\_DAYS) وتؤخر تحديثات سجل البلوكتشين الخاص بك.


---

# 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/dtt-minting.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.