RevitCDE — نظرة عامة على الحل

للمشترين

01ما هذا

RevitCDE هو بيئة بيانات مشتركة لمشاريع Revit.

يربط إجراءات المستخدم بكائنات نموذج محددة.

الفكرة الرئيسية

أنشئ حلقة رقمية قابلة للتدقيق.

للمشترين

02لمن صُمم

يخدم RevitCDE عدة أدوار مختلفة.

منسق BIM / مدير المشروع

يرى حالة النموذج والموافقات والمستندات والمهام.

المؤلف (المصمم)

يعمل داخل Revit دون تبديل السياق باستمرار.

الموافق

يراجع الطلبات الواردة مع اللقطة والمستندات.

المشاهد

وصول للقراءة ضمن نطاق المشروع.

مسؤول التقدير

قاعدة التقدير والبنود والتكاليف غير المرتبطة بالنموذج.

مهندس التخطيط

الجدول الزمني والأنشطة والعمليات الزمنية غير المرتبطة بالنموذج.

المسؤول

الخادم والمستخدمون والمشاريع وقواعد البيانات والسياسات.

للمشترين

03المشكلات التي نحلها

فجوة بين Revit وعمليات الإدارة

لماذا يسبب مشكلة

تعيش الموافقات والمهام منفصلة عن النموذج.

كيف نعالج ذلك

تلتقط الإضافة بيانات النموذج وتربط الطلبات بالكائنات.

لا يوجد مصدر حقيقة واحد

لماذا يسبب مشكلة

تتباعد إصدارات الملفات والبريد الإلكتروني وجداول البيانات.

كيف نعالج ذلك

تخزن بنية CDE المشاريع والمستندات والإصدارات والسجل.

موافقات غير شفافة

لماذا يسبب مشكلة

تضيع القرارات وتكون المسارات غير رسمية.

كيف نعالج ذلك

ApprovalRequest ومسارات متعددة المراحل وأحداث للإضافة فقط ولقطات ثابتة غير قابلة للتغيير.

حالة النموذج غير مرئية في Revit

لماذا يسبب مشكلة

لا يرى المصمم ما تمت الموافقة عليه أو ما هو قيد الانتظار أو مرفوض.

كيف نعالج ذلك

تنعكس الحالات في Shared Parameters وExtensible Storage.

عدم اتصال 3D و4D و5D

لماذا يسبب مشكلة

يعمل التقدير والجدول الزمني بصورة منفصلة، فتخرج الأعمال غير المرتبطة بالنموذج من نطاق المتابعة.

كيف نعالج ذلك

ملفا estimate.db وschedule.db لكل مشروع، مع WorkPackage كمحور 4D/5D.

عمل دون اتصال / محلي من دون خادم

لماذا يسبب مشكلة

تحتاج النماذج المنفصلة إلى تخزين محلي دون فقدان مسار العودة إلى الخادم.

كيف نعالج ذلك

وضع محلي في Extensible Storage، مع قاعدة خارجية اختيارية في ملف واحد وإمكانية الترحيل لاحقًا إلى الخادم.

للمشترين

04كيف يعمل

تكوّن ثلاث طبقات حلقة بيانات واحدة.

يعمل المستخدم في Revit. تقرأ الإضافة عناصر النموذج واللوحات والمناظير والجداول والحالات.
يرتبط النموذج بمشروع على الخادم. ويُخزّن الربط داخل نموذج RVT باستخدام Extensible Storage.
تزامن الإضافة عناصر المشروع وعناصر النموذج والتغييرات والحالات والطلبات والمهام والمحادثات والمستندات مع الخادم.
يحتفظ الخادم بالبيانات العامة في قاعدة البيانات الرئيسية وبالبيانات المتخصصة في قواعد لكل مشروع: model_{guid}.db وdisciplines.db وestimate.db وschedule.db.
تعرض خزانة الويب المشاريع والمستندات والموافقات والمهام والمحادثات والإدارة؛ وتتدفق التحديثات الفورية عبر SignalR.
تعود قرارات الموافقين وتغييرات الحالة والمستندات والمهام المرتبطة إلى Revit وتظهر في الإضافة ومعلمات النموذج.

المبدأ المعماري

الخادم هو مصدر الحقيقة في وضع التعاون؛ ويحتفظ النموذج بالحد الأدنى من الربط والبيانات المحلية حتى يستمر العمل بعد إعادة تشغيل Revit وفترات انقطاع الاتصال.

