خريطة المصدر

CAD والرسم

تبدأ في packages/core/src/index.ts لرؤية صادرات مساحة الاسم. packages/core/src/cad/index.ts يسرد واجهات برمجة تطبيقات CAD؛ packages/core/src/drawing/index.ts قوائم عمليات الرسم.

• cad/sketch.ts, sketch-shapes.ts, snap.ts, intersect.ts: رسم البيانات والأشكال والالتقاط والتقاطع.
• cad/history.ts, history-edit.ts, history-brep.ts: سجل الميزات، والتعديلات، وإعادة بناء B-rep.
• cad/brep/, solid.ts, tessellate.ts: الطوبولوجيا الصلبة، والنمذجة، والشبكات القابلة للعرض.
• cad/import-step.ts, dxf.ts، و import-drawing.ts: حدود التبادل والاستيراد.
• cad/scene-analysis.ts, scene-evidence.ts, dfm.ts: تحليل المشهد، والأدلة، والتحقق من قابلية التصنيع.

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

CAM وG-كود

• packages/core/src/cam/index.ts: مساحات أسماء CAM العامة والصادرات.
• cam/operations/ و cam/generator/: تطبيقات التشغيل وخط أنابيب التوليد.
• cam/setup.ts, indexing.ts, ir.ts: إطارات الإعداد، والآلات المفهرسة، وتمثيل الحركة المتوسطة.
• cam/post/index.ts, emitter.tsوملفات اللهجات: المشاركات المسجلة وانبعاث البرامج المشتركة.
• cam/post/convert.ts: نواة التحويل NC: يعيد تشغيل G-code أو Klartext، ويعيد كتابته مع أي مشاركة ويثبت الحركة عن طريق إعادة التشغيل.
• cam/verify/, kernel/, model/، و viewer/: التحقق، وتصنيع النوى، والنماذج، ومساعدي المشاهد.

استمر تتبع التصنيع من خلال apps/sidecar/src/http/toolpaths.ts و src/services/cam-program.ts، ثم إلى ميزة CAM لسطح المكتب. ال مرجع الاعدادات يشرح كيفية ارتباط مستندات البرامج المحمولة بمسارات الأدوات المحفوظة.

HTTP والمثابرة

• packages/api/src/index.ts, groups/, errors.ts, auth.ts: عقود نقطة النهاية، والأخطاء السلكية، وإعلانات الترخيص.
• packages/api/src/client.ts: عميل Effect كامل قائم على العقد مع برمجيات وسيطة لحاملها.
• packages/api/scripts/generate-clients.ts: المخرجات المستهدفة واستثناءات التوليد الصريحة.
• packages/httpapi-codegen/src/index.ts: انعكاس العقد، والتحقق من صحته، وبواعث العميل.
• apps/sidecar/src/main.ts, config.ts, layers.ts: دورة حياة الخادم، والتكوين، وأسلاك التبعية.
• apps/sidecar/src/http/, services/, repos/: محولات البروتوكول وعمليات التطبيق والوصول المستمر.
• packages/db/src/index.ts, schema.ts, upgrade.ts, migrate.ts: خدمة قاعدة البيانات، والجداول، وترقية السلامة، وCLI.
• packages/db/drizzle/: عمليات الترحيل والبيانات التعريفية التي تم إنشاؤها والتي يتم شحنها مع سطح المكتب.

سطح المكتب والجوال

apps/desktop/src/app/App.tsx, Shell.tsx، و routes.tsx تجميع طاولة العمل والطرق. client.ts و sidecar.ts التعامل مع الوصول إلى واجهة برمجة التطبيقات (API) وحالة الاتصال الأصلية. سلوك المنتج يعيش تحت src/features; الضوابط المشتركة والدولة تعيش في ظلها src/shared.

إطار العرض تحت apps/desktop/src/viewport، مقسمة إلى editor2d, view3d، و spatial. الأوامر الأصلية ودورة الحياة موجودة تحت apps/desktop/src-tauri/src; تكوين التعبئة والتغليف هو src-tauri/tauri.conf.json.

طرق المحمول تحت apps/mobile/app، مكونات قابلة لإعادة الاستخدام تحت componentsومنطق العميل/الاقتران ضمن lib. وحدة المقبس الأصلية هي modules/companion-net. على الخادم، ابدأ تتبع المرافق في apps/sidecar/src/http/companion.ts و services/companion.ts.

الذكاء الاصطناعي والمكونات الإضافية والتاريخ وسير العمل

• packages/ai/src/actions و tools: إعلانات العمل وتكامل الأدوات المساعدة.
• packages/ai/src/nikcli, prompts، و skills: تكامل المضيف المضمن والتوجيه المساعد.
• apps/sidecar/src/services/ai.ts: تبعيات الذكاء الاصطناعي الحية واختيار المضيف.
• packages/nikcli-plugin/src/index.ts: جسر HTTP nikcli الخارجي.
• packages/plugin-sdk/src/index.ts و apps/sidecar/src/plugins/host.ts: سطح تأليف البرنامج المساعد ومضيف وقت التشغيل.
• packages/vcs/src/index.ts, apps/sidecar/src/services/project-vcs.ts، و repos/project-vcs-repo.ts: مكتبة التاريخ، والتنسيق، والمثابرة.
• packages/workflow/src/index.ts, apps/sidecar/src/services/workflow-runner.ts، و workflow-service-steps-live.ts: عقد سير العمل، التنفيذ، وتسجيل خطوة الخدمة.

