life-sciences-fieldsalesrep-coordinate

Life Sciences Cloud エンドツーエンドオーケストレーター

Life Sciences Cloud のセットアップワークフロー全体を、厳密な順序で実行される 5 つのステージとして実行します。各ステージは、直前のステージが成功した場合にのみ進みます。各ステージは子スキルまたはリファレンスワークフローに処理を委譲し、内部でフェーズとステップに分けて構成されています（詳しくは以下の「実行順序」を参照してください）。

対象範囲の制限（最初に評価）

Life Sciences Cloud のセットアップ全体に関するリクエストのみに対応します。単独のステージ／フェーズ／ステップをここから実行することはできません。部分的な依頼を全体のワークフローに勝手に拡張することもありません。作業を始める前に、以下を確認してください。

• Life Sciences Cloud のセットアップに関係のないリクエスト（開始時または実行中）→ 実行しないでください。リクエストを理解できなかったことと、対応可能な内容（Life Sciences Cloud のエンドツーエンドセットアップ全体、または単独の life-sciences-prerequisites-validate／life-sciences-territory-configure）をユーザーに伝え、終了してください。
• 単独のスキルがあるステージ（前提条件のステージ 1、またはテリトリー設定のステージ 3）→ life-sciences-prerequisites-validate／life-sciences-territory-configure に案内し、終了してください。
• 単独のスキルがないステージ（設定のデプロイ（2）、ユーザーのプロビジョニング（4）、訪問の作成（5））→ これらは全体のワークフローの一部としてのみ実行され、単独では実行できないことを説明し、終了してください。その後ユーザーから依頼があった場合を除き、全体のワークフローを開始しないでください。

エンドツーエンドセットアップ全体を実行する場合にのみ続行してください。ゲートを設け、前提条件 → 設定のデプロイ → テリトリー → ユーザーのプロビジョニング → 訪問の作成の順に、全体のワークフローをオーケストレーションします。各ステージの実作業は、子スキル／リファレンスファイルに委譲されます。

---

必須入力

続行する前に、以下を取得してください。

• 対象 org：デプロイ先の org です。接続済み org の一覧からユーザーが選択するか、新たに認証した org を指定します（フェーズ 0 を参照）。デフォルトの org を黙って選択してはいけません。いずれかのステージを実行する前に、必ずユーザーに対象 org の確認または選択を求めてください。

---

実行順序（必須）

用語： ステージ＝作業単位 5 つ（1～5）のいずれか。各ステージは子スキルまたはリファレンスワークフローに委譲されます。フェーズ＝ステージ内の名前付き作業グループ。ステップ＝フェーズ内の個別アクション。したがって、「ステージ 2 › フェーズ 1 › ステップ 3」は上から下へ読みます。

以下の順に実行し、各段階で直前の段階の完了をゲートとします（依存関係の全体図は references/orchestration-flow.md を参照してください）。

#	ステージ	実行内容	ゲート（次に進むための条件）	出力
—	セットアップ：.lsc-starter-config/LSStarterConfig をダウンロード	—	フォルダーが存在すること（必須 — 満たさない場合は即時停止）	CWD 内の共有ソースフォルダー
1	前提条件の検証	life-sciences-prerequisites-validate スキル	すべての前提条件が PASS	org の準備完了を確認
2	スターター設定のデプロイ	references/stage-2-starter-config-overview.md	13 個すべてのデプロイ手順が成功	LSC Custom Profile が存在する
3	テリトリー設定	life-sciences-territory-configure スキル	テリトリーモデルが Active ＋ L3 テリトリー	レベル 3 テリトリー ID ＋ 名前
4	ユーザーのプロビジョニング	references/stage-4-user-provisioning-overview.md	ユーザーの作成、権限セットとテリトリーの割り当てが完了	担当者のユーザー名
5	サンプル訪問の作成	references/stage-5-visit-creation-overview.md	訪問と関連レコードの作成、およびメタデータキャッシュの生成が完了	—

---

ワークフロー

フェーズ 0 — 組織の選択（必須、最初に実行）

