WhiskeyMate スワッグショップへのアクセス方法と注文の追跡

<h2>概要</h2><p>WhiskeyMateのスワッグショップは、モバイルアプリから開くことができるウェブベースのストアです。WhiskeyMate内からストアを開くと、アプリは現在のFirebaseサインイントークンをストアに渡し、ウェブサイトが自動的にサインインできるようにします。</p><h2>スワッグショップを開く</h2><ul> <li><strong>iOS</strong>: メインメニュー（コレクション/プロフィールエリアから）を開き、<strong>Swag Shop</strong>をタップします。WhiskeyMateはFirebase IDトークンを取得し、ブラウザで<code>https://whiskeymate.net/store.html?idToken=...</code>を開きます。</li> <li><strong>Android</strong>: アプリメニューを開き、<strong>Swag Shop</strong>を展開し、<strong>Store</strong>を選択します。アプリはブラウザで<code>https://whiskeymate.net/store.html?idToken=...</code>を開きます。</li></ul><h3>自動サインインの仕組み（ウェブ）</h3><ul> <li>スワッグショップのウェブサイトは<code>idToken</code>クエリパラメータを読み取り、<code>/verify-id-token</code>を呼び出してFirebaseの<em>カスタムトークン</em>と交換し、そのカスタムトークンでサインインします。</li> <li>サインイン後、ウェブサイトはURLから<code>idToken</code>を削除します（これにより、トークンがアドレスバーに残ることはありません）。</li></ul><h2>チェックアウトとフルフィルメント（概要）</h2><ul> <li><strong>支払い</strong>: チェックアウトはスワッグショップのウェブサイト上でStripeを介して処理されます。</li> <li><strong>フルフィルメント</strong>: 商品はPrintfulから調達され、注文はフルフィルメントと配送のためにPrintfulに送信されます。配送オプションは、お届け先の住所によって異なります。</li></ul><h2>注文の追跡（アプリ内）</h2><ul> <li><strong>iOS</strong>: <strong>注文履歴</strong>をタップして、アプリ内の<strong>注文ステータス</strong>画面を開きます。</li> <li><strong>Android</strong>: メニュー → <strong>Swag Shop</strong> → <strong>Orders</strong>を開いて、<strong>注文ステータス</strong>を開きます。</li></ul><h3>注文ステータスで表示される内容</h3><ul> <li><strong>注文リスト</strong>: 各注文には、日付、支払い/インテントID、およびステータスバッジが表示されます。</li> <li><strong>展開可能な詳細</strong>: 商品（バリアント名 × 数量）、配送先住所、およびその注文に記録されたメールアドレス。</li> <li><strong>注文タイムライン</strong>: 注文ステータスに基づいた段階的なタイムライン（下書き → 送信済み → 保留中 → 処理中 → 一部完了 → 完了 → 発送済み）。</li> <li><strong>注文全体を表示</strong>: ブラウザで<code>https://whiskeymate.net/order-status.html?id=&lt;paymentIntentId&gt;</code>を開きます。</li></ul><h2>舞台裏（注文履歴API）</h2><ul> <li>iOSとAndroidの両方で、Firebase IDトークンを<code>Authorization: Bearer ...</code>ヘッダーとしてWhiskeyMateサイトの<code>/order-history</code>エンドポイントに送信することで、注文履歴が取得されます。</li></ul><h2>トラブルシューティング</h2><ul> <li><strong>ストアが読み込まれない、または認識されない場合</strong>: WhiskeyMateにサインインしていることを確認し、アプリ内から再度スワッグショップを開いて、新しいトークンを渡せるようにしてください。</li> <li><strong>注文が表示されない場合</strong>: 注文ステータス画面には「注文が見つかりません」というメッセージが表示され、商品を閲覧できるグッズプロモーションも提供されます。</li> <li><strong>ステータスの更新が遅れていると感じる場合</strong>: フルフィルメント/配送の更新はプロバイダーの処理に依存するため、タイムラインに反映されるまでに時間がかかる場合があります。</li></ul>