أدلة وسير العمل

اختر دليلاً

• بداية سريعة: تثبيت التبعيات، وبدء تشغيل سطح المكتب، وتحديد موقع قاعدة البيانات الخاصة به.
• ثَبَّتَ: قم بتنزيل نسخة سطح المكتب المنشورة، وتحقق من مجموعها الاختباري، وتمييزها عن الخروج المصدر.
• الحسابات: تحرير الملف الشخصي وكلمة المرور ومفاتيح API وهوية git في الاستوديو المحلي.
• التنمية المحلية: تشغيل معاينة المتصفح أو السايدكار الحقيقية، وتكوين العمليات، وتشخيص بدء التشغيل.
• رمز المساهمة: تحديد موقع الوحدات وتغيير العقود المشتركة وتحديد الشيكات.
• الحزم: التنقل بين مسؤوليات مساحة العمل ونقاط الدخول العامة.

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

فهم وقت التشغيل

تنفذ الحزمة الأساسية الهندسة ومسارات الأدوات والمشاركات والتحقق. تحدد حزمة API المخططات المشتركة ونقاط النهاية والعملاء الذين تم إنشاؤهم. يجمع السايدكار هذه العقود مع المستودعات وSQLite وAI والمكونات الإضافية والتحكم في الإصدار وخدمات سير العمل. يعرض سطح المكتب هذه الخدمات من خلال اتصال واجهة برمجة التطبيقات (API) المحلي والواجهة الأصلية.

يتصل رفيق iOS من خلال بوابة HTTPS منفصلة مثبتة. تعمل حزمة الويب على تشغيل موقع وثائق Astro وتكامل الاستوديو المحلي. هؤلاء عملاء منفصلون ويجب ألا يُفترض أنهم يشاركون مسار قاعدة البيانات أو سياق الأمان.

الأوامر المشتركة

bun install
bun run desktop:dev
bun run --filter @cadcamfun/desktop dev
bun run --cwd packages/web start

desktop:dev يبني السايدكار الحقيقية وينظم عمليات الهجرات قبل فتح Tauri. سطح المكتب dev يبدأ البرنامج النصي Vite على المنفذ 1420؛ وبدون عنوان URL السايدكار، فإنه يستخدم واجهة برمجة التطبيقات للمعاينة في الذاكرة. الويب start يبدأ البرنامج النصي بـ Astro فقط؛ إنه dev يبدأ البرنامج النصي أيضًا واجهة برمجة تطبيقات Studio المحلية.

إنشاء الترحيل مخصص لتغييرات المخطط، وليس شرطًا أساسيًا للتثبيت. تقوم طبقة قاعدة البيانات بإنشاء قاعدة بيانات جديدة وتطبق عمليات الترحيل المتاحة عند فتحها. راجع البداية السريعة قبل اختيار مسار قاعدة بيانات CLI.

يتم تعريف البرامج النصية الجذرية في المستودع package.json: typecheck, test, build, build:sidecar, build:desktop, desktop:dev, generate, generate:check, db:generate، و db:migrate.

ابدأ بتدفق ملموس

لتطوير سطح المكتب، افتح مشروعًا، وقم بإنشاء رسم أو تحميله، وافحص تدفق CAD/CAM الذي تنوي تعديله. اتبع محول المسار الخاص به في شاشة الميزات وحدد موقع استدعاء API والمعالج. بالنسبة لعمل الخادم، استخدم المخطط والمعالج والخدمة وسلسلة المستودع لتحديد مكان حدوث التحقق من الصحة والملكية والاستمرارية.

بالنسبة للعمل المصاحب، قم بتثبيت إصدار iOS أصلي، وتمكين بوابة سطح المكتب، والإقران من خلال رمز الاستجابة السريعة الخاص به. بالنسبة إلى أعمال التوثيق، ابدأ تشغيل Astro، وافتح المسار الذي تم تغييره، وقم بتشغيل إنشاء الويب لاكتشاف أخطاء القالب والعرض المسبق.

حافظ على حدود واضحة

احتفظ ببيانات الاعتماد خارج المصدر والأمثلة والسجلات ولقطات شاشة المتصفح. استخدم العناصر النائبة في الوثائق وقم بتوفير تكوين وقت التشغيل من خلال العملية المدعومة أو إعدادات التطبيق. حافظ على مزامنة العملاء الذين تم إنشاؤهم مع عقودهم، وقم بإنشاء عمليات ترحيل SQL من المخطط بدلاً من تحرير ملفات الترحيل التي تم إنشاؤها.

استخدم دليل بيانات منفصلًا يمكن التخلص منه لاختبارات التكامل والتجارب المحلية. إن تجهيزات المعاينة، وقاعدة بيانات ترحيل CLI، وقاعدة بيانات التطبيقات المجمعة، والبوابة المصاحبة لها أغراض مميزة؛ يجب أن يكون اختيار واحد واضحًا.

ابحث عن سير العمل المناسب

استخدم دليلاً لسلسلة من الإجراءات والصفحات المرجعية المرتبطة للحصول على تفاصيل المجال والسلوك. اجعل اختيار وقت التشغيل واضحًا طوال سير العمل: يؤدي التغيير من أداة تثبيت للمتصفح إلى أداة سايدكار أصلية إلى تغيير الثبات وبيانات الاعتماد والقدرات الأصلية وسلوك الخطأ.

تعرف على ما يثبته الشيك