للمشترين

05ما يفعله

الخريطة الوظيفية بنظرة سريعة.

المشاريع

إعداد المشروع والأعضاء والأدوار والمعايير والتخصصات والمراحل والحزم.

النموذج

ربط RVT والمزامنة والمعرّفات والبصمة والحالات وتتبع التغييرات غير المتزامنة.

الموافقات

الطلبات والمسارات واللقطات والقرارات والسحب والسجل والتحديث الفوري.

المستندات

مستندات CDE والإصدارات والرفع/التنزيل وSHA-256 وWIP→Shared→Published→Archived.

المهام

Kanban وGantt والأهمية والحالات والمكلفون وعلاقات المهام.

الاتصالات

محادثات المشروع والرسائل والتفاعلات والمراسلات وتكامل البريد الإلكتروني.

الإدارة

المستخدمون والأدوار ومعلمات الخادم وقواعد البيانات والصحة وسياسات التفويض.

4D/5D

التقدير والجدول الزمني وWorkPackage ولقطات الكميات وEVM/CPM.

العمل المحلي

Extensible Storage، وقاعدة محلية خارجية اختيارية، والترحيل إلى الخادم.

التوطين

توطين مركزي لواجهة المستخدم، 22 لغة ضمن خارطة الطريق.

للمشترين

06سيناريوهات الاستخدام

إرسال لوحة أو منظور للموافقة

الخطوة 1
الخطوة 2
الخطوة 3
الخطوة 4
الخطوة 5
الخطوة 6

مستند من WIP إلى النشر

الخطوة 1
الخطوة 2
الخطوة 3
الخطوة 4
الخطوة 5

ربط النموذج بالتقدير والجدول الزمني

الخطوة 1
الخطوة 2
الخطوة 3
الخطوة 4
الخطوة 5

للمشترين

07الأسئلة الشائعة

السؤال 1

الإجابة 1

السؤال 2

الإجابة 2

السؤال 3

الإجابة 3

السؤال 4

الإجابة 4

السؤال 5

الإجابة 5

السؤال 6

الإجابة 6

السؤال 7

الإجابة 7

السؤال 8

الإجابة 8

السؤال 9

الإجابة 9

السؤال 10

الإجابة 10

تفاصيل تقنية

08تركيب الحل

المكوّن	الغرض	التقنية
`RevitCDE.Addin`	نقطة دخول إضافة Revit وربط النموذج وتسجيل الأوامر.	C# /.NET Framework, Autodesk Revit API
`RevitCDE.UI`	لوحات سطح المكتب والأوامر وتفاعل المستخدم داخل Revit.	WPF / MVVM
`RevitCDE.Core`	خدمات التطبيق والمزامنة والتخزين المحلي والاتصال بالخادم.	C# services, HTTP clients, SQLite
`RevitCDE.Domain`	نماذج مجال مشتركة ومعرّفات وحالات وقواعد أعمال.	netstandard2.0 library
`RevitCDE.Server`	واجهة API مركزية والمصادقة وبيانات المشروع وخدمات التكامل.	ASP.NET Core 8, EF Core, PostgreSQL
`RevitCDE.Cabinet`	خزانة ويب للمشاريع والمستندات والموافقات والمهام والمحادثات والإدارة.	TypeScript / React web UI
`RevitCDE.Localization`	قواميس ترجمة مركزية وتبديل اللغة لكل واجهة المستخدم المرئية.	قواميس JSON ومفاتيح i18n مشتركة

تفاصيل تقنية

09الوضعان المحلي ووضع الخادم

يدعم RevitCDE وضعين للتشغيل.

الوضع المحلي

توجد البيانات في Extensible Storage الخاصة بالنموذج.

تخزين محلي خارجي

ملف قاعدة بيانات منفصل لكل نموذج RVT.

وضع الخادم

توجد البيانات النشطة على الخادم.

الوضعان المحلي ووضع الخادم

قواعد الترحيل من المحلي إلى الخادم.

تفاصيل تقنية

10بنية التخزين

