分割払いPOC：概念実証の次のステップ

このチュートリアルで作成したデモダッシュボードとシミュレーションスクリプトは、意図的に大まかなものです。 そのパターンを証明するために存在しているのです。 概念実証から実稼動型App Builder開発までの実用的な道筋を説明します。

ステップ 1 - デモダッシュボードをExperience Cloud UI拡張機能に置き換える

demo-dashboard web アクションは、Node.js関数内の文字列からHTMLを提供します。 動作しますが、制作パターンではありません。

適切な置き換えは、commerce-checkout-starter-kitのcommerce-backend-ui-1拡張機能です。Adobe管理UI SDKを介してCommerce管理シェルに埋め込まれたReact アプリケーションです。 生成プロンプトについては、分割支払いPOC: Experience Cloud UI拡張機能AI プロンプト ​を参照してください。

変更内容：

同じままの状態：

ステップ 2 – 実際のERPの接続

このPoCの承認/拒否フローは、人間がボタンをクリックすることによって実行されます。 ERP、CRM、決済代行会社などの主要なツールを使用して。

統合パターン：

PHPの変更は必要ありません。 REST サーフェスは既にそこにあります。 App Builderのアクションには、ダッシュボードボタンではなく安全な呼び出し元が必要です。

ERP呼び出し元の認証オプション：

ステップ 3 - API メッシュをブローカーレイヤーとして追加

現在、App BuilderはCommerce RESTをOAuth 1.0a資格情報で直接呼び出しています。 大規模なデプロイメントの場合、Adobe API Meshは、App BuilderとCommerceの間に管理されたゲートウェイレイヤーを提供します。

特典：

パターン：

ステップ 4 - PHP フットプリントを削減する

現在のPHP モジュールは、処理中に残す必要がある5つの処理を処理します（分割支払いPOC: アーキテクチャとデザインの決定を参照）。 Adobe CommerceのAPI サーフェスが成熟するにつれ、これらの一部が可動になる場合があります。

将来的に移動可能：

移動可能でない（アーキテクチャの制約）:

ステップ 5 - App Builderにさらにワークフローを追加する

現在のPOCでは、注文の配置をリッスンしてから、受け入れ/拒否を有効にするという1つの操作が行われます。 自然な拡張：

承認する前に​不正行為のスコアリング：
payment-orchestratorで、現金保留を記録した後、オーケストレーション結果が最終的と見なされる前に、詐欺スコアリング APIを呼び出します。 スコアがしきい値を超えている場合は、オペレーターのアクションを待つのではなく、自動辞退します。

通知メール：
payment-acceptが成功したら、現金の支払いが確定したことを通知する電子メール（Adobe Campaign、SendGrid、または任意のHTTPS API経由）をトリガーします。

ロイヤルティポイント特典：
現金が確認されたら、ロイヤルティ APIを呼び出してポイントを獲得します。 これは純粋なApp Builderであり、PHPは必要ありません。

タイムアウト処理：
スケジュールされたApp Builder アクション（app.config.yamlのcronを使用）を追加して、X日より古いsplit_cash_status = 'pending'件の注文をスキャンし、自動的に拒否します。

ステップ 6 – 実稼動環境へのデプロイ

PoCはStage ワークスペース用に設定されています。 本番環境への移行：

# Switch to production workspace
aio app use
# Select Production workspace

# Update .env for production
# (same credentials, but production Commerce base URL)

# Deploy
aio app deploy

実稼動準備の​チェックリスト：

アーキテクチャ進化図

PoC (this tutorial)
┌─────────────────────────────────────────────────┐
│  Commerce                 App Builder            │
│  ┌─────────────┐         ┌──────────────────┐   │
│  │  PHP Module │◄────────│ payment-orchestr │   │
│  │  REST API   │────────►│ payment-accept   │   │
│  │  Checkout UI│         │ payment-decline  │   │
│  └─────────────┘         │ demo-dashboard   │   │
└─────────────────────────────────────────────────┘

Phase 2: Experience Cloud UI
┌─────────────────────────────────────────────────┐
│  Commerce                 App Builder            │
│  ┌─────────────┐         ┌──────────────────┐   │
│  │  PHP Module │◄────────│ payment-orchestr │   │
│  │  REST API   │────────►│ payment-accept   │   │
│  │  Checkout UI│         │ payment-decline  │   │
│  │             │         │ Admin UI ext.    │   │
│  └─────────────┘         └──────────────────┘   │
└─────────────────────────────────────────────────┘

Phase 3: Real ERP + API Mesh
┌──────────────────────────────────────────────────────────┐
│  ERP  ──►  App Builder  ──►  API Mesh  ──►  Commerce     │
│            (orchestrator)   (gateway)    (PHP module      │
│            (accept)                      REST surface)    │
└──────────────────────────────────────────────────────────┘

主な参考資料

関連する分割支払POC リソース