ワークフローを提示する前に、使用する組織を確認します。ユーザーが Life Sciences Cloud のセットアップを依頼するたびに必ず実行してください。現在のデフォルト組織を暗黙のうちに再利用してはいけません。

1. 接続済みの組織を一覧表示する：

   sf org list --json
   

   結果を解析し、認証済み（期限切れでない）組織を番号付きリストでユーザーに提示します。エイリアス、ユーザー名、組織タイプ（Dev Hub／Sandbox／Scratch／Production）およびデフォルトを示すマーカーがあれば、それも含めます。

   Connected Orgs — select the target for Life Sciences Cloud setup
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
     1. ls-dev        [email protected]          (Dev Hub)   [default]
     2. ls-sandbox    [email protected]  (Sandbox)
     3. partial-scr   [email protected]       (Scratch)
   
     N. Log in to a fresh org (opens a browser to authenticate a new org)
   

2. ユーザーに選択を依頼する：「使用する組織を選択してください。番号を入力するか、N を選択して新しい組織にログインしてください。」

3. 選択に対応する：

   • 既存の組織が選択された場合 → 後続のすべての手順で使用する対象組織として、そのユーザー名／エイリアスを取得します。

   • 新しい組織が選択された場合（オプション N） → 新しい組織を対話形式で認証します。ログイン URL（My Domain／インスタンス URL。例：https://mydomain.my.salesforce.com、本番環境では https://login.salesforce.com、Sandbox では https://test.salesforce.com）とエイリアス（例：ls-setup）を尋ねてから、自分でログインコマンドを実行します。

     sf org login web --instance-url <user-supplied-url> --alias <user-supplied-alias> --set-default
     

     コマンドをユーザーに渡して実行してもらうのではなく、直接実行してください。ユーザーが対話形式でウェブログインを完了できるよう、ユーザーのマシンでブラウザーが開きます。その後、コマンドの実行が完了します。完了したら、sf org list --json を再実行して新しい組織を確認し、それを対象組織として使用します。

4. 続行する前に、対象組織をユーザーに確認します：「Life Sciences Cloud のセットアップでは、（）を対象組織として使用します。」この値を OrchestrationState.targetOrg に保存します。

sf org list が認証済みの組織を返さない場合は、選択できる組織がないため、新しい組織へのログインフロー（オプション N）に直接進みます。

フェーズ 1 — はじめにと確認

1. ワークフローをユーザーに提示します。

   Life Sciences Cloud — Full Setup Workflow
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   
   This will execute 5 stages in sequence. Each stage is internally
   organized into phases and steps.
   
   Stage 1: Validate Prerequisites
            Checks org settings, permissions, and features
   
   Stage 2: Deploy Starter Configuration
            Deploys objects, profiles, config records, layouts, flexipages
   
   Stage 3: Configure Territories
            Creates territory type, model, and 3-level hierarchy
   
   Stage 4: Provision Field Sales Rep User
            Creates user, assigns profile/permsets, assigns to territory
   
   Stage 5: Create Sample Visit
            Logs in as the rep, creates account/provider/visit records,
            generates the mobile metadata cache
   
   Target org: <org>
   

2. 確認を求めます：「Life Sciences Cloud のセットアップ全体を開始する準備はできていますか？（yes/no）」

3. 共有ソースフォルダーを新たにダウンロードします（必須 — ハードゲート。いずれのステージよりも前に実施）。 ステージ 2（Starter Config のデプロイ — メタデータと設定レコード）とステージ 5（サンプル訪問の作成 — データ CSV）の両方が .lsc-starter-config/LSStarterConfig/ から読み込みます。これらのステージではダウンロードも削除も行いません。ここでオーケストレーターが新規ダウンロードを 1 回実行し、フェーズ 8 で 1 回だけ削除します。必ず再取得し、既存のフォルダーを再利用しないでください（古いコピーを使うと、古い CSV が使用されてステージ 5 の「現在の CSV のみを厳密に使用して作成する」というルールがひそかに無効になったり、新たに追加されたコンポーネントがスキップされたりするおそれがあります）。既存の .lsc-starter-config を削除してから、リポジトリが大きいため、そのサブツリーのみをスパースチェックアウトで CWD に新たに取得します。

   rm -rf .lsc-starter-config lsstarter-tmp
   git clone --no-checkout --depth 1 --filter=blob:none \
     https://github.com/SalesforceLabs/LSStarterConfig.git lsstarter-tmp
   cd lsstarter-tmp && git sparse-checkout init --cone \
     && git sparse-checkout set Codey/LSStarterConfig && git checkout && cd ..
   mv lsstarter-tmp/Codey ./.lsc-starter-config && rm -rf lsstarter-tmp
   

   .lsc-starter-config/LSStarterConfig/ には独自の sfdx-project.json が含まれています（sourceApiVersion: 65.0 を指定）。デプロイ手順（フェーズ 3）は、このフォルダー内から実行する必要があります。

