الوثائق
ملخص
يجلب CADCAMFUN الرسم والنمذجة الصلبة ومسارات الأدوات وتاريخ المشروع ومساعد الذكاء الاصطناعي إلى تطبيق سطح المكتب المحلي.
مترجم تلقائيًا من الإنجليزية. عرض الأصل بالإنجليزية
منتج
يجمع سطح المكتب بين طاولة عمل SolidJS وقشرة Tauri. تقوم طاولة العمل بتحرير الرسومات والنماذج، وتعرض الأشكال الهندسية في إطار عرض Three.js، وتدير عمليات المعالجة، وتقوم بمعاينة G-code أو تصديرها. تتم إدارة بيانات المشروع والأدوات والمواد وتكوينات الماكينة والحالة المساعدة بواسطة Bun Sidecar ويتم تخزينها محليًا.
تتم مشاركة النواة الحسابية بين سطح المكتب والسايدكار. يمكن تشغيل الهندسة التفاعلية في عرض الويب بدون رحلة ذهابًا وإيابًا عبر HTTP؛ تمر العمليات المستمرة ومكالمات الموفر وتاريخ المشروع وتنفيذ سير العمل من خلال الخدمات السايدكار. لا يتطلب التخزين المحلي حساب تطبيق مستضاف. يستخدم موفرو الذكاء الاصطناعي وعمليات GitHub والمدفوعات وتحديثات البرامج خدمات الشبكة التي تم تكوينها.
تصميم لتصنيع الآلات
- إنشاء مشروع أو فتحه وإعداد رسوماته أو كياناته أو مشهده الصلب. ال مرجع CAD يغطي الرسومات التخطيطية وهندسة B-rep والفسيفساء وتنسيقات التبادل.
- اختر العملية والأداة والمواد وتكوين الجهاز. إنشاء مسارات الأدوات باستخدام خدمات كام وفحص النتيجة في إطار العرض.
- يستخدم إعدادات الآلات ووثائق البرنامج للاحتفاظ بأمر التشغيل وإطارات العمل وإعدادات البرنامج. حدد منشورًا مسجلاً لوحدة التحكم المقصودة.
- قم بمراجعة البرنامج الذي تم إنشاؤه ونتائج التحقق قبل التصدير. تعد النواة الهندسية والتسجيل اللاحق وتحويلات G-code المتقدمة وتكوين الجهاز أجزاء مميزة من هذه العملية.
- تسجيل لقطة المشروع مع تاريخ، أو قم بتشغيل مسجل سير العمل للتحقق والمعالجة المتكررة.
ال مساعد يستدعي إجراءات التطبيق من خلال نفس محولات الخدمة التي يستخدمها التطبيق. ال رفيق المحمول يتصل بسطح المكتب المقترن؛ ولا يقوم بتشغيل واجهة CAD/CAM ثانية على الهاتف.
مكونات وقت التشغيل
apps/desktop- منضدة عمل SolidJS، ومحولات التوجيه، ووحدات الميزات، ومنفذ العرض، وقذيفة Tauri الأصلية.
apps/sidecar- معالجات HTTP والمستودعات وخدمات التأثير والهوية المحلية وتكامل الذكاء الاصطناعي والبوابة المصاحبة ودورة حياة قاعدة البيانات التي تم التحقق منها.
apps/mobile- رفيق المعرض مع النقل المقترن الأصلي، وطرق عرض المشروع والتاريخ، والوصول المساعد.
packages/web- موقع توثيق Astro هذا، وتصدير Markdown، ومساعد التوثيق، وصفحات الدليل التي تم إنشاؤها، والاستوديو المحلي.
ال مرجع مساحة العمل يصف كل مكتبة، ونقطة الدخول العامة، والمستهلكين. ال خريطة المصدر يشير إلى ملفات التنفيذ للتغييرات المشتركة.
ابدأ التطوير
bun install
bun run desktop:dev
# Documentation and local Studio
bun run --filter @cadcamfun/web dev يقوم أمر سطح المكتب بتجميع ملف السايدكار ونسخ موارد الترحيل قبل بدء تشغيل Tauri. يجب تثبيت المتطلبات الأساسية لبناء Rust وعرض ويب النظام الأساسي. لتشغيل خادم التوثيق دون بدء تشغيل Studio API المحلي، استخدم bun run --filter @cadcamfun/web start.
يتبع بداية سريعة للمتطلبات الأساسية والإطلاق الأول، أو التنمية المحلية للحلقات السايدكار المعزولة وحلقات العميل.
العقود والثبات
packages/api/src/index.ts ينشئ عقد HTTP للمخطط الأول. السايدكار ServedApi يختار المجموعات التي يخدمها وينشر مستند OpenAPI فيها /api/openapi.json. تكتشف الصدفة منفذ الاسترجاع المخصص ديناميكيًا من حدث الاستعداد وتمنح عرض الويب نقطة نهاية ورمزًا مميزًا لحاملها.
قاعدة بيانات السايدكار هي cadcamfun.db ضمن دليل البيانات الذي تم تكوينه. تعمل طبقة قاعدة البيانات على تمكين المفاتيح الخارجية وWAL، وتطبق عمليات الترحيل التي تم تكوينها، وتقوم بعمل نسخة احتياطية من ملف موجود قبل الترقية المعلقة. لدى استوديو التوثيق اختيار مسار قاعدة البيانات الخاص به؛ ولا يكتشف ملف السايدكار الجاري تشغيله تلقائيًا.
تصف هذه الصفحات التنفيذ في هذا المستودع. يعد تصدير الحزمة ونقطة نهاية HTTP وعنصر تحكم سطح المكتب والمثبت الذي تم إصداره بمثابة أسطح تكامل مختلفة؛ راجع المرجع ذي الصلة لمعرفة السلوك والحدود المدعومة.
اختر مسار العمل
| مهمة | ابدأ هنا | ما يجب الاحتفاظ به |
|---|---|---|
| تحرير جزء | هندسة CAD و ضوابط إطار العرض | الرسم القابل للتحرير أو سجل الميزات، بما في ذلك الوحدات والموضع. |
| توليد مخرجات المعالجة | كام و البرامج المحفوظة | الهندسة الملتقطة، والمخزون، والأدوات، وإعدادات الماكينة، وNC المنبعثة، وأدلة التحقق القابلة للتطبيق. |
| مراجعة التغيير | تاريخ المشروع | الالتزام والفرق الهيكلي بالإضافة إلى أحكام المراجعة الحالية. |
| أتمتة الفحص المتكرر | سير العمل | ملف سير العمل الملتزم والمرجع المحدد والخطوات المسجلة ونتائج الفحص الفردية. |
| بناء التكامل | مرجع واجهة برمجة التطبيقات | نوع الرمز الصحيح، وعقد نقطة النهاية الدقيق، ومعالجة النتائج/الأخطاء. |
عمليات حفظ المشروع، وإصدارات الموارد، وعمليات تنفيذ المشروع بالكامل، والمزامنة عن بعد، وعناصر الدليل التي تم إنشاؤها هي عمليات منفصلة. لا يؤدي حفظ مسار الأدوات إلى تنفيذه تلقائيًا، ولا تتحقق عملية الدفع الناجحة على GitHub من مخرجات المعالجة الخاصة به.
للحصول على أول تكامل لواجهة برمجة التطبيقات (API)، اتبع طلب تجول. ويعرض فحص الصحة العامة والمكالمات المحمية وإنشاء المشروع وتخزين التفضيلات مع استجابات المعالج التي تم التقاطها.
الوثائق التشغيلية
ال مكتبة الدليل يمشي من خلال المهام الكاملة. ابدأ بـ إنشاء المشروع وحفظ العمل، ثم استخدم التصنيع الأصلي لاتخاذ تصميم تم التقاطه من خلال التوليد واستمرارية البرنامج. كلاهما يشرح ما تم حفظه وما تبقى من الحالة المشتقة أو غير المحفوظة.
للعمل التكاملي، مرجع موارد واجهة برمجة التطبيقات يغطي كل عملية معلنة بمخططات الطلب والاستجابة. ال دليل تكامل العميل يغطي بناء الوعد والتأثير، والمصادقة، والإلغاء، ومعالجة الأخطاء. ال دليل التدفق يضيف استعادة المحادثة والتعامل مع الأذونات/الأسئلة التفاعلية.
للتشغيل والدعم، استشر تكوين وقت التشغيل, تشخيص سطح المكتب، و الاقتران رفيق. يحافظ كل منها على تميز الغلاف الأصلي والسايدكار وقاعدة البيانات والموفر وبوابة الهاتف ونشر الوثائق بحيث يمكن التحقق من الفشل عند حدوده الفعلية.
للملحقات والعمل الجماعي، استخدم تأليف البرنامج المساعد و الفروع والمراجعات وسير العمل. توثق هذه الأدلة صادرات الوحدات المدعومة، وسلوك المضيف الحالي، وقواعد الدمج الهيكلي، ومدخلات سير العمل الملتزمة، والتأثيرات الجانبية المدعومة بالخدمة.
CADCAMFUN بالأرقام
| يقيس | قيمة |
|---|---|
| نسخة التطبيق | 6.0.0 |
| عمليات HTTP / مجموعات الموارد | 270 / 34 |
| جداول قاعدة البيانات / الهجرات | 60 / 4 |
| مساحات العمل | 10 حزم، 3 تطبيقات |
| أهداف إصدار سطح المكتب | 6 (macOS وWindows وLinux، كل x64 وARM64) |
| لهجات مشاركة G-code | عام، GRBL، Fanuc، Haas (اسم LinuxCNC محجوز) |
| استراتيجيات CAM الأصلية | الوجه، التكيف، الجيب، الملف الشخصي، التجويف، الحفر، الخيط، النقش، الشطب، السطح |
| ادعاءات أدلة النواة | 10، من قطع البيانات إلى إعادة تشغيل NC وتصفية الجهاز |
ما هو الجديد
العمل الأخير على الفرع الرئيسي، ملخص من تاريخ الالتزام:
- النواة الدقيقة على السايدكار. A
cadExactمجموعة (analyze,step,assembly) يُجري تحليلًا مشتركًا للمشهد من الأساس: الصلاحية لكل مادة صلبة، والكتلة، والثقوب، والتداخل، وفاتورة المواد، والمثبتات المفقودة. - النمذجة الدقيقة. تكتسح الأصداف وتكتسحها، والغرف العلوية ذات أعمدة مسطرة عقلانية، والدفع والسحب والتزاوج على الوجوه الدقيقة، والشرائح بحوالي 2.5× أسرع.
- البرامج الفرعية NC تتم كتابة مسارات الأدوات المتكررة مرة واحدة بشكل تزايدي
M98برنامج فرعي؛ إعادة يفهمO-البرامج،M98/M99وG91. سلكي من النهاية إلى النهاية من اللقطة إلى مفتاح سطح المكتب. - CAM من B-rep. يقرأ المخطط الثقوب والجيوب والخطوط العريضة من المواد الصلبة الدقيقة، بما في ذلك أجزاء STEP والأجزاء الدوارة؛ تعمل إزالة المخزون الحجمي على طول محور الأداة المائل.
- تصلب مساعد. Every action declares its result schema; destructive tools always need a human; each turn is bound to its drawing with compare-and-swap writes; a durable background-task journal; kernel jobs in a worker.
- التوثيق. موقع Astro هذا مزود بمرجع API الذي تم إنشاؤه لكل عملية.
الخطوات التالية
| إذا كنت تريد أن… | اذهب الى |
|---|---|
| تثبيت البنية المنشورة | تحميل و ثَبَّتَ |
| قم بتشغيل التطبيق من المصدر | بداية سريعة، ثم التنمية المحلية |
| فهم العمليات | بنيان و سايدكار |
| نموذج جزء | كندي و إطار العرض |
| إنشاء رمز G | كام و تصنيع وطنى |
| اتصل بواجهة برمجة التطبيقات | جولة API و عملاء API |
| تمديد التطبيق | تأليف البرنامج المساعد |
| إدارة حسابك | Studio و الحسابات |
| يساهم | المساهمة |