المخزن	ما الذي يخزنه	لماذا يعمل بهذه الطريقة
قاعدة الخادم الرئيسية	المستخدمون والمؤسسات والمشاريع والأدوار والإعدادات العامة وبيانات الرخص.	تحتفظ ببيانات المشاريع المتقاطعة في قاعدة خادم مرجعية واحدة.
model_{guid}.db	عناصر النموذج واللوحات والمناظير والجداول والكميات والارتباطات على مستوى النموذج.	تُعزل بيانات النماذج الكبيرة لكل نموذج RVT لتحسين الأداء والصيانة.
disciplines.db	تخصصات المشروع ومراحله وحزمه وبنية الوثائق الخاصة بالمعيار.	يمكن أن تتطور معايير المشروع دون تغيير المخطط العام.
estimate.db	مستندات التقدير والبنود والتكاليف غير المرتبطة بالنموذج وروابط الكميات وارتباطات WorkPackage.	لبيانات التكلفة دورة حياة مستقلة ويجب أن تشمل البنود غير الموجودة في النموذج.
schedule.db	أنشطة الجدول الزمني والتبعيات والعمليات الزمنية غير المرتبطة بالنموذج وروابط WorkPackage.	تحتاج بيانات التخطيط إلى منطق CPM/Gantt وقد تشير إلى بيانات النموذج والتقدير معًا.
Extensible Storage	الحد الأدنى من ربط النموذج والمعرّفات التقنية وبيانات الرجوع المحلية داخل RVT.	يظل النموذج قادرًا على تعريف نفسه حتى خارج بيئة الخادم.
قاعدة بيانات محلية خارجية	قاعدة محلية اختيارية في ملف واحد للمحادثات والموافقات والمستندات والمهام والبيانات المحلية الأخرى.	يمكن للنماذج المنفصلة/المحلية الاحتفاظ ببيانات أغنى دون تضخيم Extensible Storage.

تفاصيل تقنية

11الأمان والوصول

يعتمد الأمان على العضوية والأدوار وJWT وأوضاع الثقة.

مصادقة JWT.
تجزئات كلمات مرور آمنة؛ ومسؤول أولي عند الإعداد الأول.
تسجيل الدخول باسم المستخدم أو البريد الإلكتروني أو الهاتف إذا تم تكوينه.
تسجيل دخول المستخدم هو الوضع الأساسي.
وضع محطة عمل اختياري دون كلمة مرور.
لا تزال الإجراءات عالية الثقة تتطلب تسجيل دخول حقيقيًا.
صلاحيات Read / Write / Manage / Admin ضمن نطاق المشروع.

تفاصيل تقنية

12الموافقات — من الداخل

عملية رسمية قابلة للتكرار.

إرسال للموافقة

ينشئ طلب موافقة لمراجعة النموذج أو حزمة المستندات المحددة.

لقطة ثابتة غير قابلة للتغيير

يسجل الحالة الدقيقة للنموذج والمستند قيد المراجعة حتى يظل القرار قابلاً لإعادة الإنتاج.

مسارات الموافقة

يحدد خطوات مراجعة مرتبة أو متوازية والمشاركين المسؤولين والقرارات المطلوبة.

القرارات المسجلة

يخزن الموافقات والرفض والإرجاعات والتعليقات مع المؤلف والطابع الزمني.

سجل الأحداث

يحتفظ بخط زمني للإضافة فقط لعمليات الإرسال والتكليف والقرارات وتغييرات الحالة.

مزامنة الحالة

يعيد حالة الموافقة المؤكدة إلى كائنات المشروع وسير عمل Revit المتصل.

تحديثات فورية

ينشر تغييرات الموافقة إلى العملاء المتصلين دون الحاجة إلى تحديث الصفحة يدويًا.

تفاصيل تقنية

13WorkPackage — محور 4D/5D

الكائن المركزي الذي يربط النموذج والكميات والتقدير والجدول الزمني والتقدم.

`ModelElement`	يربط حزمة العمل بعناصر BIM ومعرّفاتها الثابتة.
`QuantityItem`	يخزن الكميات المقاسة والمصدر الذي تم الحصول منه على كل كمية.
`EstimateItem`	يربط الكميات ببنود التقدير وأسعار الوحدات والتكلفة المحسوبة.
`WorkPackage`	يعمل ككائن مركزي يربط النطاق والنموذج والتكلفة والجدول الزمني والمسؤولية والأدلة.
`ScheduleActivity`	يربط حزمة العمل بالأنشطة المخططة والتواريخ والتبعيات وبيانات المسار الحرج.
`ProgressSnapshot`	يخزن التقدم الفعلي ومؤشرات القيمة المكتسبة ووقائع فترة التقرير.