التحكم في الإصدار يعيش في packages/vcs/src: object.ts (تنسيق كائن git)، repository.ts (المراجع والالتزامات) ، snapshot.ts, diff.ts, store.ts, transport.ts، و github.ts. سير العمل يعيش في packages/workflow/src: schema.ts, trigger.ts (مطابقة الكرة الأرضية والمشغل) و run.ts. تتم قراءة ملفات سير العمل من .cadcamfun/workflows/ في شجرة المشروع

التوثيق والتسليم

packages/web/src/pages/docs يحتوي على مقالات التوثيق. src/layouts/DocsLayout.astro يوفر غلاف المقالة المشتركة. نسخة الملاحة والاسترجاع موجودة src/data/docsSidebar.ts و docsIndex.ts; أوصاف الحزمة المشتركة موجودة architecture.ts.

src/lib/docsMarkdown.ts يحول المقالات المقدمة إلى Markdown لـ src/pages/llm.ts ومساعد التوثيق. الاسترجاع موجود docsRetrieval.ts; التنفيذ المساعد موجود src/pages/api/docs-assistant.ts. يوجد مساعدين لتحليل وتخزين القطع الأثرية src/lib/docsArtifact.ts.

packages/web/script/dev.ts يبدأ Astro وعملية الاستوديو المحلي. studio-server.ts تمتلك واجهة برمجة التطبيقات المحلية نظرة عامة على SQLite. astro.config.mjs تكوين البنية الأساسية للعرض المسبق والوكيل المحلي؛ wrangler.toml يعلن الارتباطات العمالية.

يبدأ تجميع سطح المكتب والإصدار المرحلي في scripts/build.ts. سير عمل CI والإصدار قيد التنفيذ .github/workflows. يرى الإصدار والتحديثات لإنشاء القطع الأثرية ومتطلبات التوقيع.

تتبع السلوك عبر الحدود

1. تحديد نقطة النهاية في مرجع الموارد وقراءة المعلمة والنص والاستجابة ومخططات الخطأ.
2. حدد موقع إعلان HttpApi الخاص به في تكوين جذر API. بعض الموارد التأسيسية، بما في ذلك المشاريع، تعيش مباشرة تحت packages/api/src; مجموعات أخرى تعيش تحت src/groups.
3. ابحث عن معالجه تحت apps/sidecar/src/http. اقرأ عمليات فحص المستخدم والموارد الحالية قبل متابعة استدعاء الخدمة أو المستودع الخاص بها.
4. للحساب، تابع إلى القلب. للتخزين، تابع عبر المستودع و Database.query. بالنسبة لسلوك الموفر/الشبكة، قم بفحص المحول الذي تم تكوينه.
5. ارجع إلى المتصل على سطح المكتب أو الهاتف المحمول وافحص معالجة المظروف وحالة الجلسة والإلغاء وعرض الأخطاء.

على سبيل المثال، يتم رفض الاسم المفقود في إنشاء المشروع apps/sidecar/src/http/projects.ts; إنه ليس خطأ SQLite. يتم التحقق من عدم تطابق مستند CAM المحمول عن طريق apps/sidecar/src/services/cam-program.ts; لا يمكن لتحليل NC في إطار العرض تجاوزه. ينشأ رفض مسار الهاتف المقترن من سياسة الأسلوب/المسار الخاصة بالبوابة المصاحبة.

شجرة الدليل مع عدد الملفات

apps/
  desktop/src/          app/ 13  features/ 280  pages/ 68  shared/ 44  viewport/ 25  i18n/ 1
  desktop/src-tauri/src commands.rs lib.rs main.rs menu.rs secrets.rs sidecar.rs tray.rs updater.rs
  sidecar/src/          http/ 34  repos/ 24  services/ 29  plugins/ 3   (+ main.ts, config.ts, layers.ts)
  mobile/               app/ 13  components/ 30  lib/ 21  hooks/ 2  modules/ 2
packages/
  core/src/             cad/ 80  cam/ 110  drawing/ 7
  ai/src/               actions/ 14  nikcli/ 27  tools/ 26  prompts/ 5  skills/ 2
  api/src/              groups/ (one file per group)  sdk/generated/  client/generated/
  db/                   src/ (index, schema, upgrade, migrate)  drizzle/ (4 migrations)
  vcs/ workflow/ plugin-sdk/ httpapi-codegen/ nikcli-plugin/ web/
scripts/                build.ts compile-sidecar.ts stage-release.ts updater-manifest.ts
                        release-helpers.ts release-ref.ts signing-config.ts smoke-sidecar.ts
.github/workflows/      ci.yml release.yml build-platforms.yml ios.yml

مجلدات ميزات سطح المكتب

كل مجلد تحت apps/desktop/src/features/ تمتلك مكونات منطقة منتج واحدة ومكالمات الحالة وواجهة برمجة التطبيقات:

admin  ai  analytics  auth  billing  cad  cam  chat  companion  costs  dashboard
legal  library  marketplace  mcp  organizations  plugins  profile  projects  settings  toolpaths

تقوم إحدى الميزات باستدعاء السايدكار من خلال عميل API المشترك؛ الحاجيات المشتركة تعيش في shared/ والمشهد 3D في viewport/.

حيث تعيش مفاهيم CAD في جوهرها

في 3د