# كيف تعمل ## دورة حياة المبنى على Magma ### 1. ينشئ المالك Digital Twin Token يشترك مالك المبنى (أو مدير أصوله) وينشئ DTT® لمبناه. ويشمل ذلك: * إدخال معلومات المبنى الأساسية: الاسم، النوع، العنوان، مساحة السطح، سنة البناء، تفاصيل المالك ورقم ضريبة القيمة المضافة (VAT) * تحديد متطلبات النموذج ثلاثي الأبعاد لكل مستوى من مستويات المبنى اختياريًا * مراجعة عرض السعر وربط **محفظة المبنى** (Venly/VeChain) * إتمام الدفع عبر Stripe لتفعيل الاشتراك يبدأ المبنى في حالة **Draft** ويتقدم إلى **Not Minted** بمجرد تأكيد الدفع. ### 2. يتم دعوة أصحاب المصلحة يدعو المالك كل محترف معني بدورة حياة المبنى. تنشئ كل دعوة **Stakeholder Agreement** يحدد دور الشخص وأذوناته على هذا المبنى. تتراوح أنواع أصحاب المصلحة من المهندسين المعماريين والمهندسين الإنشائيين إلى المستأجرين والمراقبين والمؤسسات المالية — أكثر من 50 نوعًا محددًا عبر 8 فئات. تصل الدعوات عبر البريد الإلكتروني مع رابط للقبول أو الرفض. وبمجرد القبول، يحصل صاحب المصلحة على حق الوصول إلى المبنى بناءً على دوره. ### 3. يتم المساهمة بالبيانات اعتمادًا على دورهم، يساهم أصحاب المصلحة بالبيانات عبر ثلاث واجهات: **Data Room** — ارفع المستندات إلى المستوى والفئة المناسبين. تعرض المنصة أنواع المستندات المتوقعة لدورك وتبرز تلك المفقودة. لكل نوع مستند أدوار رافعين معيَّنة وأدوار مدققين معيَّنة، محددة لكل نوع مستند. **عارض BIM ثلاثي الأبعاد** — يرفع المهندسون والمعماريون نماذج IFC لمستوى مبناهم. ويمكن بعد ذلك إثراء كل كائن في النموذج ببيانات منظمة: التعريف، والمواد، والأبعاد، والحالة، وتصنيفات الامتثال، وتواريخ دورة الحياة، والبيانات المالية، واتصالات IoT، والمزيد. **عارض المسح الضوئي** — يرفع المساحون وأخصائيو التشخيص عمليات مسح سحابة النقاط بصيغة E57. تقوم منظومة الذكاء الاصطناعي بتجزئة المسح تلقائيًا، وتصنيف كل عنصر، ومطابقة العناصر مع كائنات BIM الموجودة حيثما أمكن. ### 4. يوافق المدققون على البيانات تمر كل قطعة بيانات عبر **سير عمل التحقق**. بالنسبة للمستندات، لكل نوع مستند مدقق أساسي، ومدقق ثانوي اختياري، ومدقق ثالثي اختياري. يجب أن يوافق جميع المدققين المُهيَّئين — رفض واحد يعيد المستند إلى الرافع مع سبب. بالنسبة لحقول بيانات BIM، يؤدي أي تغيير إلى إطلاق طلب تغيير. يراجع المدققون المعيَّنون القيمة المقترحة ويصوّتون بالموافقة أو الرفض. يجب أن يتفق جميع المدققين. تحصل البيانات المُتحقَّق منها على الحالة **Validated** وتصبح مؤهلة للسَكّ. ### 5. يتم سَكّ DTT® بمجرد تراكم بيانات مُتحقَّق منها كافية، يبدأ المالك أو مدير الأصول عملية السَكّ. تُنفَّذ عملية مكونة من 13 خطوة على blockchain: * تتم مزامنة جميع المستندات وحقول BIM المُتحقَّق منها مع السلسلة * يحصل كل عنصر على معرّف رمز ضمن عقد DTT® بصيغة ERC-1155 الخاص بالمبنى * يُضاف التجزئة التشفيري (hash) لكل إصدار مستند إلى مصفوفة تجزئة رمزه في عقد HashStorage * تُحتسب مكافآت رمز MRT لكل مساهم ومدقق * يتم تمويل المكافآت وتحويلها إلى محافظ أصحاب المصلحة * يتم رفع مستوى DTT® يحصل المبنى على عنوان blockchain فريد. أصبح سجل بياناته الكامل الآن قابلاً للتحقق بشكل دائم وعلني. ### 6. يتطور DTT® تتغير المباني. ينتقل مستأجرون جدد، وتُستبدل المعدات، وتُجدَّد الشهادات. يتبع كل تحديث سير العمل نفسه: رفع ← تحقق ← سَكّ. يُضاف كل تجزئة جديد إلى الرمز الموجود — مع الحفاظ على السجل الكامل، دون الكتابة فوقه أبدًا. تنشئ المستندات ذات فترات الصلاحية (مثل وثائق التأمين أو تقارير التشخيص التي تنتهي صلاحيتها سنويًا) مهامًا تذكّر أصحاب المصلحة برفع إصدارات مجددة قبل انتهاء الصلاحية. *** ## كيف يعمل التحقق ### التحقق من المستند ``` Upload → PENDING_VALIDATION → All validators approve → VALIDATED → eligible for minting → Any validator rejects → REQUIRING_ACTION → uploader corrects and resubmits → Corrected version → PENDING_VALIDATION (cycle repeats) ``` بعد السَكّ: MINTED\ بعد مرور الوقت: EXPIRED (ينشئ مهمة UPDATE\_EXPIRED\_DOCUMENT)\ بعد التحقق من إصدار جديد: REPLACED أو CORRECTED ### التحقق من حقل BIM ``` User edits field → Change Request created → validators notified → All validators approve → field PENDING_TO_MINT → minted = on-chain record → Any validator rejects → UPDATE_REJECTED_3D_MODEL_FIELD task assigned to requester ``` *** ## كيف يسجّل blockchain البيانات تستخدم Magma ثلاثة عقود ذكية لكل مبنى على blockchain الخاص بـ VeChain: 1. **DTT Factory** — عقد مشترك واحد يقوم بنشر عقود DTT جديدة عند إنشاء المباني 2. **DTT Contract (ERC-1155)** — واحد لكل مبنى. يحتوي على معرّفات رموز متعددة — واحد لكل إصدار من ملف مستند وواحد لكل إصدار من كائن BIM 3. **HashStorage Contract** — واحد لكل مبنى، مقترن بـ DTT. يخزّن مصفوفة تجزئات (hashes) للإلحاق فقط لكل معرّف رمز عندما ترفع إصدارًا ثانيًا من مستند، يُضاف تجزئة جديد إلى مصفوفة معرّف الرمز نفسه. لا يُكتب فوق تجزئة الإصدار الأصلي أبدًا. يمكنك التحقق من أي إصدار تاريخي عبر الاستعلام عن التجزئة في موضع فهرسته. عنوان DTT® علني. يمكن لأي شخص زيارة `/dtt/[address]` لعرض التسلسل الهرمي الكامل لرموز المبنى، وجميع العناصر المسكوكة، وتجزئاتها على السلسلة. --- # 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/almqdmh/how-it-works.md?ask= ``` 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.