Why no cross-DB FK

تُقسّم قواعد بيانات المشروع حسب مجال الموضوع.

تفاصيل تقنية

14المعايير والتخصصات والمراحل والحزم

يقود معيار المشروع تنسيقات الوثائق والتقدير والجدول الزمني.

`ProjectStandard`

يحدد قواعد المشروع النشطة واتفاقيات التسمية وبنية المعلومات المطلوبة.

`التخصص`

يحافظ على دليل تخصصات المشروع والمسؤوليات الخاصة بكل تخصص.

`PackageType`

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

`ProjectStage`

يتحكم في مراحل المشروع وانتقالاتها والبيانات المتوقعة في كل مرحلة.

`ProjectRole`

يحدد المسؤولية والصلاحيات وسلطة الموافقة داخل المشروع.

`StandardPreset`

يطبّق حزمة قابلة لإعادة الاستخدام من المعايير والتخصصات والمراحل والأدوار وأنواع الحزم.

تفاصيل تقنية

15REST API — المجموعات الرئيسية

REST API حسب مجال الموضوع، مع مصادقة JWT.

`/api/auth/*` · المصادقة وجلسات الحساب واستعادة كلمة المرور ورموز الوصول.
`/api/approvals/*` · طلبات الموافقة ومساراتها وقراراتها وتعليقاتها وتغييرات حالتها.
`/api/cde/*` · المشاريع والنماذج والمستندات والمشكلات وبيانات المشروع المشتركة.
`/api/chats/*` · محادثات المشروع والمشاركون والرسائل والمرفقات.
`/api/tasks/*` · المهام والمكلفون بها وتواريخ الاستحقاق والأولويات وحالات الإنجاز.
`/api/standards/*` · معايير المشروع والتخصصات والمراحل والأدوار وقوالب الحزم.
`/api/45d/*` · حزم العمل والكميات والتقديرات وأنشطة الجدول الزمني والتقدم.
`/api/admin/*` · الإدارة والتهيئة والتشخيص وعمليات الصيانة المنضبطة.

تفاصيل تقنية

16المصطلحات

CDE: بيئة بيانات مشتركة — مساحة منضبطة لمعلومات المشروع والاتصال والقرارات.
Extensible Storage: آلية Revit لتخزين بيانات تطبيق منظمة داخل النموذج.
Shared Parameters: معلمات Revit مشتركة بين المشاريع والعائلات عبر ملف تعريف موحد.
ProjectElement: سجل على جانب المشروع يمثل عنصر BIM خارج مستند Revit.
ModelElement: مرجع ثابت إلى عنصر في نموذج ومراجعة نموذج محددين.
Snapshot: سجل غير قابل للتغيير للحالة الدقيقة لبيانات المشروع المستخدمة للمراجعة أو الموافقة.
ApprovalRequest: طلب رسمي يرسل نطاقًا محددًا عبر مسار موافقة.
WorkPackage: الكائن المركزي رباعي/خماسي الأبعاد الذي يربط النطاق والكميات والتكلفة والجدول الزمني والمسؤولية.
EVM: إدارة القيمة المكتسبة — قياس التقدم باستخدام القيمة المخططة والقيمة المكتسبة والتكلفة الفعلية.
CPM: طريقة المسار الحرج — تحليل للجدول الزمني يعتمد على تبعيات الأنشطة والهامش الزمني المتاح.

تفاصيل تقنية

17ما القادم

يحتوي التنفيذ الحالي على نواة عاملة؛ وفيما يلي ما نعمل على تطويره لاحقًا.

توطين موسع

مراجعة كاملة للمصطلحات وصياغة متخصصة لكل لغة مدعومة.

سير عمل المستندات

سجلات مستندات بإصدارات، وإرسالات، وحزم مراجعة، وسلاسل أدلة.

4D/5D أعمق

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

التوافق عبر BCF

تبادل المشكلات ونقاط الرؤية مع تطبيقات BIM الأخرى عبر معيار BCF.

تنسيق النماذج المرتبطة

تنسيق النماذج المرتبطة والملكية والمراجعات والتبعيات بين النماذج.

قابلية المراقبة

لوحات معلومات تشغيلية ومقاييس تدقيق وتشخيص ومراقبة صحة الخدمات.