---
name: engineering-digital-twin-design
description: Design engineering-grade digital twin behavior for Blumark24 OS across hierarchy, packages, operational modules, Virtual Office, and AI. Use for digital twin modeling, truthful state design, and system-safe simulation boundaries.
---

# engineering-digital-twin-design

## الهدف
تصميم التوأم الرقمي هندسيًا بحيث يمثل المنشأة والهيكل والباقات والوحدات التشغيلية بصدق، دون كسر النظام أو اختراع واقع غير موجود.

## متى تستخدمها
- عند تصميم أو مراجعة سلوك توأم رقمي.
- عند ربط المكتب الافتراضي بالهيكل أو الباقات أو AI.
- عند تقييم الفرق بين العرض، المحاكاة، والحقيقة التشغيلية.

## حدود الصلاحية
- ممنوع استخدام بيانات وهمية أو مؤشرات غير حقيقية.
- ممنوع تغيير التصميم أو RTL أو الهوية دون طلب صريح.
- ممنوع تعديل Supabase/RLS/migrations دون طلب صريح.
- ممنوع localStorage للبيانات التجارية أو الحساسة.
- أي تعديل يجب أن يكون صغيرًا ومحدود النطاق.

## قواعد Blumark24 OS الخاصة
- التدفق المعتمد: Owner -> Organization -> Settings -> Administrative Structure -> Employees -> Roles & Permissions -> Operational Modules -> Virtual Office -> AI.
- التوأم الرقمي يجب أن يرتبط بالمنشأة والصلاحيات والباقات عند الحاجة.
- لا تجعل المحاكاة تبدو كبيانات تشغيلية حقيقية.
- الحالات الفارغة يجب أن تقول الحقيقة.
- السوق السعودي واللغة العربية أولًا.
- حماية RTL والهوية البصرية واجبة.

## قائمة فحص قبل التعديل
- حدد هل المطلوب تمثيل حقيقي أم تصور بصري.
- حدد مصادر البيانات والقيود والباقات.
- راجع أثر التعديل على الهيكل والمكتب الافتراضي وAI.
- تأكد من عدم إدخال fallback مضلل.
- تأكد من أن النطاق لا يتطلب قاعدة بيانات بلا تصريح.

## قائمة فحص بعد التعديل
- تحقق أن التوأم الرقمي لا يعرض بيانات غير موجودة.
- شغل lint/build عند تعديل كود.
- راجع الحالات الفارغة والرسائل العربية.
- تأكد أن التصميم والهوية وRTL لم تتغير بلا طلب.
- وثق حدود النموذج وما يعتمد عليه من بيانات.

## مخرجات التقرير المطلوبة من Claude Code
- الملفات المعدلة.
- نموذج التوأم الرقمي أو السلوك المتأثر.
- مصادر البيانات وحدودها.
- طريقة احترام المنشأة والصلاحيات والباقات.
- نتيجة lint/build.