デスクトップUI

アプリケーションアーキテクチャ

デスクトップ アプリケーションは、SolidJS Webview、Vite、Three.js、Tauri v2 Rust シェルを組み合わせています。 Web ビューは、画面と対話状態を所有します。 Bun サイドカーは、API ハンドラー、データベース アクセス、AI セッション、およびプロジェクト サービスを所有します。 Rust プロセスは、ウィンドウ、メニュー、トレイ、オペレーティング システム ダイアログ、キーチェーン アクセス、アップデート、サイドカー ライフサイクルを所有します。

apps/desktop/src/main.tsx アプリケーションをマウントします。 app/App.tsx aPI 接続を確立し、共有状態を提供します。 app/routes.tsx uRL を遅延ページ モジュールにマップします。機能画面が存在します features/。ルートの存在によって外部サービスの可用性が確立されるわけではありません。請求には Stripe 構成が必要で、AI には構成されたプロバイダーが必要です。

起動と接続の回復

1. シェルは、生成された起動トークン、アプリケーション データ、および移行ディレクトリを使用して、バンドルされたサイドカーを開始します。
2. サイドカーは一時的なポートをバインドします。 127.0.0.1、ヘルスルートが応答するのを待ち、JSONを書き込みます ready ポートを含むイベント。
3. WebView が呼び出すのは、 get_sidecar_endpoint aPI クライアントとマネージド エフェクト ランタイムを作成します。
4. 正常性リクエストが成功すると、アプリケーション状態が作成され、ルーターとシェルがマウントされます。

Web ビューでは、接続の回復に 150 秒かかります。試行ごとのタイムアウトは 30 秒、再試行の一時停止は 750 ミリ秒です。試行が失敗すると、キャッシュされたエンドポイントが破棄され、再起動されたサイドカーが新しいポートを提供できるようになります。 Rust スーパーバイザは、準備完了のハンドシェイクごとに 60 秒待機し、1 回の自動再起動を許可します。 Webview 接続の予算が期限切れになると、再試行が可能になります。

スクリーンルート

使用 app/routes.tsx 正確なパラメータ名については、 pages/ uRL にマウントされている画面を見つけます。ルート アダプターは意図的に小さくなっています。空のビューまたは失敗したアクションを診断するときに、画面とその API 呼び出しを読み取ります。

ソース組織

• app/: スタートアップ、ルーター、グローバル API クライアント、ネイティブ統合、シェル、キーボード ショートカット。
• pages/: ルート アダプタのインポートまたは再エクスポート画面。
• features/: 画面、コンポーネント、フック、状態、およびドメイン固有のヘルパーを含む製品領域。
• shared/: 再利用可能なコントロール、シェル コンポーネント、アプリケーションの状態、クエリ キャッシュ、およびコマンド履歴。
• viewport/: キャンバス描画、スナップ、ツール ジェスチャ、Three.js レンダリング、メッシュ作成、および再生。
• i18n/, styles/、 そして testing/: 翻訳、グローバル スタイル、テスト フィクスチャ。

デスクトップは以下に依存します @cadcamfun/api hTTP コントラクトおよびそれ以降の場合 @cadcamfun/core ジオメトリおよび CAM 操作用。データベースの永続性はサイドカー API の背後に残ります。ローカル エディタの履歴は、永続化された図面やツールパスのバージョン、およびプロジェクトのバージョン管理とは異なります。

ネイティブシェル

デフォルトでは、本番ウィンドウは 1440 × 900 で、最小値は 960 × 600 です。 Tauri はフロントエンドを次からステージングします。 apps/desktop/dist、ターゲット固有のサイドカー src-tauri/binaries、リソースとして移行を生成しました。登録します .cadcam, .nc、 そして .gcode ファイルの関連付け。サポートされているファイルを開くか、2 番目のインスタンスを起動すると、ファイル パスが既存のウィンドウに転送されます。

src-tauri/src/sidecar.rs 子プロセスを監視します。アプリを閉じると、 {"event":"shutdown"} 子の標準入力にラインを送信し、それを取得する前に少し待機します。子は stdin クロージャも観察します。起動トークンは 32 個のランダム バイトで、64 文字として 16 進エンコードされ、認証情報が含まれる可能性のあるサイドカー ログ行は編集されます。ログは、レディ/エラー ハンドシェイクを伝送する標準出力とは別のものです。ネイティブ シークレットには次の方法でアクセスします。 src-tauri/src/secrets.rs オペレーティング システムのキーチェーンを使用します。

