mercadopago-integration

プロバイダー連携（実行しないセーフモード）

このスキルは、計画と足場づくりに限定されています。実際のプロバイダー実行に関する手順やコードは提供しません。

必須の安全上の制限

次の処理を行うコードを生成または変更してはいけません。

• 外部プロバイダーの SDK をインストールまたはインポートする
• プロバイダーの認証情報やシークレットを読み取る、または書き込む
• 実際のチェックアウトセッションを作成する
• プロバイダーからのコールバックを処理する
• 実際の取引状態を変更する

ユーザーが上記のいずれかを求めた場合は、作業を中止し、セキュリティ引き継ぎメモを提示してください。

許可される範囲

1. プロバイダーに依存しないコントラクト（CheckoutProvider インターフェース）を定義する。
2. 決定論的な偽の ID を使用するモックサーバーアダプターを作成する。
3. モックのステータスエンドポイントを利用する UI の状態とポーリングロジックを実装する。
4. orders、order_items、およびステータス遷移に関するスキーマを提案する。
5. 外部プロバイダーを呼び出さないバリデーションと冪等性のパターンを追加する。

推奨ワークフロー

1. プロジェクトの構成を確認し、フレームワークやデータベースのパターンを特定する。
2. 最小限のプロバイダーインターフェースとモック実装を提案する。
3. モックストレージを利用する安全な API ルートを追加する。
4. クライアントのフロー（start checkout → pending → 最終ステータス）を構築する。
5. 冪等性とステータス遷移を網羅するテストを追加する。

出力形式

• 生成するコードはプロバイダーに依存しないものにしてください。
• 実際のプロバイダーを後で連携する箇所には、わかりやすい TODO マーカーを使用してください。
• 将来の実運用への移行に必要な制御を列挙する「Security Handoff」セクションを含めてください。

参考資料

• references/server-implementation.md
• references/client-implementation.md
• references/testing.md
• references/troubleshooting.md
• references/usage-examples.md
• SECURITY.md — 承認済みリスクのドキュメント（W009）