Foundry 外の既存プロジェクトをインポートする

ソースコードを ZIP ファイルとしてアップロードすると、Foundry 外で構築したアプリケーションをインポートできます。Pilot はコードを読み取り、ユーザーとともに移行計画を立て、React、Vite、およびオントロジー SDK (OSDK) を使用する Pilot アプリケーションとしてプロジェクトを再構築します。Django や Electron など、ほかのフレームワークで構築されたプロジェクトも、これらの技術を使用するように変換されます。Pilot は元のページ、フロー、ビジュアルデザインを維持し、データモデルをオントロジーに移行します。

移行後は、ほかの Pilot アプリケーションと同様に、アプリケーションを改良してデプロイできます。

ZIP ファイルを準備する

プロジェクトフォルダーを最大 10 MB の ZIP ファイルにします。ソースコード、アセット、および Pilot でモデル化したいデータベーススキーマやデータファイルを含めます。node_modules、.git、仮想環境、ビルド出力は除外します。

プロジェクトをインポートする

Pilot のウェルカム画面からプロジェクトをインポートするには、次の手順を実行します。

1. タイプの選択肢が表示される場合は、アプリケーションを作成するを選択します。

2. 次の例のような移行プロンプトを入力します。

   Copied!
   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   The attached ZIP file contains an app. Migrate this app to this Pilot app. Keep the same pages, flows, and visual design. Do not run the original app.
   
   1. Extract the ZIP file into /tmp and examine it. For data files, read only the schema and some rows.
   2. Ask me these questions:
      - Is the data real or sample data?
      - Which pages do you build first?
      - What replaces each integration that Pilot cannot run?
   3. Write a plan. Include the pages, a feature table, and the object types. In the feature table, give each feature one status: migrates, uses a Foundry equivalent, or not supported. End the plan with a "- [ ]" checklist.
   4. When I approve the plan, save it to docs/migration-plan.md.
   5. Copy the files that you need into the app. The extracted folder is temporary.
   6. When you complete a checklist item, mark it as done.
   
   Rules:
   - Foundry controls sign-in. Remove the auth code.
   - Do not copy secrets.
   - Use Foundry user IDs for users.
   - Change the data model to fit the Ontology. Use existing object types when possible.
   - Keep the assets, colors, and fonts of the original app.

3. コンテキストを追加するを選択し、ファイルを追加を選んで、ZIP ファイルを選択します。プロンプト入力欄にファイルをドロップすることもできます。

4. テーマで、元のデザインを維持するにはカスタムコンポーネントを、Foundry スタイルのインターフェースにするには Blueprint コンポーネントを選択します。

5. オントロジー項目の下にあるオントロジーの権限を確認します。Pilot がデータ用の新しいタイプを作成できるようにするには、オントロジーの権限を変更を選択し、Pilot による新しいオブジェクトタイプの作成を許可と Pilot による新しいアクションタイプの作成を許可をオンにして、保存を選択します。

6. アプリケーションを作成するを選択します。

計画を確認する

Pilot は最初のプロンプトを Act モードで実行し、ZIP ファイルを一時フォルダーに展開します。元のプロジェクトは実行しません。ユーザーに質問し、ページ、機能、オブジェクトタイプを列挙した移行計画を作成します。決済、メール、スケジュールされたジョブなど、サーバー側のコードやシークレットを必要とする機能は、Foundry の同等機能を使用するか、対応していないものとしてマークされます。

チャットパネルで質問に回答し、変更を依頼します。計画を承認すると、Pilot はそれを docs/migration-plan.md に保存し、チェックリストに沿って作業を進めます。Pilot がページを構築するたびに、プレビュータブが更新されます。

アップロードした ZIP ファイルは、セッションをまたいで保存されません。移行が停止した場合は、Continue the migration in docs/migration-plan.md と入力します。

データをオントロジーに移行する

Pilot は、データベーススキーマ、ORM モデル、JSON、CSV、SQLite ファイルなどから、スキーマと元のデータの数行を読み取ります。その後、各テーブルをそのままコピーするのではなく、オントロジーに合うようにデータモデルを変更します。

Pilot は可能な場合、既存のオブジェクトタイプを再利用し、オントロジーの権限で許可されている場合にのみ、新しいタイプを作成します。Pilot が特定のタイプを使用するようにするには、ウェルカム画面でコンテキストを追加するを選択し、オブジェクトタイプを追加するまたはアクションタイプを追加するを選択します。

プレビューでは、Pilot はシードデータで元のデータをできる限り忠実に再現しようとします。実データの場合は、代わりに同じ構造のシードデータを生成することもできます。シードデータはデプロイされません。本番環境でデータを使用するには、Pipeline Builder などを使って、別途 Foundry に取り込みます。