الشيكات المختلفة تجيب على أسئلة مختلفة. يمكن لمترجم TypeScript أن يثبت أن استدعاء العميل يطابق توقيعه الذي تم إنشاؤه. يمكن أن يثبت اختبار المعالج الاستجابة المتوقعة ضمن الطبقات المتوفرة. يمكن لتشغيل جهاز محاكاة أصلي ممارسة تثبيت الشهادة وبدء تشغيل التطبيق. لا يثبت أي من هذه الأمور بشكل مستقل أن المثبت الموقع يعمل على كل جهاز مدعوم أو أن مسار الأدوات آمن لجهاز معين.

1. سجل وقت التشغيل الدقيق ودليل البيانات المستخدم في الفحص.
2. قم بإجراء العملية عبر الحدود التي سيستخدمها المستخدم.
3. افحص الحالة المستمرة الناتجة أو القطعة الأثرية المصدرة، وليس فقط نخب النجاح.
4. ممارسة مسار الفشل أو الإلغاء المتأثر بالتغيير.
5. قم بالإبلاغ عن أي خدمة خارجية أو توقيع أو جهاز أصلي أو تغطية رسومات لا تزال مفقودة.

بالنسبة لأعمال التكامل الحتمية، استخدم دلائل SQLite المعزولة وتركيبات الذكاء الاصطناعي المكتوبة/غير المتصلة بالإنترنت. بالنسبة للسلوك الخاص بالموفر، قم بتدريب الموفر الذي تم تكوينه باستخدام بيانات الاعتماد المناسبة بشكل منفصل. تصف طلبات الأمثلة في هذه الأدلة الأشكال المدعومة؛ تختلف الطوابع الزمنية والمعرفات والمنافذ وبيانات الاعتماد لكل عملية تشغيل.

أدلة عملية

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

تصميم وتصنيع

العملاء والإضافات

العمليات والانتعاش

هل أنت جديد في البناء المنشور؟ ابدأ في ثَبَّتَ. جديد في الخروج؟ ابدأ بـ بداية سريعة. هل أنت جديد في سلوك HTTP؟ استخدم تجول مع الاستجابات التي تم التقاطها، ثم اختر عميلاً مكتوبًا أو موردًا في الملف مرجع API الكامل.

العمل من خلال مهمة كاملة

إنشاء تصميم محفوظ

قم بإنشاء مشروع واحتفظ بالمعرف الذي تم إرجاعه. قم بإنشاء الرسم أو المكون الخاص به من خلال المجموعة المناسبة على مستوى المشروع. قم بتحرير الشكل الهندسي في مساحة عمل CAD، واحفظ من خلال إجراء الميزة الفعلية لهذا المورد، وأعد فتح المورد المحفوظ للتأكد من استمرار المستند المقصود. إن التحديد الحالي للمحرر وسجل الأوامر ليس بديلاً عن الرسم المخزن.

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

إنتاج نتيجة التصنيع

التقط الشكل الهندسي والموضع والمخزون والمواد والآلات والأدوات وترتيب التشغيل. قم بتشغيل التوليد بهذه المدخلات الصريحة. فحص مسائل النتيجة والأدلة القابلة للتطبيق؛ تحقق من أن البرنامج وNC تتوافق مع اللقطة المقصودة. يعد الحفظ عملية منفصلة ويجب الاحتفاظ بمستند محمول يتوافق مع وحدات البايت المحددة التي يتم حفظها.

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

دمج مساعد

قم بتكوين موفر على سطح المكتب وتحقق من حالته قبل بدء المحادثة. الحفاظ على هوية المشروع والجلسة، واستهلاك الأحداث بشكل متزايد، وتنفيذ الأذونات وردود الأسئلة من خلال عناصر التحكم في الجلسة المقبولة. عند قطع الاتصال، قم باستعادة الحالة الحالية قبل إعادة إرسال الطلب الذي ربما يكون قد قام بتحرير المشروع.

ال دليل التدفق يغطي الاسترداد والإلغاء ومتابعة القبول. ال دليل العميل يشرح لماذا لا يمكن التعامل مع قيم نتائج الوعد، وأجسام HTTP التي تم طرحها، وأخطاء التأثير، وإكمال الدفق كمغلف عالمي واحد.

تسجيل ومراجعة التغيير

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

تعريفات سير عمل الإصدار مع المشروع، ثم فحص الالتزام المحدد لكل عملية تشغيل ومخرجات الفحص الفردية. إن التشغيل الناجح الذي تخطى فحوصات التشغيل الآلي لا يوفر أدلة تشغيلية. اقرأ الفروع ودليل سير العمل قبل أتمتة خطوة الكتابة أو تكوين مرآة عن بعد.

تشغيل العميل الثاني

قم بتمكين البوابة المصاحبة عن عمد، وقم بإنشاء اقتران جهاز مسمى بشكل فردي، وقم بتوصيل البنية الأصلية التي تتضمن تثبيت الشهادة. احتفظ بعنوان سطح المكتب الكامل وبصمة الإصبع والرمز المميز للجهاز باعتباره الاتصال المقترن. اقرأ سياسة المسار الحالية قبل افتراض أن الهاتف للقراءة فقط أو غير مقيد.

عند انتهاء الوصول، قم بإلغاء الجهاز من سطح المكتب؛ لا تؤدي إزالة الاتصال على الهاتف وحده إلى إلغاء الرمز المميز من جانب الخادم. ال دليل الاقتران يفصل تشخيص الشبكة، وتوافر النقل الأصلي، وهوية الشهادة، وإلغاء الرمز المميز.

أدلة حسب المهمة والوقت

في 3د