setup-sandbox

Sandbox のセットアップ

接続されたアカウントの組織とアーティストのフォルダー構造を作成します。

環境

• RECOUP_ACCOUNT_ID — データを取得するアカウント ID です。Org API Key を使用する場合にのみ必要です。Personal API Key を使用する場合は、--account フラグを省略してください。CLI は認証済みアカウントを自動的に使用します。

手順

1. RECOUP_ACCOUNT_ID が設定されているか確認します。設定されている場合は、以下のすべての CLI コマンドに --account $RECOUP_ACCOUNT_ID を指定します。設定されていない場合は、--account フラグを省略します。
2. すべての組織を取得するため、recoup orgs list --json [--account $RECOUP_ACCOUNT_ID] を実行します。
3. 各組織について、そのアーティストを取得するため、recoup artists list --org {organization_id} --json [--account $RECOUP_ACCOUNT_ID] を実行します。
4. フォルダー構造を作成し、各アーティストフォルダーに RECOUP.md マーカーを作成します。
   • CLI レスポンスの artistSlug をそのままディレクトリ名として使用します。UUID、ID、接尾辞を追加しないでください。
   • orgs/{org}/artists/{artist-slug}/ がすでに存在する場合は、スキップします。
   • 新しいアーティストごとに mkdir -p orgs/{org}/artists/{artist-slug} を実行します。
   • 以下のテンプレートを使用して RECOUP.md を作成します。
5. コミットしてプッシュします。
   • git add -A && git commit -m "setup: create org and artist folders" && git push origin main

RECOUP.md

すべてのアーティストディレクトリのルートには RECOUP.md があります。これはアイデンティティファイルで、ワークスペースを Recoupable プラットフォームに接続します。このファイルが存在することは、ワークスペースが有効であることを意味します。

CLI レスポンスのデータを入力します。

---
artistName: {Artist Name}
artistSlug: {artist-slug}
artistId: {uuid-from-recoupable}
---

フィールド：

• artistName — CLI の表示名（例：Gatsby Grace）
• artistSlug — 小文字とハイフンで構成されたフォルダー名（例：gatsby-grace）
• artistId — Recoup の UUID