概要

製品

デスクトップは、SolidJS ワークベンチと Tauri シェルを組み合わせています。ワークベンチは、図面とモデルを編集し、Three.js ビューポートでジオメトリを表示し、機械加工操作を管理し、G コードをプレビューまたはエクスポートします。プロジェクト データ、ツール、マテリアル、マシン構成、アシスタントの状態は Bun サイドカーによって管理され、ローカルに保存されます。

計算カーネルはデスクトップとサイドカーの間で共有されます。インタラクティブなジオメトリは、HTTP ラウンド トリップなしで Web ビューで実行できます。永続的な操作、プロバイダー呼び出し、プロジェクト履歴、およびワークフローの実行はサイドカー サービスを経由します。ローカル ストレージには、ホストされているアプリケーション アカウントは必要ありません。 AI プロバイダー、GitHub の運用、支払い、ソフトウェアの更新は、構成されたネットワーク サービスを使用します。

設計から加工まで

1. プロジェクトを作成するか開いて、その図面、エンティティ、またはソリッド シーンを準備します。の CADリファレンス スケッチ、B-rep ジオメトリ、テッセレーション、および交換フォーマットについて説明します。
2. 操作、ツール、材料、機械構成を選択します。ツールパスを生成するには、 CAMサービス そしてビューポートで結果を調べます。
3. 使用 加工セットアップ およびプログラムドキュメントを使用して、操作順序、作業フレーム、およびプログラム設定を保持します。目的のコントローラーの登録済みポストを選択します。
4. エクスポートする前に、生成されたプログラムと検証結果を確認してください。ジオメトリ カーネル、ポスト レジストリ、高度な G コード変換、およびマシン構成は、このプロセスの別個の部分です。
5. プロジェクトのスナップショットを記録する 歴史、または登録された ワークフロー 検証と処理を繰り返すため。

の アシスタント アプリで使用されるのと同じサービス アダプターを介してアプリケーション アクションを呼び出します。の モバイルコンパニオン ペアリングされたデスクトップに接続します。電話機上で 2 番目の CAD/CAM バックエンドは実行されません。

ランタイムコンポーネント

apps/desktop

SolidJS ワークベンチ、ルート アダプター、機能モジュール、ビューポート、ネイティブ Tauri シェル。

apps/sidecar

認証された HTTP ハンドラー、リポジトリ、エフェクト サービス、ローカル ID、AI 統合、コンパニオン ゲートウェイ、データベース ライフサイクル。

apps/mobile

ネイティブ ペアリング トランスポート、プロジェクトおよび履歴ビュー、アシスタント アクセスを備えた Expo コンパニオン。

packages/web

この Astro ドキュメント サイト、Markdown エクスポート、ドキュメント アシスタント、生成されたガイド ページ、およびローカル Studio。

の ワークスペースリファレンス すべてのライブラリ、そのパブリック エントリ ポイント、およびその利用者について説明します。の ソースマップ 一般的な変更の実装ファイルを指します。

開発を開始する

bun install
bun run desktop:dev

# Documentation and local Studio
bun run --filter @cadcamfun/web dev

デスクトップ コマンドは、Tauri を起動する前にサイドカーをコンパイルし、移行リソースをコピーします。 Rust とプラットフォーム Webview ビルドの前提条件がインストールされている必要があります。ローカル Studio API を起動せずにドキュメント サーバーを実行するには、次を使用します。 bun run --filter @cadcamfun/web start.

フォローする クイックスタート 前提条件と初回起動の場合、または 地域発展 分離されたサイドカーおよびクライアント ループ用。

契約と永続性

packages/api/src/index.ts スキーマファーストの HTTP コントラクトを構成します。サイドカーの ServedApi サービスを提供するグループを選択し、OpenAPI ドキュメントを公開します。 /api/openapi.json。シェルは、準備イベントから動的に割り当てられたループバック ポートを検出し、WebView にエンドポイントとベアラー トークンを与えます。

サイドカーデータベースは cadcamfun.db 設定されたデータディレクトリの下にあります。データベース層は外部キーと WAL を有効にし、構成された移行を適用し、保留中のアップグレードの前に既存のファイルをバックアップします。 Documentation Studio には独自のデータベース パスの選択があります。実行中のサイドカーのファイルは自動的に検出されません。

これらのページでは、このリポジトリでの実装について説明します。パッケージのエクスポート、HTTP エンドポイント、デスクトップ コントロール、およびリリースされたインストーラーは、異なる統合面です。サポートされている動作と制限については、関連するリファレンスを参照してください。

作業パスを選択してください

プロジェクトの保存、リソースのバージョン、プロジェクト全体のコミット、リモート同期、および生成されたガイド アーティファクトは別の操作です。ツールパスを保存しても自動的にはコミットされず、GitHub プッシュが成功しても加工出力は検証されません。

初めての API 統合の場合は、次の手順に従います。 リクエストのウォークスルー。ここには、公衆衛生プローブ、保護された呼び出し、プロジェクトの作成、およびキャプチャされたハンドラー応答を含む設定ストレージが表示されます。

運用文書

の ガイドライブラリ 完了したタスクを順に見ていきます。から始める プロジェクトの作成と保存された作業、次に使用します ネイティブ製造 キャプチャしたデザインを生成し、プログラムを永続化します。どちらも、何が保存され、何が派生状態または保存されていない状態のままであるかを説明します。

統合作業の場合、 APIリソースリファレンス リクエストおよびレスポンスのスキーマを使用して、宣言されたすべての操作をカバーします。の クライアント統合ガイド promise と Effect の構築、認証、キャンセル、エラー処理について説明します。の ストリーミングガイド 会話の回復と対話型の許可/質問処理が追加されます。

運用・サポートについてはご相談ください ランタイム構成, デスクトップ診断、 そして コンパニオンペアリング。それぞれがネイティブ シェル、サイドカー、データベース、プロバイダー、電話ゲートウェイ、およびドキュメントの展開を区別できるようにするため、実際の境界で障害を調査できます。

拡張機能とチームワークには、次を使用します。 プラグインのオーサリング そして ブランチ、レビュー、ワークフロー。これらのガイドには、サポートされているモジュールのエクスポート、現在のホストの動作、構造マージ ルール、コミットされたワークフロー入力、およびサービスによる副作用について文書化されています。

数字で見るCADCAMFUN

新着情報

メイン ブランチでの最近の作業をコミット履歴から要約します。

• サイドカー上の正確なカーネル。 A cadExact グループ （analyze, step, assembly) は、ソリッドごとの有効性、質量、穴、干渉、部品表、および欠落している留め具などのコアから共有シーン分析を実行します。
• 正確なモデリング。 シェルのスイープとスイープ、合理的なルールの柱を使用したロフト、正確な面でのプッシュプルと嵌合、およびフィレットを約 2.5 倍高速に実行します。
• NCサブプログラム。 繰り返されるツールパスは増分として 1 回書き込まれます。 M98 サブプログラム;リプレイはわかります O-プログラム、 M98/M99 そして G91。スナップショットからデスクトップ スイッチまでのエンドツーエンドの有線接続。
• B担当者からのCAM。 プランナーは、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 リファレンスが含まれています。

次のステップ

3Dで