Zero-Gap Laser CAD Pro ⚡ (Industry Edition)

📖 نظرة عامة (Overview)

Zero-Gap Laser CAD Pro هو محرك هندسي متقدم يعتمد على الويب، صُمم خصيصاً لقطاع صناعة الأواني المنزلية (Kitchenware Manufacturing) وتطبيقات الليزر ذات الـ Tube Cutting. يوفر النظام حلاً للتشكيل والقطع وتطابق "التطابق الصفري" (Zero-Gap) للأنبوب الساند للمقبض والجدار المنحني للمقلاة، مما يضمن لحاماً ليزرياً دقيقاً.

تم تطوير التطبيق ليسمح بمعاينة الأشكال الهندسية وإجراء عمليات الطرح الهندسي البولياني (CSG Boolean Operations) في المتصفح مباشرة!

---

✨ الميزات التقنية لمصانع الليزر (Key Industrial Features)

1. الإسقاط الهندسي التام (Zero-Gap Projection)

• القاطع الافتراضي (Pan Cutter): يحاكي شكل المقلاة بقسم مخروطي مع إضافة "قوس القاع" (Bottom Fillet).
• استيراد ملفات STL مخصصة: يدعم التطبيق تحميل ملفات STL مخصصة لاستخدامها كأنبوب أو شكل قاطع للعمليات الهندسية المتقدمة.

2. وضع التعشيش المزدوج (Twin Nesting Mode)

يضاعف الإنتاج عن طريق لصق قطعتين متعاكستين ظهراً لظهر مع توليد خط قطع مشترك (Common Line Cut).

3. المعالجات والتخليصات الحرارية

إضافة تخليصات لتسهيل عملية اللحام بالليزر، مع عمليات الطرح (Subtraction) والتأكد من عدم التداخل.

4. تصدير STEP للحصول على دقة NURBS باستخدام CadQuery

لدعم أنظمة CAD/CAM الاحترافية (مثل WiseCAM و NcStudio)، يقوم النظام بتوليد سكريبت بايثون (Python Script) جاهز للاستخدام مع مكتبة CadQuery لتوليد نماذج STEP صلبة بخطوط B-Rep دقيقة بعكس مجسمات STL المضلعة.

---

🛠️ دليل المطورين والتقنيات (Developer Guide & Stack)

أُسس هذا المشروع على بيئة عمل حديثة ومستقرة:

• الواجهة (Frontend): React 18, Vite, TypeScript.
• التصميم (Styling): Tailwind CSS بواجهة مستخدم زجاجية وداكنة (Glassmorphism & Industrial Dark Mode).
• محرك 3D: three.js (الإصدار ~0.183)، مع مكتبات three-stdlib للتحكم (OrbitControls) ومحملات / مُصدرات STL.
• محرك CSG (التشكيل الصلب): three-csg-ts لتطبيق العمليات البوليانية (Union, Subtract, Intersect) على شبكات الـ 3D مباشرة في المتصفح، مما يخلق تجربة CAD حقيقية.

بنية المجلدات المهمة (Directory Structure)

• src/components/ThreeCanvas.tsx: (قلب التطبيق) يحتوي على منطق الـ WebGL لإنشاء الأشكال الأساسية (ExtrudeGeometry/LatheGeometry للمقلاة)، وقراءة ملفات STL המخصصة، وتنفيذ الطرح CSG.subtract() لإنتاج القطعة النهائية، ومعالجتها للعرض وضبط تمركز الكاميرا آلياً.
• src/components/ZeroGapControlPanel.tsx: لوحة تحكم المعاملات الجانبية، حيث يتم رفع ملفات STL المخصصة، واختيار أبعاد الأنبوب والمقلاة وأنماط التعشيش.
• src/lib/exportUtils.ts: الملف المسؤول عن هندسة كود CadQuery. يحتوي على القوالب لإنشاء وتصدير ملفات STEP عن طريق بايثون كنظام رديف (Backend Replacement).

استقرار التطبيق والإرشادات (App Stability & Tips)

• ملفات الأشكال المخصصة (STL): عند استخدام ملف STL مخصص لمحاكاة أنبوب، يقوم المحرك بمحاذاة المضلعات (Compute Vertex Normals). احرص على تخفيف الملفات لضمان أداء WebGL ثابت لأن عمليات الـ CSG مكثفة رياضياً.
• الحدود البوليانية: مكتبة CSG في المتصفح تتأثر بالـ Vertex Precision. حاول الحفاظ على أحجام متناسبة (كأن تكون المعاملات بالملمترات الصحيحة) لتجنب أخطاء تداخل الأوجه (Non-manifold geometry issues).
• مواجهة الكاميرا السريعة: زر التمركز والكاميرات الإسقاطية (Isometric, Top, Front, الخ) تطلب قياس الإحداثيات الطرفية (BoundingBox) للمجسم الناتج لتوجيه مركز المشهد (OrbitControls).

---

🚀 دليل الاستخدام السريع

1. تحديد البارامترات: أدخل الأبعاد أو قم برفع ملف STL من خلال واجهة القطع المخصص.
2. شكل المقلاة: اضبط أبعاد القطعة المقابلة.
3. التصدير والمشاركة:
   • انقر تصدير STL لطباعة 3D.
   • انقر تنزيل سكريبت المصنع ليتم توليد كود بايثون متقدم يمكن لمشغلي الماكينة ومبرمجيها تنفيذه لإنتاج STEP.