4. ダウンロードゲート — 続行する前にフォルダーの存在を確認します。 .lsc-starter-config/LSStarterConfig/sfdx-project.json と .lsc-starter-config/LSStarterConfig/Data/ が存在することを確認して、ダウンロードが成功したか確認します（例：ls .lsc-starter-config/LSStarterConfig/sfdx-project.json .lsc-starter-config/LSStarterConfig/Data）。

   • 存在する場合 → OrchestrationState の sourceFolderDownloaded: true を設定して、フェーズ 2 に進みます。

   • ダウンロードに失敗した場合、またはフォルダー／内容が見つからない場合 → 停止します。いずれのステージにも進まないでください — すべてのステージがこのフォルダーに依存しています。失敗を報告して停止します。

     STOP: Setup cannot start — source download failed
     
     Could not download .lsc-starter-config/LSStarterConfig from
     https://github.com/SalesforceLabs/LSStarterConfig.git
     Likely: no network / GitHub unreachable, git < 2.25 (no sparse-checkout),
     or insufficient disk space / write permission in the CWD.
     
     Mandatory prerequisite — no stage can run without it. Fix the cause and
     re-run, or download the folder manually into the CWD, then re-run.
     

     sourceFolderDownloaded: false のままにして、ワークフローを先に進めないでください。

フェーズ 2 — ステージ 1 を実行：前提条件の検証

5. life-sciences-prerequisites-validate スキルのワークフローに厳密に従って、前提条件を検証します。

6. ゲートチェック：結果を確認します。

   • すべての前提条件を満たしている場合 → ステージ 2 に進みます
   • いずれかの前提条件を満たしていない場合 → 停止し、失敗レポートを提示します

   STOP: Stage 1 FAILED — Prerequisites not met
   
   <show the prerequisite failure table>
   
   Please resolve the failed prerequisites and re-run this workflow.
   

   ユーザーに尋ねます：「失敗した前提条件をスキップして続行しますか、それとも先に停止して修正しますか？」

   • ユーザーが停止を選択した場合 → ワークフローを終了します
   • ユーザーが続行を選択した場合 → 後続のステージが失敗する可能性があることを警告して続行します

フェーズ 3 — ステージ 2 を実行：Starter Config のデプロイ

7. references/stage-2-starter-config-overview.md に厳密に従って、Starter Config をデプロイします（13 個の手順をすべて順番どおりに実施）。指示に従って、独自の参照ファイルも読み込みます。

8. ゲートチェック：LSC カスタムプロファイルが存在することを確認します。

   sf data query --query "SELECT Id, Name FROM Profile WHERE Name = 'LSC Custom Profile'" --target-org <org> --json
   

   • プロファイルが存在する場合 → ステージ 3 に進みます
   • プロファイルが見つからない場合 → 停止し、デプロイの失敗を報告します

フェーズ 4 — ステージ 3 を実行：テリトリーの設定

9. life-sciences-territory-configure スキルのワークフローに厳密に従って、テリトリーを設定します。

10. ゲートチェック：テリトリーモデルが Active で、レベル 3 のテリトリーが存在することを確認します。

sf data query --query "SELECT Id, Name, DeveloperName, Territory2Model.State FROM Territory2 WHERE ParentTerritory2.ParentTerritory2Id != null AND Territory2Model.State = 'Active'" --target-org <org> --json

• Active モデルでレベル 3 のテリトリーが見つかった場合 → テリトリー ID と名前を取得して、ステージ 4 に進みます
• 見つからない場合 → 停止し、問題を報告します