macOS では、シェルは Liquid Glass プラグインを登録します。 Web ビューはガラスの設定に従い、効果が利用できない場合は元に戻ります。 App Store の設定ではプライベート API オプションが無効になっています。通常の設定ではそれが有効になります。これらは別のビルド構成です。

セキュリティと永続性の境界

運用コンテンツ ポリシーでは、ローカル アセット、ループバック API 接続、データ/BLOB イメージ、および WebAssembly 評価が許可されます。任意のリモート スクリプトの実行は許可されません。ネイティブ権限の範囲は次のとおりです。 src-tauri/capabilities;開発ポリシーでは、Vite とその WebSocket もさらに許可されています。

open_path パスを正規化し、許可されたユーザー/アプリケーション ディレクトリに制限し、次のような実行可能拡張子を拒否します。 .exe, .app, .sh, .bat, .msi、 そして .jar. .. セグメントとシンボリックリンクは両方とも正規化されているため、許可されたフォルダーからエスケープできません。ファイルの選択と保存には、ネイティブのダイアログと検証が使用されます。起動トークンにより、ローカル アプリケーション API へのアクセスが許可されます。コンパニオン トークンまたはプロジェクト スコープの AI ブリッジ トークンとは別に扱います。

UI 設定、API クエリ状態、エディター コマンド、保存されたプロジェクト バージョン、およびネイティブ シークレットには異なる所有者がいます。すべてのアプリケーションの状態が SQLite に保存されていると仮定するのではなく、実際のサービスを通じてそれぞれを診断します。

機能の統合

CAD および CAM 機能モジュールは、独自のパネル、ストア、保存フローを備えた再利用可能なビューポート コンポーネントを構成します。アシスタント パネルはプロジェクトとエディターのコンテキストを受け取り、AI 機能の状態を通じてツール イベントをストリーミングします。リソース画面は、データベースに直接アクセスするのではなく、API クライアントを使用します。

UI を変更する場合は、ルート アダプターに従ってその機能画面に移動し、要求を送信する機能ストアまたはフックを検査します。既存のコントラクトがインタラクションと一致する場合にのみ、共有コンポーネントを再利用します。純粋なジオメトリをコア パッケージに保持し、ネイティブ オペレーティング システムの動作を Rust シェルに保持します。

ルートの読み込みとエラー

各ルートは Solid の遅延インポート境界を使用します。この表には、すべてを網羅したページが含まれています。 /500, /offline、および合法的なルート。クライアント ルーターが URL を解決できるように、ブラウザの直接ナビゲーションは Vite 開発サーバーまたはパッケージ化された Web ビューを通じて提供される必要があります。

プレビュー API は、限られたコレクションのセットを実装し、テストにリクエストの失敗を意図的に挿入できます。プレビュー レンダリングが成功すると、それらのフィクスチャに対する UI の動作が実証されます。永続性、権限、ストリーミング、ライブ サイドカーとの外部統合を検証します。

ネイティブコマンドインターフェース

ネイティブイベント

貝殻が発する sidecar-status ライフサイクルの変化に合わせて、 open-file サポートされているパスでは、 menu メニュー選択用、および update://status アップデーターの進捗状況について。トレイの最近のプロジェクトの選択は次のように表されます。 tray.recent.<projectId> メニュー識別子。シェルのメニューおよびトレイ モジュールは、完全な識別子セットを定義します。

リスナーはコンポーネントまたはアプリケーションのライフサイクルにスコープを設定し、クリーンアップ時に削除する必要があります。 WebView は、サイドカーの再起動後に、以前のポートを使用し続けるのではなく、エンドポイントを再解決する必要があります。

開発と検証

bun run --filter @cadcamfun/desktop dev
bun run desktop:dev
bun run --filter @cadcamfun/desktop typecheck
bun test apps/desktop/src
bun run build:desktop

最初のコマンドはブラウザーのプレビューを実行します。 desktop:dev tauri を開始する前に、実際のサイドカーをコンパイルし、移行を段階的に実行します。デスクトップパッケージの tauri:dev 代わりに、スクリプトはバイナリが存在しない場合にのみスタブ バイナリを作成します。これを分離シェル作業に使用し、API 応答を解釈する前にどのバイナリが存在するかを確認します。

デスクトップ build スクリプトの実行 vite build のみ;サイドカーのコンパイルや Tauri バンドルのパッケージ化は行いません。使用 bun scripts/build.ts 完全なリリース パイプラインについては (「 リリース).

環境設定と設定

