◀ デモHub
PROTOTYPE

METRO MARATHON 2027 · Pickup System

記念商品 受取システム 構成図

購入から受取までの流れ

🧍

購入者

海外ランナー

→
1🛒

商品を購入

記念シューズ・アパレル

→
2📅

受取枠(Slot)を選択

満席の枠は選択不可

→
3📱

受取QRを受け取る

マイアカウント/メール

→
4🎫

会場でQR受付

事前QRをセルフ端末が読取→即判定

→
5📣

呼び出し → 受取

番号+カウンター表示

✓

各システムの役割(3者が連携)

Shopify

購入者が操作する画面(買う)

画面=Shopifyテーマ(Liquid+JSで我々のAPIを呼ぶ)

  • ストアフロント(テーマ)
  • 商品カタログ
  • カート・決済・注文
  • マイアカウント
  • 注文確認メール
  • 多言語(英/簡/繁)
⇄API・Webhook 連携

受取管理サーバー

受取の頭脳(Shopifyに無い機能)

画面を持たない(API・データ・配信)

  • 受取枠の在庫・上限管理
  • QRコードの発行
  • チェックイン管理
  • 受取時間の判定
  • 受付番号の採番・カウンター割当
  • リアルタイム配信
⇄会場端末を制御

会場設備

サーバーとつながる会場端末

画面=新規開発(Shopify外の独自View)

  • KIOSK端末(QR読取)
  • スタッフ端末
  • 大型ディスプレイ

受取管理サーバーの中身(技術スタック)

規模感(前回3,100名 → 今回は目標+56%で概算4,800名前後・3日間・初日AM集中)はSupabase + Vercel で十分。AWS前提なら Vercel→ECS/Lambda、 Supabase→RDS+AppSync 等に読み替え可能です。

API層・ホスティング(Vercel / Next.js)

処理を動かす場所

  • 受取API:枠・注文・チェックイン・呼び出し(JSONを返す)
  • Shopify連携:Webhook受信(orders/create)+ Admin API
  • 会場3画面(KIOSK/スタッフ/ディスプレイ)=唯一の画面描画
  • QRトークンの生成

データ・リアルタイム・認証(Supabase)

状態の唯一の正(Single Source of Truth)

  • Postgres:注文・受取枠・チェックイン・カウンター
  • 枠の上限制御(原子的更新で超過を防止)
  • Realtime:ディスプレイへ即時配信
  • Auth:スタッフ端末のログイン

外部連携

つながる先

  • Shopify(決済・注文・顧客)
  • メール配信(QRを同梱)
  • 会場端末(同一サーバーへ接続)

Shopify側の作り方:商品一覧・詳細・カートは既存のShopify画面のまま。 受取枠セレクタやQR表示は テーマ(Liquid+JS)から我々のAPIを呼んで描画 します (画面はShopifyが描画/我々はデータを返すAPI)。 本格的な管理画面アプリの開発は不要で、必要なのは注文取得のための薄いカスタムアプリ(Webhook+Admin API) のみ。 独自に画面そのものを作るのは会場端末だけです。

いつ・どのAPIが動くか(シチュエーション別)

APIはすべて受取管理サーバー。下記は本デモで実際に動いているエンドポイントと同一です。

#シチュエーション画面(どこで)API(サーバー処理)内容
1受取枠を表示Shopify(枠選択)GET /api/slots各枠の残数を返す → 満席はグレーアウト
2注文を確定Shopify→サーバー(自動)Webhook orders/create注文を保存+選択枠を +1(原子的に確定)+ QR発行
3QRを表示Shopify(Thank you/メール/マイページ)GET /api/orders/:id発行済みQRを表示
4受取枠を変更Shopify(マイページ)POST /api/orders/:id/reschedule旧枠 -1・新枠 +1(空きが無ければ拒否)
5会場で受付会場KIOSKPOST /api/checkin現在時刻×受取枠を判定 → 枠内は受付番号採番/枠外は案内
6準備完了会場スタッフ端末POST /api/orders/:id/readyカウンター確定 → 呼び出し中へ
7呼び出し表示大型ディスプレイSupabase Realtime受付番号+カウンターを即時描画
8受渡完了会場スタッフ端末POST /api/orders/:id/complete完了 → ディスプレイから消える

初日AMの同時アクセス対策:受取枠の確定は Postgres の原子的更新(枠が空いている時だけ +1)で行うため、 同時に殺到しても超過予約は発生しません。前回の需要集中を仕組みで捌きます。

打ち合わせで確認したい点(要件定義ですり合わせ)

現時点で決め切らず、双方で握って進めたい項目です。

受取枠の押さえ方(A案/B案)

既定は A案:カートで枠を選び、注文成立時に確定(Shopifyで一般的)。 同時アクセスでも サーバーの原子的更新で超過予約を防止 します (本デモに実装済み:満席は自動グレーアウト+確定拒否)。B案:チェックアウト内で選択 は要件次第の拡張で 費用差は限定的。 まずAで進め、必要になれば拡張します。

枠(Slot)設計

  • ☐枠の粒度(30分/15分 など)※現状デモは30分刻みの仮置き
  • ☐1枠あたりの上限人数(来場者数×カウンター処理能力から逆算)
  • ☐受取の営業時間・日別の配分(初日AMピークの厚み)
  • ☐予約変更の締切・回数、キャンセル可否(前回はキャンセル不可)

受付・チェックイン

  • ☐★受付方式【提案】事前QRを会場セルフ端末(iPad等・無人・複数台)が読取り即判定。紙・ピッキング不要。
  • ☐枠外来場(早すぎ/遅刻)の扱い:案内のみ/空きあれば通す/当日枠へ振替
  • ☐受付の猶予時間(開始何分前〜何分後まで受付可)
  • ☐QRの二重利用・スクショ転用対策、本人確認・代理受取の要否

受け渡し・当日

  • ☐カウンター割当ルール(商品種別で分ける/自動割当 など)
  • ☐未受取(no-show)の扱い(後日発送/返金なし 等。前回は入金済)
  • ☐会場でのサイズ交換・返品対応(前回はサイズ起因4.9%)
  • ☐呼び出し後に来ない人の扱い(再呼び出し/スキップ)

会場設備

  • ☐KIOSK端末(iPad等)の台数・調達担当
  • ☐大型ディスプレイ・会場設営の調達担当
  • ☐受取カウンター数(前回10)・当日の同時ピーク規模

体制・分担

  • ☐Shopifyテーマ(デザイン構築)の担当分担(当社はサーバー+連携が主)
  • ☐受取時間変更は顧客セルフ(RFP方針)で確定か
  • ☐当日運営は範囲外(緊急連絡体制は保持)で合意
  • ☐保守範囲・定例会議・連絡体制(RFP要求項目)

多言語・連携・オプション

  • ☐多言語(英/簡/繁)の適用範囲(UI/メール/会場画面)
  • ☐決済(海外カード・返金)・個人情報(越境データ・Privacy)
  • ☐会員SSO:スコープ/オプション/別フェーズ
  • ☐ロジ運用ベンダー(新/旧未定)連携・CS(Zendesk等)の範囲・前回の枠選択実装
Shopify(購入者の画面) 受取管理サーバー 会場設備(新規開発View)