フェーズ 5 — ステージ 4：ユーザーのプロビジョニングを実行する

11. references/stage-4-user-provisioning-overview.md に厳密に従ってユーザーのプロビジョニングを実行します。指示に従って、専用のリファレンスファイルを読みます。ステージ 3 で取得したテリトリー情報を渡します。

12. ゲートチェック：ユーザーが存在し、正しいプロファイルが設定され、4 つすべての権限セットとテリトリーの割り当てがあることを確認します。担当者のユーザー名を取得します。ステージ 5 ではこのユーザーとしてログインします。

    停止ゲート（ステージ 4 の完了確認）。「ユーザーを作成した」だけではこのゲートを通過したものとして扱わないでください。4 つすべての項目を確認し、どれか 1 つでも不足していれば停止します。

    sf data query --query "SELECT COUNT(Id) c FROM PermissionSetAssignment WHERE AssigneeId = '<newUserId>' AND PermissionSet.IsOwnedByProfile = false" --target-org <org> --json
    

    権限セットの数は必ず 4 でなければなりません（{LifeSciencesCore, LifeSciencesFieldSalesRepresentative, HealthCloudStarter, LifeSciencesKeyAccountManager}）。ユーザーは LSC Custom Profile に設定され、IsActive=true でなければなりません。また、レベル 3 のテリトリーに対する UserTerritory2Association が存在しなければなりません。権限セットの数が 4 未満の場合、または項目が 1 つでも欠けている場合、ステージ 4 は完全に完了していません。ステージ 5 に進む前に、references/stage-4-user-provisioning-overview.md の不足している手順を再実行してください（専用のフェーズ 4／5 停止ゲートで確認します）。権限セットが不足している担当者は、後続処理で訪問記録の作成に失敗し、原因の分かりにくい権限エラーが発生します。

フェーズ 6 — ステージ 5：サンプル訪問を作成する

13. references/stage-5-visit-creation-overview.md に厳密に従って訪問の作成を実行します。指示に従って、専用のリファレンスファイルを読みます。ステージ 4 で取得した担当者のユーザー名を渡します。このステージでは、次の処理を行います。

    • 担当者ユーザーとしてログインし（sf org login web）、取引先、医療従事者、訪問の各レコード（担当者が所有）と、テリトリーの関連付けおよび製品マスターデータ（管理者が所有）を作成します。
    • Connect API を使ってモバイルメタデータキャッシュを生成します（管理者が所有）。

    このステージでは2 つの IDを使用します。訪問レコードには担当者ユーザー（ステージ 4 で作成）、製品マスターデータとメタデータキャッシュの生成には管理者を使用します。子スキルの担当者／管理者の役割分担に厳密に従ってください。

14. ゲートチェック：少なくとも 1 件の訪問レコードが作成されたことを確認します。

    sf data query --query "SELECT Id, Name, AccountId FROM Visit ORDER BY CreatedDate DESC LIMIT 1" --target-org <org> --json
    

    • 訪問が存在する場合 → 最終サマリーに進みます
    • 訪問が見つからない場合 → 停止し、訪問の作成失敗を報告します

フェーズ 7 — 最終サマリー

15. ワークフロー全体のサマリーを表示します。最初に「Life Sciences Cloud Setup Complete」という見出しを表示し、その後に各ステージの内容を 1 ブロックずつ表示します（実行結果の値に置き換えます）。
    • ステージ 1：組織の前提条件をすべて確認済み。
    • ステージ 2：オブジェクト／プロファイル／設定レコードをデプロイ済み。レイアウト <N> 件とフレックスページ <N> 件をデプロイ済み。トリガーハンドラー 28 件を有効化済み。
    • ステージ 3：テリトリーモデル <model name>（有効）。レベル 3 のテリトリー <territory name>。
    • ステージ 4：ユーザー <firstName> <lastName>（<username>）。プロファイル LSC Custom Profile。権限セット Life Sciences Core、Life Sciences Field Sales Representative、Health Cloud Starter、Life Sciences Key Account Management。テリトリー <territory name>。管理者もテリトリーに割り当て済み。
    • ステージ 5：取引先と医療従事者を作成済み。訪問 <name>（テリトリー <territory name>）。製品の詳細説明／ディスカッションのレコードを作成済み。モバイルメタデータキャッシュを生成済み（Connect API）。