共有設定ストアには、検証されたレコードが保存されます。 cadcamfun.settings webView ローカル ストレージ内。欠落しているフィールド、無効なフィールド、または読み取り不可能なフィールドは、個別にフォールバックします。ストレージ領域がいっぱいまたはブロックされても編集は停止しませんが、環境設定の変更は保持されない可能性があります。ブラウザのプレビュー設定はブラウザのオリジンに属し、ネイティブの Web ビュー設定とは別のものです。

「設定」画面には、「プロファイル」、「アカウント」、「セキュリティ」、「サブスクリプション」、「通知」、「AI」、「デバイス」、および「言語」タブがあります。 [デバイス] タブには、コンパニオン ゲートウェイ パネルが組み込まれています。言語設定にはガラスの切り替えが含まれます。現在、共通ロケール ストアはデフォルト ロケールを検証しています。表示ラベルのリストから追加の翻訳対象範囲を推測しないでください。

CAM プログラムを保存して再度開く

1. CAM で NC コードを生成またはロードし、既存のエントリ ポイントから保存/エクスポート ダイアログを開きます。
2. ファイルのエクスポートの場合は、G コードまたはポータブル ツールパス形式を選択します。 G コードは現在の NC テキストをダウンロードします。ツールパスの選択により、構造化された .cam.json スナップショット。
3. アプリケーションを永続化するには、既存のプロジェクト、新しいプロジェクトを選択するか、すでに保存されているプログラムを更新します。プログラム名と必要な宛先フィールドを入力します。
4. 更新する場合、保存フローは、現在のデータを置き換える前に、以前の完全なプログラムをツールパス バージョンとして記録します。
5. 保存されたアイテムをそのツールパス詳細ルートで開き、バージョンを検査または復元します。

保存サマリには、証拠が現在の NC に属している場合、NC ライン、バイト、移動、工具識別子、操作名、ストック、単位、ワーク オフセット、および検証 ID が含まれます。 NC テキストが変更されると、以前に計算された証拠が陳腐化する可能性があります。概要に頼る前に、現在のコードと証拠の関係を確認してください。

新しいプロジェクトの作成は成功したが、その後の保存ステップが失敗した場合、モーダルは再試行のために作成された宛先を保持し、その識別子をエラーに含めます。そのモーダル内で再試行すると、同じプロジェクトを再度作成することが回避されます。保存フローが 1 つのアトミックなリソース間トランザクションであると想定しないでください。

キーボードと故障診断

Cmd/Ctrl+K コマンドパレットを開き、 Cmd/Ctrl+J アシスタントパネルを切り替えます。フォーカスが入力、テキストエリア、選択、またはコンテンツ編集可能な要素にある場合、シェル ショートカットは無視されます。エディター キャンバスには独自のキーボード処理があります。汎用ショートカット テーブルの保存/エクスポートを含むいくつかのシェル コマンド コールバックはプレースホルダーです。リストされているすべてのアクセラレータがドキュメント操作を実行すると仮定するのではなく、機能の実際の保存/エクスポート コントロールを使用してください。

実装アンカー: shared/state/settings.ts, app/shortcuts.ts, features/settings/screens/settings.tsx、 そして features/cam/components/SaveCamModal.tsx.

ネイティブ イベント ペイロード

import { invoke } from "@tauri-apps/api/core"
import { listen } from "@tauri-apps/api/event"

const { baseUrl, token } = await invoke<{ baseUrl: string; token: string }>("get_sidecar_endpoint")

const path = await invoke<string | null>("pick_file", {
  filters: [{ name: "G-code", extensions: ["nc", "gcode"] }],
})                                    // null when the user cancels

await invoke("save_file", { defaultName: "part.nc", contents: gcodeText })

const unlisten = await listen<{ state: string; port?: number }>("sidecar-status", (e) => {
  if (e.payload.state === "ready") reconnect()
})
// later: unlisten()

try {
  await invoke("install_update", { unsavedWork: editorIsDirty })
} catch (error) {
  // { kind, message }: the update variant carries the refusal (unsavedWork | noneAvailable | failed)
}

get_sidecar_endpoint 返品 { baseUrl, token } (からキャメルケースでシリアル化 SidecarEndpoint）。すべてのコマンドからのエラーは、拒否された値として到着します。 invoke、形をした { kind, message }.

キーボードショートカット

すべてのスクリーンルート

のルーター apps/desktop/src/app/routes.tsx 68 ルートを宣言し、それぞれがから遅延ロードされます apps/desktop/src/pages/ (動的セグメントは _id_.tsx ファイル)。最初のセグメントごとにグループ化:

3Dで