フェーズ 8 — クリーンアップ（共有ソースフォルダーを一度だけ削除）

16. 最終サマリーの後（5 つのステージがすべて完了した後）、作業ディレクトリをクリーンな状態にするため、フェーズ 1 でダウンロードした .lsc-starter-config フォルダーを削除します。CWD（.lsc-starter-config/ の親ディレクトリ）から実行します。

    rm -rf .lsc-starter-config
    

    何も表示せずに実行してください。クリーンアップの行を表示したり、最終出力でフォルダーの削除について言及したりしてはいけません。ワークフローが失敗で停止し、ユーザーが再開する可能性がある場合はスキップしてください。フローが完了するまでフォルダーを残しておき、再開したステージが読み取れるようにします。フロー全体で削除は一度だけ行います。子スキルが削除することはありません。

---

状態の追跡

オーケストレーション全体の状態を維持します。

OrchestrationState = {
  targetOrg: string,
  sourceFolderDownloaded: boolean,   // .lsc-starter-config/LSStarterConfig downloaded in Phase 1, deleted in Phase 8
  stages: [
    { name: "Prerequisites", status: "pending|running|passed|failed|skipped" },
    { name: "StarterConfig", status: "pending|running|passed|failed" },
    { name: "TerritorySetup", status: "pending|running|passed|failed", territoryId?: string, territoryName?: string },
    { name: "UserProvisioning", status: "pending|running|passed|failed", userId?: string, username?: string },
    { name: "VisitCreation", status: "pending|running|passed|failed", visitId?: string }
  ]
}

---

冪等なステージ遷移とフロー途中の変更

ステージは再入できません。ステージを実行する前に、OrchestrationState の status を確認してください。running の場合は「ステージ N はすでに進行中です」と返信し、何も実行しません。passed の場合は、再実行する前に明示的な確認を求めます。failed の場合は、再実行します（意図的な復旧）。pending の場合は、次に進みます。誤って二重に確認してもステージが二度実行されないよう、ユーザーの入力時ではなく、実行開始時にステータスを running に変更します。

後続のステージが進行中または保留中に、ユーザーが前のステージの入力の変更を求めた場合は、まず影響評価を行います。変更を適用せずに依頼を受け付け、影響を受けるステージと受けないステージを特定し、選択肢（影響を受けるステージを再実行する／以降にのみ適用する／キャンセルする）を提示して、判断を待ちます。破壊的な変更に関する警告を明示します（有効化済みのテリトリーモデルは削除できません。既存のユーザー／レコードは残ります）。

動作マトリックスの全体、影響評価テンプレート、変更ごとの影響マッピング、破壊的な変更に関する警告は、references/state-machine-and-changes.md に記載されています。

---

ルール／制約事項

制約事項	理由
必ず最初にフェーズ 0 の組織選択を実行します。接続済みの組織を一覧表示し、ユーザーが選択するか、新しい組織にログインできるようにします	ユーザーが対象の組織を明示的に選択する必要があります。デフォルトの組織を黙って再利用してはいけません
.lsc-starter-config/LSStarterConfig は一度だけ（フェーズ 1、必須のハードゲート）ダウンロードし、フェーズ 8 で一度だけ削除します。子スキルはダウンロードも削除もしません	どちらの子スキルも共有フォルダーを読み取ります。共有フォルダーなしで続行すると、後続で必ず失敗します
ステージ 1→5 の順序を厳守し、各ステージは前のステージの成功を条件に実行します	各ステージは前のステージの出力に依存します。これにより、連鎖的な失敗を防ぎます
ステージ 2 または 3 を省略してはいけません。また、ステージ 5 より前にステージ 4 を実行してはいけません	ユーザーのプロビジョニングにはプロファイルとテリトリーが必要です。訪問の作成では、ステージ 4 の担当者としてログインします
各子スキルのワークフローに厳密に従い、出力（ID、名前）を後続のステージで使えるように記録します	子スキルには独自の確認手順があります。重複した再照会を避けられます
明示的な確認なしに running／passed のステージを再実行してはいけません。ユーザーの入力時ではなく、実行開始時にステータスを running に変更します	「Proceed」のメッセージが重複しても、競合のない冪等性を保てます
フロー途中の変更を適用する前に、影響評価を行います	変更を確定する前に、何に影響し、何をやり直すことになるかをユーザーが確認できる必要があります

注意事項

問題	解決方法
フェーズ 1 でソースのダウンロードに失敗する（ネットワーク／Git／ディスク）	即時停止します。いずれのステージも実行しないでください。失敗を報告し（フェーズ 1 のダウンロードゲートを参照）、原因を修正するか、.lsc-starter-config/LSStarterConfig を手動で CWD にダウンロードしてから再実行します
接続済みの組織が見つからない	sf org list が何も返さない場合は、フェーズ 0 で新しい組織へのログイン（sf org login web）に進みます
新しい組織／営業担当者のログインにブラウザーが必要	自分で sf org login web を実行します（フェーズ 0 の組織認証、ステージ 5 の営業担当者ログイン）。ユーザーに任せないでください。ユーザーのマシンでブラウザーが開き、ユーザーがそこで Web ログインを完了すると、コマンドが戻ります
前回の実行で作成した成果物（プロファイル、テリトリー、ユーザー、設定）が存在する	子スキルは冪等で、アップサートに安全であり、既存のレコードを検出します。組織にクエリを実行して確認してから、スキップするか安全に再実行します
訪問の作成では 2 つの ID（営業担当者＋管理者）を使用する	製品マスターデータとメタデータキャッシュは管理者が所有します。子スキルの営業担当者／管理者の役割分担に従ってください
ステージが再実行された場合、またはユーザーがフローの途中で以前の入力を変更した場合	遷移マトリックスと影響評価については、references/state-machine-and-changes.md を参照してください

---

再開／一部再実行

ユーザーがすでに一部のステージを完了している可能性がある場合（例：前のセッションで実行済みの場合）は、どのステージを完了したかを尋ねてから、完了したと申告された各ステージについて、組織にクエリを実行して確認します（ステージ 1 = 質問する、2 = LSC Custom Profile、3 = アクティブモデル＋L3 テリトリー、4 = 正しいプロファイル／権限セットを持つユーザー、5 = Visit レコード）。確認できたステージはスキップし、最初の未完了ステージから再開します。ステージごとの正確な検出クエリは、references/orchestration-flow.md → 再開ロジックに記載されています。

---

出力要件

成果物：

• .lsc-starter-config/LSStarterConfig フォルダーを 1 回ダウンロード（フェーズ 1）し、1 回削除します（フェーズ 8）。どちらもサイレントに実行し、最終サマリーでは報告しません
• 5 つのステージをすべて正常に実行する（またはユーザーがスキップを承認する）
• 作成／設定した内容の完全なサマリー
• Life Sciences Cloud のフィールドセールスワークフローを実行できる状態の組織

---

参照ファイル一覧

ファイル	読むタイミング
references/orchestration-flow.md	開始時。依存関係図、ステージごとのゲート検証クエリ、再開検出クエリ、所要時間の目安が記載されています
references/state-machine-and-changes.md	ステージが再実行された場合、またはユーザーがフローの途中で以前の入力を変更した場合。遷移動作の完全なマトリックス、影響評価のテンプレートと対応表、破壊的変更に関する警告が記載されています
references/stage-2-starter-config-overview.md	ステージ 2（フェーズ 3）中。スターター設定のデプロイワークフロー全 13 ステップが記載されており、必要に応じて関連する参照ファイルを案内します
references/stage-4-user-provisioning-overview.md	ステージ 4（フェーズ 5）中。フィールドセールス担当者のユーザープロビジョニングワークフロー全体が記載されており、必要に応じて関連する参照ファイルを案内します
references/stage-5-visit-creation-overview.md	ステージ 5（フェーズ 6）中。サンプル訪問の作成ワークフロー全体が記載されており、必要に応じて関連する参照ファイルを案内します